Web服务开发技术-实验指导书(5)

2019-04-02 20:28

其中-d选项指明创建的class文件目录,-s指明源代码文件目录,-p指明所创建的类所在的包,最后的输入参数指明的是要创建的Web服务的WSDL地址。

第三步:

打开目录wsdl/src/server/sei,可以看到JAX-WS共生成了13个文件。这些文件包括以下几个部分:

? Service Endpoint Interface (SEI)类:RequestOrderPort.java ? Service类:RequestOrderService.java ? 从wsdl:fault映射类:InputFault.java ? 从XML schema映射而来的Java类:其余的类

其中上面第四点提到的从XML schema到Java类的映射是JAX-WX中很重要JAXB2.0(Java XML Binding)标准。由于在SOA程序中,WEB服务调用一般是通过SOAP请求来实现的。由于SOAP是一种基于XML的协议,因此在JAX-WS,客户端要想调用WEB服务,就要首先将调用WEB服务所用到的参数从Java程序中的对象转换成XML片段,而服务器端为了在Java程序中处理这些参数,就要将收到的XML片段转换成Java对象。在JAXB2.0中,这两个过程分别叫做封送(marshalling)和拆收(unmarshalling)。同样,服务器端要想将处理的结果返回给客户端,也要经历Java对象—>XML片段—>Java对象的过程。JAXB2.0提供了一种方便快速的将JAVA类与XML Schema类型绑定的方法。它通过标注将Java类与对应的XML Schema绑定在一起。

WSDL文件与生成的Java类之间的具体珠对应关系如下:

1、 wsdl:portType映射为了服务端点接口(SEI)——RequestOrderPort。 2、 名为requestOrder的wsdl:operation被映射到了具体有相同名称的SEI方

法。

3、 wsdl:input消息决定了requestOrder方法的参数。可以看到,这个消息

(req:request)只有一个单独的wsdl:part,其中的包装器req:requestOrder是在wsdl:types区段中定义的。该包装器元素的子元素(即CUST_NO、PURCH_ORDER_NO、ccard、item)定义了方法的参数。这里要注意的是,由于item元素的maxOccurs > 1,所以它将被映射为列表(List)类型。

4、 与上面相似,wsdl:output消息决定响应类型为OrderType

5、 按照JAX-WS映射的定义,每一个wsdl:fault都映射为一个可抛出的异常。所

以,这里单一的wsdl:fault映射为requestOrder方法中声明的―throws InputFault‖语句

6、 wsdl:fault中引用的wsdl:message被映射为继承自

java.lang.Exception的一个子类。此处名为inputFault的wsdl:message映射为InputFault类,该类是fault bean的一个包装器异常类。 7、 wsdl:fault元素引用的只带有一个单独part(wsdl:part)的wsdl:message

元素。该part元素引用的全局元素声明被映射为一个JavaBean,JAX-WS将该JavaBean称为fault bean。在这个示例中,fault:inputMessageValidationFault元素映射到名为inputMessageValidationFault的fault bean。这样的fault bean是包装器类封装的属性。

8、 wsdl:types中的元素被映射到一些Java Bean类,具体映射过程后面将详细说

明。

SEI的映射中使用了标注来确定如何将方法调用封送为SOAP请求消息,以及如何将

SOAP响应消息拆收为方法的返回值类型的实例。本示例中SEI类如下所示:

20.@WebService(name = \

\21.@XmlSeeAlso({

22. ObjectFactory.class 23.})

24.public interface RequestOrderPort {

……(省略某些注释) 37.@WebMethod

38.@WebResult(name = \

\

39.@RequestWrapper(localName=\

\\

40.@ResponseWrapper(localName = \

\\

41.public OrderType requestOrder(

42. @WebParam(name = \

\

43. String custNO, 44.

@WebParam(name = \\

45. String purchORDNO,

46. @WebParam(name = \

\

47. BUSOBJCCARD ccard,

48. @WebParam(name = \targetNamespace = \49. List item) 50. throws InputFault 51. ; 52. 53.}

其中所用到的标注描述如下: 标注 @WebService @WebMethod @WebResult 用途 表示某个Java类要实现一个Web服务,或者表示某个Java接口定义了一个Web服务接口。 表示相关的方法是从wsdl:operation映射而来的。 表示将SEI方法的返回值关联到某个wsdl:part或wsdl:part元素的定义。文档/字面值包装方式的Web服务中,@WebResult标注将SEI方法的返回值映射为响应包装器元素的对应子元素。 用于标识请求包装器bean,这是一个JAXB生成的类,它将映射到请求消息的包装器元素。 @RequestWrapper @ResponseWrapper 用于标识响应包装器bean,这是一个JAXB生成的类,它将映射到响应消息的包装器元素。 @WebParam 将SEI方法的参数与特定的wsdl:part(rpc方式)或者特定的wsdl:part元素定义的包装器子元素相关联(document方式)。在任何一种情况下,@WebParam标注都是将参数的Java表示与WSDL/SOAP的对应表示关联起来。 wsdl:types中的元素与Java Bean类映射关系描述如下:

1、 生成的package-info.java定义了java包与目标命名空间的对应的关系,其中的

@javax.xml.bind.annotation.XmlSchema(namespace= \elementFormDefault=

javax.xml.bind.annotation.XmlNsForm.QUALIFIED) 其中的namespace属性将这个包映射命名空间http://www.example.com/oms,它通过elementFormDefault元素指定这个包的模式是限定的,这意味着这个包中所含的Java类的各属性在映射到模式单元定义时,元素应该具有命名空间的限定。 2、 输入元素中,CUST_NO和PURCH_ORD_NO直接映射到java.lang.String。 3、 oms:BUSOBJ_CCARD映射到了BUSOBJCCARD类 4、 oms:BUSOBJ_ITEM映射到了BUSOBJITEM类。

5、 oms:Order映射到了OrderType类,由于在订单中订单条目可以出现多次,因此其

中的orderItems属性是一个包装类OrderItems的实例,OrderItems类中封装了BUSOBJITEM类的一个列表。

6、 req:requestOrder元素和req:requestOrderResponse包装器元素分别映射为

RequestOrder类和RequestOrderResponse类。

现在以RequestOrder类来说明JAXB标注的含义。首先,对于类的标注如下:

47. @XmlAccessorType(XmlAccessType.FIELD) 48. @XmlType(name = \49. \50. \51. \52. \53. })

54. @XmlRootElement(name = \\55. public class RequestOrder {

56. @XmlElement(name = \namespace = \

required = true)

57. protected String custno;

@XmlAccessorType指定该类的访问类型是字段(不需要getter/setter方法)还是属性(需要getter/setter)方法。该类中指定访问类型是字段,即每个非静态的、非transient的、未使用@XmlTransient标注的字段都会自动绑定到XML。

@XmlType标注用于将一或枚举类型映射到XML schema类型。在这个例子中,由于@XmlType.name为‖‖,因此会映射到XML中的一个匿名类型。@XmlType.propOrder定义的顺序对应于XML schema中的定义,指定子元素出现的顺序。

@XmlRootElement标注用于将一个类映射到一个全局元素的定义。全局元素的名称

由name属性决定,命名空间由namespace属性决定。

@XmlElement标注用于将一个类的属性或者字段映射到元素的子元素。其中name属性指定元素的名称,namespace属性指定子元素定义所属的命名空间,require属性指定该元素是否在父元素的子元素序列中必须出现。

另外,打开InputMessageValidationFaultType类,可以看到其定义如下:

27. @XmlAccessorType(XmlAccessType.FIELD)

28. @XmlType(name = \\

29. public class InputMessageValidationFaultType { 30.

31. @XmlAttribute

32. protected String msg;

该类使用@XmlAttribute标注将msg字段映射到父元素的一个属性而不是子元素。 以上只是对JAXB的简单介绍,如果想要详细的了解JAXB的话,可以参考JAXB 2.0的规范[JSR-222](在实验附件中)。

第四步:

打开Eclipse,新建项目WSServer,将生成的包server.sei拷贝到源文件夹。

第五步:

新建包server.imp并为RequestOrderPort SEI接口创建实现类RequestOrderImp.java。该类实现了业务方法

requestOrder(String,String,BUSOBJCCARD,List)。该方法使用JAXB生成的类来实现业务逻辑,代码如下:

45. // generate a psuedo-unique 10 digit order ID

46. String orderId = Long.toString((new Date()).getTime()); 47. orderId = orderId.substring(orderId.length() - 10); 48. OrderType response = new OrderType(); 49. response.setOrderKey(orderId); 50. // create OrderHeader

51. BUSOBJHEADER hdr = new BUSOBJHEADER(); 52. response.setOrderHeader(hdr); 53. hdr.setCUSTNO(custNum);

54. GregorianCalendar cal = new GregorianCalendar(); 55. hdr.setPURCHDATE(dateAsString(cal)); 56. cal.add(Calendar.DAY_OF_MONTH, 14); 57. hdr.setWARDELDATE(dateAsString(cal)); 58. if (poNum != null && poNum.length() > 0) { 59. 60. 62. 63. 64. 65. 66.

hdr.setPYMTMETH(\hdr.setPURCHORDNO(poNum); hdr.setPYMTMETH(\// OrderType.OrderCcard

OrderType.OrderCcard ordCcard = new OrderType.OrderCcard(); ordCcard.setCcard(ccard);

response.setOrderCcard(ordCcard);

61. } else {

第六步:

在业务逻辑的处理过程之中,经常会遇到坏的数据,这时就要向客户端返回一个SOAP报错消息,向客户端表明失败的原因。服务器端返回SOAP报错消息可以分为两种情况: 1、 已经映射到wsdl:fault消息的Java异常。在RequestOrder服务中定义了输入验

证错误InputFault:

63.

67.

2、 未被映射到wsdl:fault的异常。对于某些因无法预料的运行时错误而导致的异常,

则很可能没有相应的wsdl:fault消息,只能作为通用的的SOAP采取多种报错返回。 对于第一种情况,JAX-WS从WSDL到JAVA的映射可以将wsdl:fault消息绑定到java.lang.Exception的子类。当从WSDL生成SEI时,也会生成这些可被映射的。在运行时如果想返回这种SOAP错误,一种选择是直接抛出一个被映射的异常,JAX-WS运行时引擎可以自动的将其转换到相应的wsdl:fault消息,包装在SOAP消息体中并返回。例如可以这样处理输入参数异常:

31. InputMessageValidationFaultType ft = new InputMessageValidationFaultType(); 32. if (custNum == null) {

33. ft.setMsg(\34. 35. }

36. if (poNum == null && ccard == null) { 37. 38. 39. }

40. if (itemList == null || itemList.isEmpty()) { 41. 42. 43. }

ft.setMsg(\

throw new InputFault(\ft.setMsg(\

throw new InputFault(\throw new InputFault(\

对于第二种情况,可以通过构造类javax.xml.ws.soap.SOAPFaultException类的实例来实现。当在服务实现Bean中内部的抛出一个SOAPFaultException时,JAX-WS运行时引掣就将它转换成一个SOAP报错消息,并返回给客户端。例如,当信用卡过期的时候,可以用这种方法向客户端报错:

68. SOAPFactory fac = SOAPFactory.newInstance(); 69. SOAPFault sf = fac 70. .createFault(

71. \72. new QName(

73. \74. \

75. Detail d = sf.addDetail(); 76. DetailEntry de = d

77. addDetailEntry(new QName(\


Web服务开发技术-实验指导书(5).doc 将本文的Word文档下载到电脑 下载失败或者文档不完整,请联系客服人员解决!

下一篇:肌肉练习题

相关阅读
本类排行
× 注册会员免费下载(下载后可以自由复制和排版)

马上注册会员

注:下载文档有可能“只有目录或者内容不全”等情况,请下载之前注意辨别,如果您已付费且无法下载或内容有问题,请联系我们协助你处理。
微信: QQ: