JDK6的新特性之十一:更简单,更强大的JAX-WS

JDK6的新特性之十一:更简单,更强大的JAX-WS

JAX-WS2.0的来历

--------------------------------------------------------------------------------
JAX-WS(JSR-224)是JavaArchitectureforXMLWebServices的缩写,简单说就是一种用Java和XML开发WebServices应用程序的框架,目前版本是2.0,它是JAX-RPC1.1的后续版本,J2EE1.4带的就是JAX-RPC1.1,而JavaEE5里面包括了JAX-WS2.0,但为了向后兼容,仍然支持JAX-RPC.现在,SUN又把JAX-WS直接放到了JavaSE6里面,由于JAX-WS会用到CommonAnnotation(JSR250),JavaWebServicesMetadata(JSR181),JAXB2(JSR222),StAX(JSR173),所以SUN也必须把后几个原属于JavaEE范畴的Components下放到JavaSE,现在我们可以清楚地理解了为什么Sun要把这些看似跟JavaSE没有关系的Components放进来,终极目的就是要在JavaSE里面支持WebServices.

JAX-WS2.0的架构

--------------------------------------------------------------------------------
JAX-WS不是一个孤立的框架,它依赖于众多其他的规范,本质上它由以下几部分组成
1.用来开发WebServices的JavaAPI
2.用来处理Marshal/Unmarshal的XMLBinding机制,JAX-WS2.0用JAXB2来处理JavaObject与XML之间的映射,Marshalling就是把JavaObject映射到XML,Unmarshalling则是把XML映射到JavaObject.之所以要做JavaObject与XML的映射,是因为最终作为方法参数和返回值的JavaObject要通过网络传输协议(一般是SOAP)传送,这就要求必须对JavaObject做类似序列化和反序列化的工作,在SOAP中就是要用XML来表示Javaobject的内部状态
3.众多元数据(Annotations)会被JAX-WS用来描述WebServices的相关类,包括CommonAnnotations,WebServicesMetadata,JAXB2的元数据和JAX-WS2.0规范自己的元数据.
4.AnnotationProcessingTool(APT)是JAX-WS重要的组成部分,由于JAX-WS2.0规范用到很多元数据,所以需要APT来处理众多的Annotations.在<JDK_HOME>/bin下有两个命令wsgen和wsimport,就是用到APT和CompilerAPI来处理碰到的Annotations,wsgen可以为WebServicesProvider产生并编译必要的帮助类和相关支持文件,wsimport以WSDL作为输入为WebServiceConsumer产生并编译必要的帮助类和相关支持文件.
5.JAX-WS还包括JAX-WSRuntime与应用服务器和工具之间的契约关系

JAX-WS2.0的编程模型

--------------------------------------------------------------------------------
现在用JAX-WS2.0来编写WebServices非常简单,不像JAX-RPC,JAX-WS可以把任意POJO暴露为WebServices,服务类不需要实现接口,服务方法也没有必要抛出RMI异常.下面介绍在JDK6环境下用JAX-WS2.0开发和测试WebServices的步骤
1.编写服务类,并用WebServicesMetadata(JSR-181)标注这个服务类,我用我的另一篇BlogJDK6的新特性之十:Web服务元数据中的WSProvider类作为服务类的例子,在此我重复贴一下WSProvider类的源代码:
/**
*@authorchinajash
*/
@WebService(targetNamespace="http://blog.youkuaiyun.com/chinajash",serviceName="HelloService")
publicclassWSProvider{
@WebResult(name="Greetings")//自定义该方法返回值在WSDL中相关的描述
@WebMethod
publicStringsayHi(@WebParam(name="MyName")Stringname){
return"Hi,"+name;//@WebParam是自定义参数name在WSDL中相关的描述
}
@Oneway//表明该服务方法是单向的,既没有返回值,也不应该声明检查异常
@WebMethod(action="printSystemTime",operationName="printSystemTime")//自定义该方法在WSDL中相关的描述
publicvoidprintTime(){
System.out.println(System.currentTimeMillis());
}
publicstaticvoidmain(String[]args){
ThreadwsPublisher=newThread(newWSPublisher());
wsPublisher.start();
}
privatestaticclassWSPublisherimplementsRunnable{
publicvoidrun(){
//发布WSProvider到http://localhost:8888/chinajash/WSProvider这个地址,之前必须调用wsgen命令
//生成服务类WSProvider的支持类,命令如下:
//wsgen-cp.WebServices.WSProvider
Endpoint.publish("http://localhost:8888/chinajash/WSProvider",newWSProvider());
}
}
}
2.用wsgen生成上面服务类的必要的帮助类,然后调用用EndPoint类的静态方法publish发布服务类(步骤请参考我的另一篇BlogJDK6的新特性之十:Web服务元数据),我在这里是将服务类发布到http://localhost:8888/chinajash/WSProvider
3.用wsimport为服务消费者(也就是服务的客户端)生成必要的帮助类,命令如下:
wsimporthttp://localhost:8888/chinajash/WSProvider?wsdl
这会在<当前目录>/net/csdn/blog/chinajash下生成客户端的帮助类,在这个例子中会生成7个类
HelloService.class
ObjectFactory.class
package-info.class
PrintSystemTime.class
SayHi.class
SayHiResponse.class
WSProvider.class
4.在客户端用下面代码即可调用步骤1定义的WebService
HelloServicehs=newHelloService();
WSProviderws=hs.getWSProviderPort();
System.out.println(ws.sayHi("chinajash"));
ws.printSystemTime();
调用上述代码后客户端控制台输出
hi,chinajash
服务端控制台输出服务器当前系统时间