本文所用到的WebServices服務端，取自我的上一篇文章中的例子——使用XFire開發WebServices服務端
這里并未涉及到JSR 181 Annotations的相關應用，具體的三種方式如下
①通過WSDL地址來創建動態客戶端
②通過服務端提供的接口來創建客戶端
③使用Ant通過WSDL文件來生成客戶端


第一種方式：通過WSDL地址來創建動態客戶端

  1. package com.jadyer.client;  
  2. import java.net.MalformedURLException;  
  3. import java.net.URL;  
  4. import org.codehaus.xfire.client.Client;  
  5. /** 
  6.  * 通過WSDL來創建動態客戶端 
  7.  * @see 此時需要在項目中引入XFire 1.2 Core Libraries和XFire 1.2 HTTP Client Libraries 
  8.  */  
  9. public class ClientFromWSDL {  
  10.     public static void main(String[] args) throws MalformedURLException, Exception {  
  11.         Client client = new Client(new URL("http://127.0.0.1:8080/XFire_demo/services/XFireServer?wsdl"));  
  12.         Object[] results11 = client.invoke("sayHello", new Object[]{"Jadyer22"});  
  13.         System.out.println(results11[0]);  
  14.     }  
  15. }  

 

第二種方式：通過服務端提供的端口來創建客戶端

  1. package com.jadyer.client;  
  2. import java.net.MalformedURLException;  
  3. import java.util.List;  
  4. import org.codehaus.xfire.client.XFireProxyFactory;  
  5. import org.codehaus.xfire.service.Service;  
  6. import org.codehaus.xfire.service.binding.ObjectServiceFactory;  
  7. import com.jadyer.model.Person;  
  8. import com.jadyer.model.User;  
  9. import com.jadyer.server.HelloService;  
  10. /** 
  11.  * 通過Web服務端提供的接口來創建客戶端 
  12.  * @see 客戶端必須提供一個與服務端完全一致的接口，包名也要一致 
  13.  * @see 在本例中，需要在客戶端(即該項目)中提供HelloService.java接口，以及Person和User兩個POJO類 
  14.  * @see 并且此時需要在項目中引入XFire 1.2 Core Libraries和XFire 1.2 HTTP Client Libraries 
  15.  */  
  16. public class ClientFromInterface {  
  17.     public static void main(String[] args)throws MalformedURLException{  
  18.         //首先使用XFire的ObjectServiceFactory從HelloService接口創建一個服務模型serviceModel  
  19.         //serviceModel包含服務的說明，換句話說，就是服務的元數據  
  20.         //Create a metadata of the service  
  21.         Service serviceModel = new ObjectServiceFactory().create(HelloService.class);  
  22.           
  23.         //訪問的地址  
  24.         String serviceURL = "http://127.0.0.1:8080/XFire_demo/services/XFireServer";  
  25.           
  26.         //通過查看org.codehaus.xfire.client.XFireProxyFactory源碼發現  
  27.         //下面兩行代碼與這里直接new XFireProxyFactory()的作用是等效的  
  28.         //XFire xfire = XFireFactory.newInstance().getXFire();  
  29.         //XFireProxyFactory factory = new XFireProxyFactory(xfire);  
  30.         //為XFire獲得一個代理工廠對象  
  31.         //Create a proxy for the deployed service  
  32.         XFireProxyFactory factory = new XFireProxyFactory();  
  33.           
  34.         //通過proxyFactory，使用服務模型serviceModel和服務端點URL(用來獲得WSDL)  
  35.         //得到一個服務的本地代理，這個代理就是實際的客戶端  
  36.         HelloService client = (HelloService)factory.create(serviceModel, serviceURL);  
  37.           
  38.         /** 
  39.          * Invoke the service 
  40.          * @see 調用服務的本地代理(即實際的客戶端)中的方法，便得到我們需要的WebServcie 
  41.          */  
  42.           
  43.         /*--處理簡單對象--*/  
  44.         String serviceResponse = client.sayHello("Jadyer11");  
  45.         System.out.println(serviceResponse);  
  46.           
  47.         /*--處理對象--*/  
  48.         User u = new User();  
  49.         u.setName("Jadyer99");  
  50.         Person pp = client.getPerson(u);  
  51.         System.out.println(pp.getName());  
  52.           
  53.         /*--處理List--*/  
  54.         List<Person> personList = client.getPersonList(24, "Jadyer88");  
  55.         for(Person p : personList){  
  56.             System.out.println(p.getName());  
  57.         }  
  58.     }  
  59. }  

 

