WebService 接口调用指南
客户端开发步骤(java):
本例展示如何在Eclipse 环境下使用Axis2创建WebService客户端。
一、 环境准备(如果你已具备Axis2开发环境,跳过本步骤)
1、 Axis2 API包
本例使用的Axis2版本是1.4,请到以下地址下载:
http://apache.mirror.phpchina.com/ws/axis2/1_4/axis2-1.4.1-bin.zip
下载后将压缩包解压缩到任意目录。如果你希望直接使用Axis2 API进行开发,可能会需要这个包。
2、 Axis2 Eclipse 插件( 代码生成和打包工具 )
本例使用的插件版本是1.4,请到以下地址下载:
打包工具:
http://apache.mirror.phpchina.com/ws/axis2/tools/1_4/axis2-eclipse-service-archiver-wizard-1.4.zip
代码生成工具:
http://apache.mirror.phpchina.com/ws/axis2/tools/1_4/axis2-eclipse-codegen-wizard-1.4.zip
其实我们只用到代码生成工具。
3、 安装Axis2 Eclipse插件
(1) 将下载到的 Axis2 的两个插件解压缩到 Eclipse 安装目录下的 plug-in 子目录;
(2) 到Axis2 API安装目录的/lib目录下,复制backport-util-concurrent-3.1.jar和geronimo-stax-api_1.0_spec-1.0.1.jar这两个文件至eclipse安装目录的/plugins/Axis2_Codegen_Wizard/lib目录下,同时要编辑eclipse安装目录的/plugins/Axis2_Codegen_Wizard下的plugin.xml, 将这两个文件添加进去(红色的两项):
<library name="lib/jibx-run-1.1.5.jar">
<export name="*"/>
</library>
<library name="lib/backport-util-concurrent-3.1.jar">
<export name="*"/>
</library>
<library name="lib/geronimo-stax-api_1.0_spec-1.0.1.jar">
<export name="*"/>
</library>
</runtime>
然后启动 Eclipse ,并选择“ File->New->Other ”可以找到下面两个 Wizards:
Axis2 Code Generator和Axis2 Service Archiver,表明插件安装成功。
二、开发客户端
打开Eclipse,新建java项目,JDK最好选择JDK1.5。
1、 选择“Build Classpath à Add Libraries …”,把Axis2 API安装目录 /lib 目录下所有 jar 包添加进来。
2、新建一个package,例如com.yourcompany.client。
3、使用“File à New à Other ”,在选择向导窗口中选择Axis2 Wizard下的Axis2 Code Generator插件。 Next。
4、 选择“Generate java source code from a WSDL file”,Next。
5、在WSDL file location中填入WSDL访问地址,例如:http://192.168.0.1/axis2/services/xxx?wsdl。Next。
6、Codegen option选择 default。Next。
7、选择输出路径,点中“Browse and select a project on current eclipse workspace”,然后点击“Browse…”按钮,选择当前项目。Finish,Codegen插件生成客户端代理代码完毕
8、新建测试类,调用WebService 接口方法。实例代码:
public class OrderServiceClient {
public static void main(String[] args)throws AxisFault{
OrderServiceStub stub = new OrderServiceStub();
//测试按手机号查找订购信息
OrderServiceStub.GetOrderInfoDFByPhone request = new OrderServiceStub.GetOrderInfoDFByPhone();
request.setPhone("15969000000");
OrderInfoDF[] result=null;
try{
result=stub.getOrderInfoDFByPhone(request).get_return();
}catch(Exception e){
e.printStackTrace();
}
if(result!=null){
for(int i=0;i<result.length;i++){
OrderInfoDF o=result[i];
System.out.println("###################");
System.out.println("区号:"+o.getAreaid());
System.out.println("户号:"+o.getCustomerid());
System.out.println("订购状态:"+o.getLastsendflag());
System.out.println("最后发送时间:"+o.getLastsendtime());
System.out.println("订购指令:"+o.getOrderaction());
System.out.println("订购时间:"+o.getOrdertime());
System.out.println("手机号:"+o.getPhone());
System.out.println("姓名:"+o.getUsername());
}
}
}
运行结果如下:
###################
区号:0871
户号:30200363
订购状态:0
最后发送时间:2008-12-29 15:39:38
订购指令:DF#30200363#0871
订购时间:2008-07-30 15:07:46
手机号:15969000000
姓名:null
###################