Axis2 POJO实现WebService(二)客户端调用

WebService是为程序服务的，只在浏览器中访问WebService是没有意义的。因此，在本节使用Java实现了一个控制台程序来调用上一节发布的WebService。

新建一个工程（java project或者Dynamic Web project）,如图：

客户端代码如下：（将 axis2-1.6.2\lib下的所有jar放到工程的lib目录下）

 1 package com.jyu.webservice;
 2 
 3 import javax.xml.namespace.QName;
 4 import org.apache.axis2.addressing.EndpointReference;
 5 import org.apache.axis2.client.Options;
 6 import org.apache.axis2.rpc.client.RPCServiceClient;
 7 
 8 public class RPCClient
 9 {
10     public static void main(String[] args) throws Exception  
11     {
12         //  使用RPC方式调用WebService        
13         RPCServiceClient serviceClient = new RPCServiceClient();
14         Options options = serviceClient.getOptions();
15         //  指定调用WebService的URL
16         EndpointReference targetEPR = new EndpointReference(
17                 "http://localhost:8080/axis2/services/SimpleService");
18         options.setTo(targetEPR);
19         //  指定getGreeting方法的参数值
20         Object[] opAddEntryArgs = new Object[] {"Damon.Huang"};
21         //  指定getGreeting方法返回值的数据类型的Class对象
22         @SuppressWarnings("rawtypes")
23         Class[] classes = new Class[] {String.class};
24         //  指定要调用的getGreeting方法及WSDL文件的命名空间
25         QName opAddEntry = new QName("http://ws.apache.org/axis2", "getGreeting");
26         //  调用getGreeting方法并输出该方法的返回值
27         System.out.println(serviceClient.invokeBlocking(opAddEntry, opAddEntryArgs, classes)[0]);
28         
29         //  下面是调用getPrice方法的代码，这些代码与调用getGreeting方法的代码类似
30         classes = new Class[] {int.class};
31         opAddEntry = new QName("http://ws.apache.org/axis2", "getPrice");
32         System.out.println(serviceClient.invokeBlocking(opAddEntry, new Object[]{}, classes)[0]);
33     } 
34 }

运行后台输出如图：

在编写客户端代码时应注意如下几点：

1. 客户端代码需要引用很多Axis2的jar包，如果读者不太清楚要引用哪个jar包，可以在Eclipse的工程中引用Axis2发行包的lib目录中的所有jar包。

2. 在本例中使用了RPCServiceClient类的invokeBlocking方法调用了WebService中的方法。invokeBlocking方法有三个参数，其中第一个参数的类型是QName对象，表示要调用的方法名；第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；第三个参数表示WebService方法的返回值类型的Class对象，参数类型为Class[]。当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}。

3. 如果被调用的WebService方法没有返回值，应使用RPCServiceClient类的invokeRobust方法，该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同。

