历史版本4 :WebService程序数据集 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
WebService程序数据集之jws方式编辑
1. 示例
1.1 WebService应用服务
如在Tomcat下的Axis工程中以jws方式发布了一个WebService应用服务TestWS2TDClient.jws,返回一个数组数据。如下:
HTML/XML代码
public class TestWS2TDClient { public String[][] getTD() { String[][] a = {{"城市", "销售员", "销售额"},{"江苏", "Anna", "230"},{"江苏", "Alex", "190"},{"江苏","Jack","320"},{"江苏","Apple","210"},{"浙江","Faye","150"},{"浙江","Sammi","280"}}; return a; } }
以jws方式发布WebService:将写好的TestWS2TDClient.java文件重命名为TestWS2TDClient.jws,放在Tomcat\webapps\axis2即可。
1.2 在java类中访问WebService数据源
java中发送一个soap请求,访问TestWS2TDClient.jws这个WebService,得到返回的数据,代码如下:
HTML/XML代码
try { String endpoint = "http://localhost:8080/axis/TestWS2TDClient.jws"; Service service = new Service(); //创建一个服务(service)调用(call) Call call = (Call) service.createCall(); // 通过service创建call对象 call.setTargetEndpointAddress(new java.net.URL(endpoint)); // 设置service所在URL call.setOperationName(new QName("http://localhost:8080/axis/TestWS2TDClient.jws","getTD")); // 调用service中的getTD方法 String[][] ret = (String[][])call.invoke(new Object[] {}); // getTD方法没有参数,因此传一个空的对象,得到service中getTD返回的数据 return ret; } catch (Exception e) { e.printStackTrace(); }
注:soap即简单对象访问协议,客户端发送一个请求,调用相应的对象, 然后服务器返回结果。这些消息是XML 格式的,并且封装成符合HTTP 协议的消息。
需要引入axis.jar、commons-discovery-0.2.jar、commons-logging-1.0.4.jar、wsdl4j-1.5.1.jar、log4j-1.2.8.jar、jaxrpc.jar六个包,可以在axis\WEB-INF\lib下找到。
1.3 将获得数据转为程序数据集
访问WebService后,该服务会返回数据给客户端,该例中返回一个字符串数组。定义WebServiceTableData.java类,扩展AbstractTableData,将获得的数组数据转为程序数据集。完整代码如下:
HTML/XML代码
package com.fr.data; import javax.xml.namespace.QName; import org.apache.axis.client.Call; import org.apache.axis.client.Service; import com.fr.data.AbstractTableData; import com.fr.data.TableDataException; public class WebServiceTableData extends AbstractTableData{ private String[][] data; public WebServiceTableData() { this.data = this.getData(); } //获取列数 public int getColumnCount() throws TableDataException { return data[0].length; } //获取列的名称为数组中第一行的值 public String getColumnName(int columnIndex) throws TableDataException { return data[0][columnIndex]; } //获取行数为数据的长度-1 public int getRowCount() throws TableDataException { return data.length - 1; } //获取值 public Object getValueAt(int rowIndex, int columnIndex) { return data[rowIndex + 1][columnIndex]; } public String[][] getData() { try { String endpoint = "http://localhost:8080/axis/TestWS2TDClient.jws"; Service service = new Service(); Call call = (Call) service.createCall(); call.setTargetEndpointAddress(new java.net.URL(endpoint)); call.setOperationName(new QName("http://localhost:8080/axis/TestWS2TDClient.jws", "getTD")); String[][] ret = (String[][])call.invoke(new Object[] {}); return ret; } catch (Exception e) { e.printStackTrace(); } return new String[][] {}; } }
注:最新的代码链接fine-help。
将编译好的class文件拷贝到%FR_HOME%/WebReport/WEB-INF/classes/com/fr/data文件夹下。
1.4 设计器中调用程序数据集
新建报表,定义数据集,选择程序数据集,选择定义好的程序数据集WebServiceTableData.class,自定义数据集的名称为ds1,启动tomcat服务器,点击预览,效果如下:
WebService程序数据集之WSDL取数 编辑
1. 问题描述
使用通用的webservice集合,在集合中使用wsdl取数的方式获取数据,并将数据转换为程序数据集,那么怎样通过wsdl取数并转换为程序数据集呢?
2. 解决思路
首先将wsdl获取到的数据转换为二维数组,然后通过FineReport的程序数据集接口,将数据导入到接口中,wsdl取数的方式有三种,RPC方式调用、document方式调用以及通过axis2 的wsdl2java.bat生成客户端调用,前两种方式不生成客户端代码,比较繁琐,最后一种方式生成客户端代码,但是比较简洁,下面介绍第二种和第三种方式。
使用通用的webservice集合作为数据来源,访问通用webservice集合可任意选择一个web服务,这里使用 ,wsdl地址为:http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl 。
在浏览器中输入上述wsdl文件的地址,可得知,该wsdl中定义了两个取数函数,getDatabaseInfo 和getMobileCodeInfo ,前者无参数传入,后者需要传入mobileCode参数。
注:在eclipse中编写wsdl取数代码时,首先需要导入如下的jar包:
另:axis2的jar包必须保持版本一致,下载地址为:WSDL—axis2
3. document方式调用
以上述wsdl为例,使用getDatabaseInfo函数,不传入参数,document方式调用函数代码如下:
3.1 wsdl数据获取
HTML/XML代码
try { // 指定调用WebService的URL String url = "http://www.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl"; EndpointReference targetEPR = new EndpointReference(url); // 创建一个OMFactory,下面的namespace、方法与参数均需由它创建 OMFactory fac = OMAbstractFactory.getOMFactory(); // 命名空间 OMNamespace omNs = fac.createOMNamespace("http://WebXml.com.cn","a"); // 下面创建的是参数对数 /* * OMElement symbol = fac.createOMElement("mobileCode", omNs); * symbol.addChild(fac.createOMText(symbol, "18795842")); */ // 下面创建一个method对象 ,方法 OMElement method = fac.createOMElement("getDatabaseInfo", omNs); // method.addChild(symbol); Options options = new Options(); options.setTo(targetEPR); options.setAction("http://WebXml.com.cn/getDatabaseInfo"); ServiceClient sender = new ServiceClient(); sender.setOptions(options); OMElement result1 = sender.sendReceive(method); } catch (AxisFault axisFault) { axisFault.printStackTrace(); }
注:如果使用getMobileCodeInfo函数,传入参数, 那么需要创建参数对,在上述代码中被注释的部分。
3.2 OMElement对象转换
由于document方式函数调用取数方式获取到的数据为OMElement对象,所以需要将OMElement转换为二维数组,转换函数代码如下:
HTML/XML代码
public static String[][] getResults(OMElement element) { if (element == null) { return null; } Iterator iterator = element.getChildElements(); Iterator innerItr; List<String> list = new ArrayList<String>(); OMElement result = null; while (iterator.hasNext()) { result = (OMElement) iterator.next(); innerItr = result.getChildElements(); while (innerItr.hasNext()) { OMElement elem = (OMElement)innerItr.next(); list.add(elem.getText()); } } String[] result1 = list.toArray(new String[list.size()]); String results[][] = new String[result1.length][3]; String b1, b2, b3; for (int i = 0; i < result1.length; i++) { if (result1[i].length() != 0) { b1 = result1[i].substring(0, result1[i].indexOf(" ")); b2 = result1[i].substring(result1[i].indexOf(" ") + 1).substring(0,result1[i].substring(result1[i].indexOf(" ") + 1).indexOf(" ")); b3 = result1[i].substring(result1[i].indexOf(" ") + 1).substring(result1[i].substring(result1[i].indexOf(" ") + 1).indexOf(" ") + 1); results[i][0] = b1; results[i][1] = b2; results[i][2] = b3; } } return results; }
3.3 获取数据转换为程序数据集
定义WebServiceTableWsdlDataDemo.java类,扩展AbstractTableData,将获得的数组数据转为程序数据集。完整代码如下:
HTML/XML代码
package com.fr.data; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import org.apache.axiom.om.OMAbstractFactory; import org.apache.axiom.om.OMElement; import org.apache.axiom.om.OMFactory; import org.apache.axiom.om.OMNamespace; import org.apache.axis2.addressing.EndpointReference; import org.apache.axis2.client.Options; import org.apache.axis2.client.ServiceClient; import com.fr.general.data.TableDataException; public class MobileWsdlTableDataDemo extends AbstractTableData{ private String[][] data; public MobileWsdlTableDataDemo() { this.data = this.getData(); } public int getColumnCount() throws TableDataException { return data[0].length; } //获取列的名称为数组中第一行的值 public String getColumnName(int columnIndex) throws TableDataException { return data[0][columnIndex]; } //获取行数为数据的长度-1 public int getRowCount() throws TableDataException { return data.length - 1; } //获取值 public Object getValueAt(int rowIndex, int columnIndex) { return data[rowIndex + 1][columnIndex]; } public static String[][] getResults(OMElement element) { if (element == null) { return null; } Iterator iterator = element.getChildElements(); Iterator innerItr; List<String> list = new ArrayList<String>(); OMElement result = null; while (iterator.hasNext()) { result = (OMElement) iterator.next(); innerItr = result.getChildElements(); while (innerItr.hasNext()) { OMElement elem = (OMElement)innerItr.next(); list.add(elem.getText()); } } String[] result1 = list.toArray(new String[list.size()]); String results[][] = new String[result1.length][3]; String b1, b2, b3; for (int i = 0; i < result1.length; i++) { if (result1[i].length() != 0) { b1 = result1[i].substring(0, result1[i].indexOf(" ")); b2 = result1[i].substring(result1[i].indexOf(" ") + 1).substring(0,result1[i].substring(result1[i].indexOf(" ") + 1).indexOf(" ")); b3 = result1[i].substring(result1[i].indexOf(" ") + 1).substring(result1[i].substring(result1[i].indexOf(" ") + 1).indexOf(" ") + 1); results[i][0] = b1; results[i][1] = b2; results[i][2] = b3; } } return results; } public String[][] getData() { try { String url = "http://www.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl"; EndpointReference targetEPR = new EndpointReference(url); //创建一个OMFactory,下面的namespace、方法与参数均需由它创建 OMFactory fac = OMAbstractFactory.getOMFactory(); // 命名空间 OMNamespace omNs = fac.createOMNamespace("http://WebXml.com.cn", "a"); //下面创建的是参数对数 /* *OMElement symbol = fac.createOMElement("mobileCode", omNs); symbol.addChild(fac.createOMText(symbol, "18795842")); */ //下面创建一个method对象 ,方法 OMElement method = fac.createOMElement("getDatabaseInfo", omNs); // method.addChild(symbol); Options options = new Options(); options.setTo(targetEPR); options.setAction("http://WebXml.com.cn/getDatabaseInfo"); ServiceClient sender = new ServiceClient(); sender.setOptions(options); OMElement result1 = sender.sendReceive(method); String[][] result = getResults(result1); return result; } catch (org.apache.axis2.AxisFault e) { e.printStackTrace(); } catch (java.rmi.RemoteException e) { e.printStackTrace(); } return new String[][] { {} }; } }
注:最新的代码链接fine-help。
将编译好的class文件拷贝到%FR_HOME%/WebReport/WEB-INF/classes/com/fr/data文件夹下。
3.4 设计器中调用程序数据集
新建报表,定义数据集,选择程序数据集,选择定义好的程序数据集WebServiceWsdlTableDataDemo.class,点击预览,效果如下:
注:在设计器中调用程序数据集,同样要将上述导入到eclipse中的jar包拷贝到%FR_HOME\WebReport\WEB-INF\lib目录下,否则预览是没有数据的。
4. 通过axis2生成客户端调用
Axis2提供了一个wsdl2java.bat命令可以根据WSDL文件自动产生调用WebService的代码。
4.1 wsdl2java.bat生成代码
进入axis2的bin目录执行如下的命令:
HTML/XML代码
wsdl2java -uri http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl -p mobile -o mobile
如下图:
wsdl文件地址,可以是本地路径,也可以是网络路径;
指定了生成的Java类的包名;
指定了生成的一系列文件保存的根目录。
wsdl2java.bat插件还有很多参数,这里不一一详述了。
命令语句执行完成之后,在参数-o指定的文件目录里面就能看到生成的WebService代码了,这里指定的目录为当前目录下面的mobile文件夹(如果没有改文件夹,会自动新建),如下图:
4.2 通过生成的WebService代码取数
在eclipse中新建一个java 工程,将上一步骤生成的WebService代码即2个java文件所在的包一起拷到该工程的src目录中,如下图:
这样就可以直接使用工程中的MobileCodeWSStub类,从wsdl取数,并转换为二维数组,代码如下:
HTML/XML代码
try { String url = "http://www.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl"; MobileCodeWSStub stub = new MobileCodeWSStub(url); // MobileCodeWSStub.GetMobileCodeInfo aa = new MobileCodeWSStub.GetMobileCodeInfo(); MobileCodeWSStub.GetDatabaseInfo bb = new MobileCodeWSStub.GetDatabaseInfo(); // aa.setMobileCode("18795842832"); // String rs=stub.getMobileCodeInfo(aa).getGetMobileCodeInfoResult(); String[] p=stub.getDatabaseInfo(bb).getGetDatabaseInfoResult().getString(); String result[][] = new String[p.length][3]; String b1,b2,b3; for(int i = 0;i<p.length;i++) { if(p[i].length()!=0) { b1 = p[i].substring(0, p[i].indexOf(" ")); b2 = p[i].substring(p[i].indexOf(" ")+1).substring(0,p[i].substring(p[i].indexOf(" ")+1).indexOf(" ")); b3 = p[i].substring(p[i].indexOf(" ")+1).substring(p[i].substring(p[i].indexOf(" ")+1).indexOf(" ")+1); result[i][0] = b1; result[i][1] = b2; result[i][2] = b3; } } return result; } catch (org.apache.axis2.AxisFault e) { e.printStackTrace(); } catch (java.rmi.RemoteException e) { e.printStackTrace(); } return new String[][] { {} }; }
4.3 获取数据转换为程序数据集
定义WebServiceWsdlTableDataDemo2.java类,扩展AbstractTableData,将获得的数组数据转为程序数据集。完整代码如下:
HTML/XML代码
package com.fr.data; import java.util.logging.Logger; import moblie.MobileCodeWSStub; import org.apache.axis2.AxisFault; import org.apache.axis2.addressing.EndpointReference; import org.apache.axis2.client.Options; import org.apache.axis2.rpc.client.RPCServiceClient; import com.fr.general.data.TableDataException; import com.fr.third.javax.xml.namespace.QName; public class MobileWsdlTableDataDemo2 extends AbstractTableData{ private String[][] data; public MobileWsdlTableDataDemo2() { this.data = this.getData(); } public int getColumnCount() throws TableDataException { return data[0].length; } //获取列的名称为数组中第一行的值 public String getColumnName(int columnIndex) throws TableDataException { return data[0][columnIndex]; } //获取行数为数据的长度-1 public int getRowCount() throws TableDataException { return data.length - 1; } //获取值 public Object getValueAt(int rowIndex, int columnIndex) { return data[rowIndex + 1][columnIndex]; } public String[][] getData() { try { String url = "http://www.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl"; MobileCodeWSStub stub = new MobileCodeWSStub(url); // MobileCodeWSStub.GetMobileCodeInfo aa = new MobileCodeWSStub.GetMobileCodeInfo(); MobileCodeWSStub.GetDatabaseInfo bb = new MobileCodeWSStub.GetDatabaseInfo(); // aa.setMobileCode("18795842832"); // String rs=stub.getMobileCodeInfo(aa).getGetMobileCodeInfoResult(); String[] p=stub.getDatabaseInfo(bb).getGetDatabaseInfoResult().getString(); String result[][] = new String[p.length][3]; String b1,b2,b3; for(int i = 0;i<p.length;i++) { if(p[i].length()!=0) { b1 = p[i].substring(0, p[i].indexOf(" ")); b2 = p[i].substring(p[i].indexOf(" ")+1).substring(0,p[i].substring(p[i].indexOf(" ")+1).indexOf(" ")); b3 = p[i].substring(p[i].indexOf(" ")+1).substring(p[i].substring(p[i].indexOf(" ")+1).indexOf(" ")+1); result[i][0] = b1; result[i][1] = b2; result[i][2] = b3; } } return result; } catch (org.apache.axis2.AxisFault e) { e.printStackTrace(); } catch (java.rmi.RemoteException e) { e.printStackTrace(); } return new String[][] { {} }; } }
注:最新的代码链接fine-help。
将编译好的class文件拷贝到%FR_HOME%/WebReport/WEB-INF/classes/com/fr/data文件夹下。
4.4 设计器中调用程序数据集
新建报表,定义数据集,选择程序数据集,选择定义好的程序数据集WebServiceWsdlTableDataDemo2.class,点击预览,效果如下:
注:在设计器中调用程序数据集,同样要将上述导入到eclipse中的jar包拷贝到%FR_HOME\WebReport\WEB-INF\lib目录下,否则预览是没有数据的。