35. 36.
@WebParam(name = \\List
该类标注的方法与直接使用wsimport工具生成的SEI中的RequestOrderPort基本相同,此处不再重复。
第五步:
新建server.main.Main类,使用Endpoint类将服务发布到http://localhost:8088/RequestOrderService。使用SOAPUI发起请求,可以看到服务可以正确响应。
除直接标注的方法外,使用适配器的方法可以通过首先使用wsimport生成SEI,然后在SEI的实现类中直接调用已经存在的业务方法实现,其步骤与使用直接使用SEI的方法相似。使用XLST使用的方法已在实验1中演示,此处也不再重复。
实验附件:
实验5、使用JAX-WS开发WEB服务客户端
实验环境:
1、 GLASSFISH 3.1
实验内容:
1、 使用代理调用WEB服务
2、 使用Dispatch
实验步骤:
一、 使用代理调用WEB服务
创建调用WEB服务的客户端,最简便的方法是使用与实验2中相同的方法来创建SEI,并利用该SEI调用WEB服务。虽然SEI的生成方法与服务器端相同,但是它们所起的作用是不同的。在服务器端,SEI的作用是确定了服务实现Bean的接口,需要开发者自己提供SEI的实现。但是在客户端,实现SEI的类的实例是JAX-WS通过Java的动态代理类(参考java.lang.reflect.Proxy类的Javadoc文档)在运行时动态创建的,该实例会根据程序中的标注,将对SEI方法的调用转换成通过SOAP请求对服务器端WEB服务的调用,并将服务器端返回的SOAP响应转换成方法的返回值,从而完成对WEB服务的调用。
使用代理的客户端开发步骤如下 : 第一步:
运行实验2中的服务端WSServer。该项目会将RequestOrder服务发布在地址http://localhost:8088/RequestOrderService上。
第二步: 运行命令
该命令作用与实验2中相同,只是用于生成SEI的WSDL使用了服务器端的WSDL而不是本地的WSDL。打开文件夹./client/sei,可以看到实验2中相比,除了个别文件命名有差别,生成的文件基本相同。
第三步:
在Eclipse中新建项目WSClient,将生成的包client.sei导入。并在包client.main下新建类Client。在该类中,使用如下方法来获得一个RequestOrderPort的动态代理实例:
50. RequestOrder_Service service = new RequestOrder_Service(); 51. RequestOrderPort port = service.getRequestOrderPort();
打开类RequestOrder_Service,可以看到该类是通过Service#getPort方法获得了RequestOrderPort的动态代理实例。然后就可以通过调用类RequestOrderPort动态代理实例的requestOrder方法来完成对WEB服务的调用。
第四步:
在Client中增加一个将调用RequestOrderPort#requestOrder方法返回的OrderType转换成XML并打印的方法以便于调试。该方法如下所示:
132. private static void printReturnedOrder(OrderType order) { 133. 134. 135. 136. 137. 138. 139. 140. 141. 142. 143. 144. 145. 146. 147. 148. 149. 150. 151. 152. 153. 154. 155. 156. }
Marshaller m = null; try { }
if (m != null) { }
JAXBElement
System.out.println(\System.out.println(\
+ order.getOrderHeader().getPURCHDATE());
System.out.println(\
new QName(\OrderType.class, order);
JAXBContext jc = JAXBContext.newInstance(OrderType.class); m = jc.createMarshaller();
m.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE); m.setProperty(Marshaller.JAXB_ENCODING,\
} catch (Exception e) {
try {
m.marshal(orderElement, System.out); e.printStackTrace(); } catch (JAXBException e) {
} else {
由于在生成SEI的时候,JAXB也将服务中涉及到的Schema与Java类建立了绑定关系,因此可以直接通过JAXB的接口将OrderType对象封送为XML片段并使用标准输出打印。为了完成封送过程,首先使用
JAXBContext.newInstance(java.lang.Class...)
创建一个新的JAXB上下文,这样创建的上下文可以识别在参数中指定的类以及这些类中以静态方式直接或间接引用的类。然后,使用该上下文创建一个Marshaller实例并设置相应的参数,最后将要封送的对象封装到JAXBElement中并使用Marshaller的marshal方法来完成封送过程。
第五步:
假设客户使用银行卡购买两件商品,对该用例进行编码如下: 54. BUSOBJCCARD ccard = createCreditCard();
55. ArrayList
57. OrderType order; 58. try {
59. System.out.println(\60. order = port.requestOrder(\
61. printReturnedOrder(order);
运行该用例,可以看到控制台输入如下:
7828546468
即服务器端成功返回了客户的订单。 第六步:
假设客户端发送的消息中客户编号为空,此时服务器端会抛出一个输入参数错误异常。该异常在WSDL文件是映射过的,即对应WSDL文件夹中的如下wsdl:fault映射: 68. try { 69. 70. 71. 72. System.out.println(\order = port.requestOrder(\ itemList); }catch (InputFault e) { // a checked exception ... 运行代码,发现程序并未按预想的抛出InputFault异常,而是抛出了SOAPFaultException。查看接收到的SOAP消息,发现在detail信息中,异常被映射到如下XML片段: xmlns:ns4=\ xmlns:ns8=\be null.\ 其中inputMessageValidationFault和msg属性的命名空间为http:// www.example.com/oms,而不是WSDL中定义的http://www.example.com/fault。查看代码,可以发现,InputMessageValidationFaultType类中的msg属性值的@XmlAttribute标注未添加命令空间映射,从而使用了在package-info.java中对包中映射的全局命令空间,造成错误。因此,修改客户端与服务器端的InputMessageValidationFaultType中的msg属性的标注,添加namespace定义: @XmlAttribute(namespace=\ 重新运行服务器端与客户端,可以发现此果输出了正确的报错信息: Running test with null customer number. Mapped Exception (InputFault) InputFault.getMessage() = Input parameter failed validation. InputFault.getFaultInfo.getMsg() = Customer Number cannot be null. 第七步: 假设客户端发送的信用卡数据已经过期,服务器端就会返回一个异常,但是这个异常并未在WSDL进行映射。这时,在客户端对RequestOrderPort#requestOrder的调用时就会抛出SOAPFaultException。此时服务器端返回的SOAP消息如下: xmlns:S=\ class=\note=\disable this feature, set com.sun.xml.internal.ws.fault.SOAPFaultBuilder.disableCaptureStackTrace system property to false\ 二、 使用Dispatch 尽管通过动态代理可以让WEB服务调用看起来就像调用Java方法一样简单,但是有的时候这种方法不足以满足我的要求。 ? 代理方法必须使用从WSDL生成的SEI,而其生成方法必须按照标准的JAX-WS WSDL到JAVA的映射方式。如果本来已经有一个基于JAVA的订单管理系统,么很有可能这个系统已经有一个信用卡类,但是使用SEI就必须使用从WSDL中生成的信用卡类,从而不得不在这两个类之间进行一些转化。 ? 有的时候需要直接使用XML来调用WEB服务,比如要发送的文档是XSLT处理的 结果,这时就可以直接使用Dispatch 来提供 SOAP 信封然后发送消息。 ? 有的时候可以希望可以动态调用WEB服务。此时调用WEB服务不用提前生成和编 译SEI。比如可以通过服务注册机制,先查询需要的WEB服务,这样的情况就会发生。 对于直接使用原始的XML进行消息传递的情况,程序的开发步骤如下: 第一步: 在Eclipse中新建项目XMLMessageClient。在包client.main下新建类 。 第二步: 客户端可以使用 Service#create 方法来创建一个 Service 实例。当客户端使用这种方法创建一个 Service 实例时,该实例就是一个动态 Service 实例,这表示它是动态配置的,而不是像使用SEI的方法中那样是静态配置的。可以通过两种方式创建动态 百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读,免费范文网,提供经典小说综合文库Web服务开发技术-实验指导书(7)在线全文阅读。
相关推荐: