的服务实例:
? create(QName serviceName) 为带有给定名称的服务返回一个服务对象。没
有向该服务附加任何 WSDL 文档。 之后调用service#addPort为其添加端口并指定服务端点地址。
? create(URL wsdlLocation, QName serviceName) 为指定的 WSDL 文档
返回服务对象并返回服务名。
创建Service对象的代码如下所示:
33. URL wsdlURL = new URL(\
\
34. QName serviceQName = new QName(\35.
\
36. Service service = Service.create(wsdlURL, serviceQName);
第三步:
现在可以使用Service对象创建Dispatch
39. QName portQName = new QName(\40. 42.
\
Source.class, Service.Mode.PAYLOAD);
41. Dispatch
Service#createDispatch方法接收三个参数,wsdl:portType的QName/类型参数T的Class及服务模式。类型参数T指定了用于封装要发送的XML数据的Class。Dispatch
第四步:
用来调用服务的XML文档如下所示,它与使用SEI方法的例子中的用例一是等价的。
CUST001
调用代码如下所示:
(\
46. InputStream xmlFile = Client.class.getResourceAsStream 47. StreamSource xmlSource = new StreamSource(xmlFile); 48. Source orderSource = dispatch.invoke(xmlSource);
服务器端返回的XML文档格式化后如下所示:
xmlns:S=\xmlns:ns3=\ xmlns=\
另一种使用Dispatch类来进行XML消息传递的方法,就是编写自己的JAXB标注类来表示Web服务发送和接收的XML消息。这里使用了JAXB,但是并没有使用由JAX-WS生成的SEI,而是使用JAXB标注将自己现有的Java类映射到目标Web服务接收和发送的消息有效负载。
程序开发步骤如下: 第一步:
在Eclipse中新建项目JAXBXMLMessageClient。 第二步:
创建使用JAXB标注与XML请求消息绑定的Java类。比如对于请求消息的包装器元素:
9. @XmlAccessorType(XmlAccessType.FIELD)
10. @XmlType(namespace = \11. @XmlRootElement(name = \12. namespace = \13. public class MyRequestOrder { 14. 15. 16. 17.
protected String CUST_NO; protected String PURCH_ORD_NO; protected MyCreditCard ccard; protected List
18.}
MyRequestOrder是四个元素的容器,每个参数分别与req:requestOrder的子元素相对应。类似的使用实验2中介绍的JAXB的标注来创建其它的类。 第三步:
创建Client类。Client类中使用与直接发送XML的相同的方法来创建Service对象的实例。使用Service对象创建Dispatch的方法如下:
30. JAXBContext ctxt = JAXBContext.newInstance(MyRequestOrder.class, 31. 33.
MyRequestOrderResponse.class); \
32. QName portQName = new QName(\
34. Dispatch
Service.Mode.PAYLOAD);
这里创建Dispatch的实例的时候,createDispatch方法接收的是JAXBContext实例,而不是类型参数。底层的Dispatch对象将使用该对象来完成Java与消息有效负载之间的封送/拆收转换。 第四步:
在创建Dispatch
44. MyRequestOrderResponse resp = (MyRequestOrderResponse) dispatchJAXB 45.
.invoke(myReq);
第五步:
运行项目,可以看到与直接使用XML方法相同的输出。
三、 异步调用WEB服务
对于SOA编程来说,异步调用是一个非常强大的工具。有的情况下,Web服务的调用执行要比在本地地址空间的处理慢很多。此时可以使用单独的线程运行WEB服务调用,而且本地执行代码在等待这些线程调用完成的同时,还能继续自己的工作,从而能很大的提高代码运行的速度。
JAX-WS为异步处理提供了两种方法:轮询和回调。在异步调用的轮询方式中,代码不断轮询一个java.xml.ws.Response
轮询的方式是通过dispatch#invokeAsync实现的,代码示例如下:
Response
long elapsed = (new Date()).getTime() - startTime;
在幕后,该方法使用java.util.concurrent.Executor和Service实例,用一个单独的线程来调用WEB服务。异步调用将返回Response
下面将说明如何使用SEI代理进行异步调用。 第一步:
使用wsimport工具生成SEI。假设目标wsdl:operation的同步映射方法的形式如下所示:
Xxx port.yyyZzz()
其中,Xxx为返回类型,yyyZzz为属性名称。那么,对于相同的wsdl:operation,其轮询方式的异步映射的方法名,应该类似于以下形式: Response
其回调方式的的方法名,应该类似于以下形式:
Future
用来生成这些接口的绑定语言声明,可以要WSDL内部以内联方式指定,但是,WSDL会随着WEB服务一起发布,因此WSDL中不应该包含只有Java客户端才使用的定制绑定语言声明,而是将其放在单独的文件中,使用XPath表达式来指定wsdl:port以及wsdl:operation。在本例中,文件内容如下:
1.
3. wsdlLocation=\4. xmlns=\
5.
该文件说明了RequestOrderPort下的requestOrder应该被映射成异步方法。 在使用wsimport的时候,可以使用-b选项来指明绑定文件。
运行以下命令生成SEI:
-s
./src
-d
./bin
-p
client.sei
-b
async-binding-customizations.xml
http://localhost:8088/RequestOrderService?wsdl
在生成的SEI RequestOrderPort.java中,增加了两个异步调用的方法。
第二步:
在Eclipse中新建项目AsyncClient并将生成的包client.sei导入。 第三步:
为异步调用创建回调处理类RequestOrderCallbackHandler,其处理代码如下:
27. long elapsed = (new Date()).getTime() - startTime; 28. Marshaller m; 29. try { 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. 42.
JAXBContext jc = JAXBContext
.newInstance(RequestOrderResponse.class); m = jc.createMarshaller();
m.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE);
System.out.println(); System.out
.println(\System.out.println(\
System.out.println(\System.out
.println(\System.out.println(elapsed + \