這是它要用到的接口和兩個POJO類

  1. /** 
  2.  * Web服務提供給客戶端的接口 
  3.  * @see 這是第二種方式創建的客戶端，要用到的接口 
  4.  */  
  5. package com.jadyer.server;  
  6. import java.util.List;  
  7. import com.jadyer.model.Person;  
  8. import com.jadyer.model.User;  
  9. public interface HelloService {  
  10.     public String sayHello(String name);  
  11.     public Person getPerson(User u);  
  12.     public List<Person> getPersonList(Integer age, String name);  
  13. }  
  14. /** 
  15.  * 第二種方式創建的客戶端，要用到的兩個POJO類 
  16.  */  
  17. package com.jadyer.model;  
  18. public class User {  
  19.     private String name;  
  20.     /*--getter和setter略--*/  
  21. }  
  22. package com.jadyer.model;  
  23. public class Person {  
  24.     private Integer age;  
  25.     private String name;  
  26.     /*--getter和setter略--*/  
  27. }  

 

第三種方式：使用Ant通過WSDL文件來生成客戶端

  1. package com.jadyer.client;  
  2. /** 
  3.  * 使用Ant通過WSDL生成客戶端 
  4.  * @see 這里的ClientFromAnt.java是我自己創建的，并非Ant生成 
  5.  * @see 這里要用到的JAR有：xfire-all-1.2.6.jar以及//xfire-distribution-1.2.6//lib//目錄中的所有JAR包 
  6.  * @see 我們需要把這些JAR包都拷貝到Web Project//WebRoot//WEB-INF//lib//目錄中 
  7.  * @see 然后把build.xml和MyFirstXFireServer.wsdl都拷貝到下Web Project的根目錄下即可 
  8.  * @see 關于MyFirstXFireServer.wsdl文件，是我在WebServices服務啟動后 
  9.  * @see 訪問http://127.0.0.1:8080/XFire_demo/services/XFireServer?wsdl然后將其另存得到的 
  10.  */  
  11. public class ClientFromAnt {  
  12.     public static void main(String[] args) {  
  13.         XFireServerClient client = new XFireServerClient();  
  14.         //String url = "http://127.0.0.1:8080/XFire_demo/services/XFireServer";  
  15.         //String result = client.getXFireServerHttpPort(url).sayHello("Jadyer33");  
  16.         //上面的兩行代碼，與下面的這一行代碼，同效~~  
  17.         String result = client.getXFireServerHttpPort().sayHello("Jadyer33");  
  18.           
  19.         System.out.println(result);  
  20.     }  
  21. }  

 

用到的Ant文件，如下

  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <project name="wsgen" default="wsgen" basedir=".">  
  3.     <path id="classpathId">  
  4.         <fileset dir="./WebRoot/WEB-INF/lib">  
  5.             <include name="*.jar" />  
  6.         </fileset>  
  7.     </path>  
  8.       
  9.     <taskdef classpathref="classpathId" name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask"/>  
  10.       
  11.     <target name="wsgen" description="generate client">  
  12.         <wsgen outputDirectory="./src/" wsdl="MyFirstXFireServer.wsdl" binding="xmlbeans" package="com.jadyer.client" overwrite="true"/>  
  13.     </target>  
  14. </project>  

 

也可以使用下面的這個Ant文件

  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <project name="xfireAnt" basedir="." default="createClientCode">  
  3.     <property name="xfirelib" value="${basedir}/WebRoot/WEB-INF/lib"/>  
  4.     <property name="sources" value="${basedir}/src"/>  
  5.     <path id="classpath">  
  6.         <fileset dir="${xfirelib}">  
  7.             <include name="*.jar"/>  
  8.         </fileset>  
  9.     </path>  
  10.           
  11.     <target name="createClientCode">  
  12.         <taskdef name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask" classpathref="classpath"/>  
  13.         <wsgen outputDirectory="${sources}" wsdl="http://127.0.0.1:8080/XFire_demo/services/XFireServer?wsdl" package="com.jadyer.client" overwrite="true"/>  
  14.     </target>  
  15. </project>  

 

最后我再把MyFirstXFireServer.wsdl的內容，附加上

  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <wsdl:definitions targetNamespace="http://www.jadyer.com/XFireDemo"  
  3.     xmlns:tns="http://www.jadyer.com/XFireDemo"  
  4.     xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"  
  5.     xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"  
  6.     xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
  7.     xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/"  
  8.     xmlns:soapenc12="http://www.w3.org/2003/05/soap-encoding"  
  9.     xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/"  
  10.     xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">  
  11.     <wsdl:types>  
  12.         <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
  13.                     attributeFormDefault="qualified"  
  14.                     elementFormDefault="qualified"  
  15.                     targetNamespace="http://www.jadyer.com/XFireDemo">  
  16.             <xsd:element name="sayHello">  
  17.                 <xsd:complexType>  
  18.                     <xsd:sequence>  
  19.                         <xsd:element maxOccurs="1" minOccurs="1" name="in0" nillable="true" type="xsd:string" />  
  20.                     </xsd:sequence>  
  21.                 </xsd:complexType>  
  22.             </xsd:element>  
  23.             <xsd:element name="sayHelloResponse">  
  24.                 <xsd:complexType>  
  25.                     <xsd:sequence>  
  26.                         <xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string" />  
  27.                     </xsd:sequence>  
  28.                 </xsd:complexType>  
  29.             </xsd:element>  
  30.         </xsd:schema>  
  31.     </wsdl:types>  
  32.     <wsdl:message name="sayHelloRequest">  
  33.         <wsdl:part name="parameters" element="tns:sayHello"></wsdl:part>  
  34.     </wsdl:message>  
  35.     <wsdl:message name="sayHelloResponse">  
  36.         <wsdl:part name="parameters" element="tns:sayHelloResponse"></wsdl:part>  
  37.     </wsdl:message>  
  38.     <wsdl:portType name="XFireServerPortType">  
  39.         <wsdl:operation name="sayHello">  
  40.             <wsdl:input name="sayHelloRequest" message="tns:sayHelloRequest">  
  41.             </wsdl:input>  
  42.             <wsdl:output name="sayHelloResponse" message="tns:sayHelloResponse">  
  43.             </wsdl:output>  
  44.         </wsdl:operation>  
  45.     </wsdl:portType>  
  46.     <wsdl:binding name="XFireServerHttpBinding" type="tns:XFireServerPortType">  
  47.         <wsdlsoap:binding style="document" mce_style="document" transport="http://schemas.xmlsoap.org/soap/http" />  
  48.         <wsdl:operation name="sayHello">  
  49.             <wsdlsoap:operation soapAction="" />  
  50.             <wsdl:input name="sayHelloRequest">  
  51.                 <wsdlsoap:body use="literal" />  
  52.             </wsdl:input>  
  53.             <wsdl:output name="sayHelloResponse">  
  54.                 <wsdlsoap:body use="literal" />  
  55.             </wsdl:output>  
  56.         </wsdl:operation>  
  57.     </wsdl:binding>  
  58.     <wsdl:service name="XFireServer">  
  59.         <wsdl:port name="XFireServerHttpPort" binding="tns:XFireServerHttpBinding">  
  60.             <wsdlsoap:address location="http://127.0.0.1:8080/XFire_demo/services/XFireServer" />  
  61.         </wsdl:port>  
  62.     </wsdl:service>  
  63. </wsdl:definitions>