4. 在创建QName对象时，QName类的构造方法的第一个参数表示WSDL文件的命名空间名，也就是<wsdl:definitions>元素的targetNamespace属性值，下面是SimpleService类生成的WSDL文件的代码片段

  1 This XML file does not appear to have any style information associated with it. The document tree is shown below.
  2 <wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns1="http://org.apache.axis2/xsd" xmlns:ns="http://ws.apache.org/axis2" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" targetNamespace="http://ws.apache.org/axis2">
  3 <wsdl:types>
  4 <xs:schema attributeFormDefault="qualified" elementFormDefault="unqualified" targetNamespace="http://ws.apache.org/axis2">
  5 <xs:element name="getPrice">
  6 <xs:complexType>
  7 <xs:sequence/>
  8 </xs:complexType>
  9 </xs:element>
 10 <xs:element name="getPriceResponse">
 11 <xs:complexType>
 12 <xs:sequence>
 13 <xs:element minOccurs="0" name="return" type="xs:int"/>
 14 </xs:sequence>
 15 </xs:complexType>
 16 </xs:element>
 17 <xs:element name="getGreeting">
 18 <xs:complexType>
 19 <xs:sequence>
 20 <xs:element minOccurs="0" name="args0" nillable="true" type="xs:string"/>
 21 </xs:sequence>
 22 </xs:complexType>
 23 </xs:element>
 24 <xs:element name="getGreetingResponse">
 25 <xs:complexType>
 26 <xs:sequence>
 27 <xs:element minOccurs="0" name="return" nillable="true" type="xs:string"/>
 28 </xs:sequence>
 29 </xs:complexType>
 30 </xs:element>
 31 </xs:schema>
 32 </wsdl:types>
 33 <wsdl:message name="getPriceRequest">
 34 <wsdl:part name="parameters" element="ns:getPrice"/>
 35 </wsdl:message>
 36 <wsdl:message name="getPriceResponse">
 37 <wsdl:part name="parameters" element="ns:getPriceResponse"/>
 38 </wsdl:message>
 39 <wsdl:message name="getGreetingRequest">
 40 <wsdl:part name="parameters" element="ns:getGreeting"/>
 41 </wsdl:message>
 42 <wsdl:message name="getGreetingResponse">
 43 <wsdl:part name="parameters" element="ns:getGreetingResponse"/>
 44 </wsdl:message>
 45 <wsdl:portType name="SimpleServicePortType">
 46 <wsdl:operation name="getPrice">
 47 <wsdl:input message="ns:getPriceRequest" wsaw:Action="urn:getPrice"/>
 48 <wsdl:output message="ns:getPriceResponse" wsaw:Action="urn:getPriceResponse"/>
 49 </wsdl:operation>
 50 <wsdl:operation name="getGreeting">
 51 <wsdl:input message="ns:getGreetingRequest" wsaw:Action="urn:getGreeting"/>
 52 <wsdl:output message="ns:getGreetingResponse" wsaw:Action="urn:getGreetingResponse"/>
 53 </wsdl:operation>
 54 </wsdl:portType>
 55 <wsdl:binding name="SimpleServiceSoap11Binding" type="ns:SimpleServicePortType">
 56 <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
 57 <wsdl:operation name="getPrice">
 58 <soap:operation soapAction="urn:getPrice" style="document"/>
 59 <wsdl:input>
 60 <soap:body use="literal"/>
 61 </wsdl:input>
 62 <wsdl:output>
 63 <soap:body use="literal"/>
 64 </wsdl:output>
 65 </wsdl:operation>
 66 <wsdl:operation name="getGreeting">
 67 <soap:operation soapAction="urn:getGreeting" style="document"/>
 68 <wsdl:input>
 69 <soap:body use="literal"/>
 70 </wsdl:input>
 71 <wsdl:output>
 72 <soap:body use="literal"/>
 73 </wsdl:output>
 74 </wsdl:operation>
 75 </wsdl:binding>
 76 <wsdl:binding name="SimpleServiceSoap12Binding" type="ns:SimpleServicePortType">
 77 <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
 78 <wsdl:operation name="getPrice">
 79 <soap12:operation soapAction="urn:getPrice" style="document"/>
 80 <wsdl:input>
 81 <soap12:body use="literal"/>
 82 </wsdl:input>
 83 <wsdl:output>
 84 <soap12:body use="literal"/>
 85 </wsdl:output>
 86 </wsdl:operation>
 87 <wsdl:operation name="getGreeting">
 88 <soap12:operation soapAction="urn:getGreeting" style="document"/>
 89 <wsdl:input>
 90 <soap12:body use="literal"/>
 91 </wsdl:input>
 92 <wsdl:output>
 93 <soap12:body use="literal"/>
 94 </wsdl:output>
 95 </wsdl:operation>
 96 </wsdl:binding>
 97 <wsdl:binding name="SimpleServiceHttpBinding" type="ns:SimpleServicePortType">
 98 <http:binding verb="POST"/>
 99 <wsdl:operation name="getPrice">
100 <http:operation location="getPrice"/>
101 <wsdl:input>
102 <mime:content type="application/xml" part="parameters"/>
103 </wsdl:input>
104 <wsdl:output>
105 <mime:content type="application/xml" part="parameters"/>
106 </wsdl:output>
107 </wsdl:operation>
108 <wsdl:operation name="getGreeting">
109 <http:operation location="getGreeting"/>
110 <wsdl:input>
111 <mime:content type="application/xml" part="parameters"/>
112 </wsdl:input>
113 <wsdl:output>
114 <mime:content type="application/xml" part="parameters"/>
115 </wsdl:output>
116 </wsdl:operation>
117 </wsdl:binding>
118 <wsdl:service name="SimpleService">
119 <wsdl:port name="SimpleServiceHttpSoap11Endpoint" binding="ns:SimpleServiceSoap11Binding">
120 <soap:address location="http://localhost:8080/axis2/services/SimpleService.SimpleServiceHttpSoap11Endpoint/"/>
121 </wsdl:port>
122 <wsdl:port name="SimpleServiceHttpSoap12Endpoint" binding="ns:SimpleServiceSoap12Binding">
123 <soap12:address location="http://localhost:8080/axis2/services/SimpleService.SimpleServiceHttpSoap12Endpoint/"/>
124 </wsdl:port>
125 <wsdl:port name="SimpleServiceHttpEndpoint" binding="ns:SimpleServiceHttpBinding">
126 <http:address location="http://localhost:8080/axis2/services/SimpleService.SimpleServiceHttpEndpoint/"/>
127 </wsdl:port>
128 </wsdl:service>
129 </wsdl:definitions>

View Code