学步园

本文所用到的WebServices服务端，取自我的上一篇文章中的例子——使用XFire开发WebServices服务端
这里并未涉及到JSR 181 Annotations的相关应用，具体的三种方式如下
①通过WSDL地址来创建动态客户端
②通过服务端提供的接口来创建客户端
③使用Ant通过WSDL文件来生成客户端

第一种方式：通过WSDL地址来创建动态客户端

package com.jadyer.client;<br /> import java.net.MalformedURLException;<br /> import java.net.URL;<br /> import org.codehaus.xfire.client.Client;<br /> /**<br /> * 通过WSDL来创建动态客户端<br /> * @see 此时需要在项目中引入XFire 1.2 Core Libraries和XFire 1.2 HTTP Client Libraries<br /> */<br /> public class ClientFromWSDL {<br /> public static void main(String[] args) throws MalformedURLException, Exception {<br /> Client client = new Client(new URL("http://127.0.0.1:8080/XFire_demo/services/XFireServer?wsdl"));<br /> Object[] results11 = client.invoke("sayHello", new Object[]{"Jadyer22"});<br /> System.out.println(results11[0]);<br /> }<br /> }

第二种方式：通过服务端提供的端口来创建客户端

package com.jadyer.client;<br /> import java.net.MalformedURLException;<br /> import java.util.List;<br /> import org.codehaus.xfire.client.XFireProxyFactory;<br /> import org.codehaus.xfire.service.Service;<br /> import org.codehaus.xfire.service.binding.ObjectServiceFactory;<br /> import com.jadyer.model.Person;<br /> import com.jadyer.model.User;<br /> import com.jadyer.server.HelloService;<br /> /**<br /> * 通过Web服务端提供的接口来创建客户端<br /> * @see 客户端必须提供一个与服务端完全一致的接口，包名也要一致<br /> * @see 在本例中，需要在客户端(即该项目)中提供HelloService.java接口，以及Person和User两个POJO类<br /> * @see 并且此时需要在项目中引入XFire 1.2 Core Libraries和XFire 1.2 HTTP Client Libraries<br /> */<br /> public class ClientFromInterface {<br /> public static void main(String[] args)throws MalformedURLException{<br /> //首先使用XFire的ObjectServiceFactory从HelloService接口创建一个服务模型serviceModel<br /> //serviceModel包含服务的说明，换句话说，就是服务的元数据<br /> //Create a metadata of the service<br /> Service serviceModel = new ObjectServiceFactory().create(HelloService.class);</p> <p> //访问的地址<br /> String serviceURL = "http://127.0.0.1:8080/XFire_demo/services/XFireServer";</p> <p> //通过查看org.codehaus.xfire.client.XFireProxyFactory源码发现<br /> //下面两行代码与这里直接new XFireProxyFactory()的作用是等效的<br /> //XFire xfire = XFireFactory.newInstance().getXFire();<br /> //XFireProxyFactory factory = new XFireProxyFactory(xfire);<br /> //为XFire获得一个代理工厂对象<br /> //Create a proxy for the deployed service<br /> XFireProxyFactory factory = new XFireProxyFactory();</p> <p> //通过proxyFactory，使用服务模型serviceModel和服务端点URL(用来获得WSDL)<br /> //得到一个服务的本地代理，这个代理就是实际的客户端<br /> HelloService client = (HelloService)factory.create(serviceModel, serviceURL);</p> <p> /**<br /> * Invoke the service<br /> * @see 调用服务的本地代理(即实际的客户端)中的方法，便得到我们需要的WebServcie<br /> */</p> <p> /*--处理简单对象--*/<br /> String serviceResponse = client.sayHello("Jadyer11");<br /> System.out.println(serviceResponse);</p> <p> /*--处理对象--*/<br /> User u = new User();<br /> u.setName("Jadyer99");<br /> Person pp = client.getPerson(u);<br /> System.out.println(pp.getName());</p> <p> /*--处理List--*/<br /> List<Person> personList = client.getPersonList(24, "Jadyer88");<br /> for(Person p : personList){<br /> System.out.println(p.getName());<br /> }<br /> }<br /> }

这是它要用到的接口和两个POJO类

/**<br /> * Web服务提供给客户端的接口<br /> * @see 这是第二种方式创建的客户端，要用到的接口<br /> */<br /> package com.jadyer.server;<br /> import java.util.List;<br /> import com.jadyer.model.Person;<br /> import com.jadyer.model.User;<br /> public interface HelloService {<br /> public String sayHello(String name);<br /> public Person getPerson(User u);<br /> public List<Person> getPersonList(Integer age, String name);<br /> }<br /> /**<br /> * 第二种方式创建的客户端，要用到的两个POJO类<br /> */<br /> package com.jadyer.model;<br /> public class User {<br /> private String name;<br /> /*--getter和setter略--*/<br /> }<br /> package com.jadyer.model;<br /> public class Person {<br /> private Integer age;<br /> private String name;<br /> /*--getter和setter略--*/<br /> }

第三种方式：使用Ant通过WSDL文件来生成客户端

package com.jadyer.client;<br /> /**<br /> * 使用Ant通过WSDL生成客户端<br /> * @see 这里的ClientFromAnt.java是我自己创建的，并非Ant生成<br /> * @see 这里要用到的JAR有：xfire-all-1.2.6.jar以及//xfire-distribution-1.2.6//lib//目录中的所有JAR包<br /> * @see 我们需要把这些JAR包都拷贝到Web Project//WebRoot//WEB-INF//lib//目录中<br /> * @see 然后把build.xml和MyFirstXFireServer.wsdl都拷贝到下Web Project的根目录下即可<br /> * @see 关于MyFirstXFireServer.wsdl文件，是我在WebServices服务启动后<br /> * @see 访问http://127.0.0.1:8080/XFire_demo/services/XFireServer?wsdl然后将其另存得到的<br /> */<br /> public class ClientFromAnt {<br /> public static void main(String[] args) {<br /> XFireServerClient client = new XFireServerClient();<br /> //String url = "http://127.0.0.1:8080/XFire_demo/services/XFireServer";<br /> //String result = client.getXFireServerHttpPort(url).sayHello("Jadyer33");<br /> //上面的两行代码，与下面的这一行代码，同效~~<br /> String result = client.getXFireServerHttpPort().sayHello("Jadyer33");</p> <p> System.out.println(result);<br /> }<br /> }

用到的Ant文件，如下

<?xml version="1.0" encoding="UTF-8"?><br /> <project name="wsgen" default="wsgen" basedir="."><br /> <path id="classpathId"><br /> <fileset dir="./WebRoot/WEB-INF/lib"><br /> <include name="*.jar" /><br /> </fileset><br /> </path></p> <p> <taskdef classpathref="classpathId" name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask"/></p> <p> <target name="wsgen" description="generate client"><br /> <wsgen outputDirectory="./src/" wsdl="MyFirstXFireServer.wsdl" binding="xmlbeans" package="com.jadyer.client" overwrite="true"/><br /> </target><br /> </project>

也可以使用下面的这个Ant文件

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

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

<?xml version="1.0" encoding="UTF-8"?><br /> <wsdl:definitions targetNamespace="http://www.jadyer.com/XFireDemo"<br /> xmlns:tns="http://www.jadyer.com/XFireDemo"<br /> xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"<br /> xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"<br /> xmlns:xsd="http://www.w3.org/2001/XMLSchema"<br /> xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/"<br /> xmlns:soapenc12="http://www.w3.org/2003/05/soap-encoding"<br /> xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/"<br /> xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"><br /> <wsdl:types><br /> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"<br /> attributeFormDefault="qualified"<br /> elementFormDefault="qualified"<br /> targetNamespace="http://www.jadyer.com/XFireDemo"><br /> <xsd:element name="sayHello"><br /> <xsd:complexType><br /> <xsd:sequence><br /> <xsd:element maxOccurs="1" minOccurs="1" name="in0" nillable="true" type="xsd:string" /><br /> </xsd:sequence><br /> </xsd:complexType><br /> </xsd:element><br /> <xsd:element name="sayHelloResponse"><br /> <xsd:complexType><br /> <xsd:sequence><br /> <xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string" /><br /> </xsd:sequence><br /> </xsd:complexType><br /> </xsd:element><br /> </xsd:schema><br /> </wsdl:types><br /> <wsdl:message name="sayHelloRequest"><br /> <wsdl:part name="parameters" element="tns:sayHello"></wsdl:part><br /> </wsdl:message><br /> <wsdl:message name="sayHelloResponse"><br /> <wsdl:part name="parameters" element="tns:sayHelloResponse"></wsdl:part><br /> </wsdl:message><br /> <wsdl:portType name="XFireServerPortType"><br /> <wsdl:operation name="sayHello"><br /> <wsdl:input name="sayHelloRequest" message="tns:sayHelloRequest"><br /> </wsdl:input><br /> <wsdl:output name="sayHelloResponse" message="tns:sayHelloResponse"><br /> </wsdl:output><br /> </wsdl:operation><br /> </wsdl:portType><br /> <wsdl:binding name="XFireServerHttpBinding" type="tns:XFireServerPortType"><br /> <wsdlsoap:binding style="document" mce_style="document" transport="http://schemas.xmlsoap.org/soap/http" /><br /> <wsdl:operation name="sayHello"><br /> <wsdlsoap:operation soapAction="" /><br /> <wsdl:input name="sayHelloRequest"><br /> <wsdlsoap:body use="literal" /><br /> </wsdl:input><br /> <wsdl:output name="sayHelloResponse"><br /> <wsdlsoap:body use="literal" /><br /> </wsdl:output><br /> </wsdl:operation><br /> </wsdl:binding><br /> <wsdl:service name="XFireServer"><br /> <wsdl:port name="XFireServerHttpPort" binding="tns:XFireServerHttpBinding"><br /> <wsdlsoap:address location="http://127.0.0.1:8080/XFire_demo/services/XFireServer" /><br /> </wsdl:port><br /> </wsdl:service><br /> </wsdl:definitions>