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

2019-04-02 20:28

78. de.setValue(\79. throw new SOAPFaultException(sf);

第七步:

在Java SE6.0中,一个很方便的发布WEB服务的方法是使用javax.xml.ws. Endpoint类。使用该类发布一个WEB服务非常简单。只要调用Endpoint#publish方法并提供一个服务端点的URL地址即可。

在WSServer项目中新建一个server.wsdl包并将RequestOrder.wsdl放入其中。新建一个server.main包并创建Main类。其代码如下所示:

16. public class Main {

17. public static void main(String[] args) { 18. 19. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 35. 36. } 37. }

ArrayList metadata = new ArrayList(); Source wsdlSource = new StreamSource(wsdlStream); String wsdlId = wsdlURL.toExternalForm(); wsdlSource.setSystemId(wsdlId);

metadata.add(wsdlSource); endpoint.setMetadata(metadata);

System.out.println(\}

Endpoint endpoint = Endpoint.create(new RequestOrderImp()); InputStream wsdlStream = Main.class.getClassLoader() URL wsdlURL = Main.class.getClassLoader().getResource(

\

throw new RuntimeException(\

if (wsdlStream == null) {

20. .getResourceAsStream(\

34. endpoint.publish(\

这样就把这个服务发布在http://localhost:8088/RequestOrderService上。在发布服务之间,首先设置了Endpoint对象的元数据。Endpoint对象的元数据可以包括一组XML模式与WSDL。设置了元数据之后,JAX-WS根据标注创建WSDL文件时会尽可能使用提供的元数据而不是自己重新生成。但是,即使设置了元数据,也不能保证程序会精确的复制它。

第八步:

运行WSServer项目,打开浏览器,输入地址http://localhost:8088/ RequestOrderService?wsdl并打开,可以看到已发布服务的WSDL。如图所示。

二、不使用JAXB来实现服务提供者与XML处理

有的时候,可能不想使用JAXB生成类,而是希望可以直接使用XML来实现业务逻辑。XML处理可以提高性能,特别是使用XMLT样式表来实现业务逻辑的时候。另外,如果使用SEI,当WSDL发生变动,哪怕这种变动非常微小而不影响业务逻辑,也需要重新生成SEI并修改代码。而使用XML可以对WSDL的变化有一定程序的隔离。

为了部署可以直接处理XML消息的WEB服务,要使用javax.xml.ws.provider接口。这个接口中定义了一个方法:

T invoke(T request) 在这个方法中,参数类型T代表消息或消息的有效负载。Provider支持两种方式:Message和Message Payload模式。在Message模式中,服务实现Bean直接处理特定协议的消息结构,比如当用于SOAP协议绑定时,invoke要处理整个SOAP消息。而在Message Payload模式中,服务实现负载只需处理消息的负载,即SOAP的消息体

(soap:body)。

直接处理XML消息的RequestOrder服务实现如下: 第一步:

在Eclipse中新建项目WSServerNoSEI。 第二步:

在包server.imp下新建类RequestOrderEndpoint。该类是接口Provider的一个实现。其类标注如下 :

50. @WebServiceProvider(serviceName = \51. portName = \

52. targetNamespace = \53. )

54.@ServiceMode(Service.Mode.PAYLOAD)

55.public class RequestOrderEndpoint implements Provider { 这两个标注说明这是一个服务实现Bean并且使用Message Payload模式。由于Provider的实现不是通过WSDL到JAVA的映射实现的,因此必须在@WebServiceProvider中通过wsdlLocation属性说明或在使用Endpoint发布的时候设置相应的元数据(本例采取的方法)。

在该类的invoke方法中,通过Dom方式组建了用作调用结果的SOAP文档(具体代码见附件)。从代码中可以看出,使用DOM API要比使用JAXB更加繁琐、容易出错。

将该服务实现Bean发布与使用SEI的方法相同,也是使用Endpoint#publish方法。

三、使用标注从Java开始开发

有的时候,企业内部可能已经有一些系统实现了所需要的业务逻辑,如果想把这些系统发布了WEB服务,首先可以考虑的一种方法是向原来的类中添加标注,使其与要发布的目标WSDL相符。这包括两个方面的内容:

1、 给业务逻辑实现类添加标注,使其与WSDL中wsdl:port的定义相一致。 2、 给业务逻辑中使用的实体类添加JAXB标注,使其与WSDL中wsdl:types中定义

的schema一致。

但是,很多情况下,这种方式是不可实现的,原因如下:

? 系统可能是一个第三方的程序包,无法修改,或者代码由其它部门开发,修改需要

的时间太长。

? 业务逻辑类的方法与wsdl:port中定义的wsdl:operation方法可能不能完全

一致。

? 实体类可能与WSDL中定义的模式差别太大,无法使用JAXB标注实现。

对于业务逻辑实现类,如果可以通过添加标注的方法实现。则首先考虑向类中添加标注实现。如果不能通过这种方法实现的话,可以给已有的业务逻辑实现类添加适配器层,对外开放WSDL中定义的接口,在收到请求时,调用业务逻辑实现类的方法来完成业务逻辑。 对于实体类,也首先考虑直接添加标注的方法,如果不能实现的话,可以考虑以下方法:

? 添加适配层,将参数从WSDL中schema映射类转换为程序内部的实体类并调用业

务实现方法,然后将调用返回值转换为WSDL中schema对应类。

? 使用XSLT。将收到的SOAP消息中的请求参数XML片段使XLST转换到与业务实

体类相对应的XML格式,然后进行拆收和业务逻辑方法调用,最后再将返回值封送的XML片段使用XLST转换到与WSDL中schema定义相符的格式并传回客户

端。这种方法要求可以访问并修改原代码以添加标注。 现在来看一个可以直接添加标注的例子: 第一步:

将附件中的OriServiceImplement项目导入到Eclipse中,现在已有的业务逻辑的实现位于services包中(省略了异常处理),它所访问的实体类位于beans包中。它们都还没有添加标注。

第二步:

首先给beans包中的实体类添加标注,使其与要发布的WEB服务的WSDL中定义的schema相对应。这里来说明OrderType类的映射:

11. @XmlAccessorType(XmlAccessType.FIELD)

12. @XmlType(namespace = \

13. @XmlRootElement(name = \14. public class OrderType { 15. 16. 17. 18. 19. 20. 21.

protected String OrderKey; protected Header OrderHeader;

@XmlElementWrapper(name = \protected List item;

@XmlJavaTypeAdapter(WrapCcardAdapter.class) protected MyCreditCard orderCcard; protected String orderText;

OrderType类中使用了两个未介绍的标注:@XmlElementWrapper和@XmlJavaTypeAdapter。

@XmlElementWrapper用于给一个集合类的属性添加一个包装器对象,从而在生成的XML中,集合类属性对应的元素列表是作为包装器对象对应的元素的子元素出现,而是作为其所在Java类对应的元素的子元素出现。在该类对应的XML片段中,包装器元素OrderItems是Order元素的子元素,而OrderItems的子元素是MyItem对应的BUSOBJ_ITEM类型XML元素的一个列表。如果不使用该标注类而要达到相同效果的话,就要增加一个只有一个List属性的OrderItems类。

@XmlJavaTypeAdapter是JAXB中一个强有力的工具,它使得我们可以通过手工编码的方式,来完成标准映射无法实现的映射。在这个例子中,是使用该方法为类型为MyCreditCard类型的orderCcard属性添加了一个OrderCcard类型的包装对象(@XmlElementWrapper标注只能用于集合对象)。该标注的属性指定了个映射类:WrapCcardAdapter。该类的内容如下:

5. public class WrapCcardAdapter extends 6. 7.

8. public MyCreditCard unmarshal(MyCreditCard.OrderCcard wrapper) 9. 10. 11. } 12.

13. public MyCreditCard.OrderCcard marshal(MyCreditCard ccard) throws Exception

{ 14.

MyCreditCard.OrderCcard wrapper = new MyCreditCard.OrderCcard();

throws Exception { return wrapper.ccard;

XmlAdapter {

15. 16. 17. } 18. }

wrapper.ccard = ccard; return wrapper;

可以看出WrapCcardAdapter扩展自抽象类:

Javax.xml.bind.annotation.adapters.XmlAdapter

XmlAdapter类引用了两个类型参数,一个是JAXB不知道如何处理的类型(BoundType),另外一个是JAXB知道如何处理的类型(ValueType),在封送过程中,JAXB首先将BoundType封送到ValueType,然后继续对ValueType进行封送。在拆收的过程中,JAXB会首先将XML拆收到ValueType,然后再继续对BoundType进行拆收。这两个过程分别对应着XmlAdapter类中的两个抽象方法: marshal()

unmarshal() 在该例中,marshal新建一个包装对象并且设置其与原对象的包含关系,在unmarshal方法中,直接取出包装对象中的原对象并返回。

第三步:

由于要采用的是document/literal/wrapped样式的WSDL,所以要创建请求和响应的包装器类。新建包server.sei并新建类MyRequestOrder以及MyRequestOrderResponse,分别向其中添加与请求参数与响应参数相对应的属性并完成映射。

第四步:

给RequestOrderService类添加标注,使其成为一个WEB服务。添加标注后该类的内容如下:

22. @WebService(serviceName = \

= \

23. public class RequestOrderService { 24. @WebMethod

25. @WebResult(name = \targetNamespace = \26. @RequestWrapper(localName = \

\27. @ResponseWrapper(localName = \

\\28. public OrderType userRequestOrders( 29. 30. 31. 32. 33. 34.

@WebParam(name = \\String custNum,

@WebParam(name = \\String poNum,

@WebParam(name = \\MyCreditCard card,


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

下一篇:肌肉练习题

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

马上注册会员

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