【JavaEE】经典JAVA EE企业应用实战-读书笔记20

@WebMethod用于修饰EJB Bean实现类的方法

使用该注解的最常用功能是将Bean实现类中某个方法排除在WebService之外。如果不使用该注解修饰，在默认情况下，EJB容器会将Bean实现类中所有方法暴露成WebService。

WebService经常与SOA一起被提起，SOA即Service Orient Architecture，也就是面向服务的结构，而WebService通常被作为SOA的实现技术。WebService负责把底层多个细粒度的方法进行包装、组合，然后包装成粗粒度的服务对外提供。SOA应用内部以低耦合、面向服务的方式进行通信，这就是SOA的基本思想。

属性说明

1）exclude，非必须，指定是否将该方法排除在WebService之外

2）action，非必须，指定WSDL中的SOAPAction，默认为空

3）operationName，非必须，指定该WebService操作的名称，默认与方法名相同

@Stateless@WebService(name = "person",         serviceName = "personWS",         portName = "personPort",         targetNamespace = "http://www.kingdz.org")public class PersonServiceBean implements PerspmService {@Override@WebMethod(operationName = "sayHello", action = "http://www.kingdz.org/greet")public String hello(String name, String age) {return name + age;}@Override@WebMethod(exclude = true)public long test() {return Math.round(Math.random() * 100);}}

部署后的部分WSDL

 <portType name='person'>  <operation name='sayHello' parameterOrder='sayHello'>   <input message='tns:person_sayHello'></input>   <output message='tns:person_sayHelloResponse'></output>  </operation> </portType> <binding name='personBinding' type='tns:person'>  <soap:binding style='document' transport='http://schemas.xmlsoap.org/soap/http'/>  <operation name='sayHello'>   <soap:operation soapAction='http://www.kingdz.org/greet'/>   <input>    <soap:body use='literal'/>   </input>   <output>    <soap:body use='literal'/>   </output>  </operation> </binding>

 

使用@SOAPBing指定WebService风格

JAX-WS2.0不仅支持面向RPC的WebSe，也支持面向文档的WebService。

属性说明

1）style，非必须，指定WebService风格，支持两个属性值

a）SOAPBingding.Style.DOCUMENT：使用面向文档的WebService，默认值

b）SOAPBingding.Style.RPC：使用面向RPC的WebService

2）use，非必须，指定SOAP消息风格，支持两个属性值

a）SOAPBingding.Use.LITERAL：使用字面风格的SOAP消息。这是默认值。如果WebService服务器端和客户端不在一起开发，就应该使用这种风格的消息

b）SOAPBingding.Use.ENCODED：使用SOAP编码风格的SOAP消息。可能导致WebService互操作方面的问题，应尽量少使用这种风格的消息

3）parameterStyle：非必须，指定调用WebService操作的参数风格，支持两个属性值

a）SOAPBingding.ParamterStyle.WRAPPED：使用包装后的参数，默认值

b）SOAPBingding.ParamterStyle.BARE：使用未经包装的参数

注意：虽然use属性值可以为SOAPBingding.Use.ENCODED，但实际上该属性值指定为SOAP编码风格的消息可能并不实用，在WebLogic中会忽略该属性值，在JBoss服务器中会直接不支持这种风格的SOAP消息。

@Stateless@WebService(    name = "person",     serviceName = "personWS",     portName = "personPort",     targetNamespace = "http://www.kingdz.org")@SOAPBinding(    style = SOAPBinding.Style.RPC,     use = SOAPBinding.Use.ENCODED)public class PersonServiceBean implements PerspmService {    ...}

上面的类部署在JBoss中会直接提示错误。

SOAP encoding is not supported for JSR-181 deployments

 

使用@WebParam

该注解用于定义WebService操作的参数风格，该注解通常与@WebMethod一起使用

属性说明

1）header，非必须，指定是否从消息头中提取消息。

2）mode，非必须，指定参数的传递模式

a）WebParam.Mode.IN：指定使用传入参数的模式

b）WebParam.Mode.OUT：指定使用传出参数的模式

c）WebParam.Mode.INOUT：指定使用传入、传出参数的模式

3）name，非必须，指定该WSDL中message元素的name属性值，没有指定该属性值，系统自动生成的name属性值与该形参名相同

4）targetNamespace，非必须，指定消息部分的目标命名空间。如果没有指定属性，默认使用与WebService相同的命名空间

例如

public String hello(@WebParam(    name=”somebd”,    targetNamespace=”http://blog.kingdz.org”)Person person){    ...}

使用@WebResult

@WebResult与@WebParam十分相似，区别在于@WebResult用于定制返回值，因此比@WebParam少支持一个属性：mode。

另外该注解用于修饰Bean方法本身

@Override@WebMethod(operationName = "sayHello", action = "http://www.kingdz.org/greet")@WebResult(name="helloResult",targetNamespace="http://www.hehe.org")public String hello(@WebParam(name = "somebd", targetNamespace = "http://blog.kingdz.org") Person person) {return person.getName();}

 

客户端调用WebService

以Java作为编程语言，借助于CXF框架的支持来调用EJB所提供的WebService操作。此处采用动态客户端调用——客户端无需服务器端的任何东西，只要能访问远程WebService的WSDL文档即可。

这里借助CXF来开发客户端

使用cxf需要借助wsdl2java工具

wsdl2java http://127.0.0.1:8080/Hello/PersonServiceBean?wsdl

这样会生成org的文件夹，包含了大量的Java源文件，是开发动态客户端的基础

public static void main(String[] args) {PersonWS service = new PersonWS();Person pws = service.getPersonPort();Person_Type person = new Person_Type();person.setName("kingdz");person.setAge(20);SayHello sh = new SayHello();sh.setSomebd(person);System.out.println(pws.sayHello(sh).getHelloResult());}

运行，输出kingdz