JSR 181通过标准化一个易于学习且可以快速开发的Web服务简单编程模型,从而刺激了对Web服务的采用。一直以来,J2EE开发人员要开发和部署Web服 务就必须把握相当多的信息。通过使用J2SE 5.0中的新增注释功能,Java软件源代码可以使用JSR 181注释进行注释,从而声明式地定义所需的Web服务行为。这使开发人员可以将注重力集中在Web服务的应用逻辑上而无需担心复杂的API、协议和部署 描述符。
BEA官方网站有一篇“web服务元数据简介”,对理解JSR 181规范很有帮助。
这一节的例子和上一节的例子很相似,或者通过使用java注释,比上一节的POJO稍微复杂了一点。不是说JSR 181节省了很多的配置信息吗?鄙人认为可以从这个方面来理解,正常情况下,POJO假如配置到其他webservices框架下,比如axis2、Celtix、weblogic等容器中,必然需要编写适合这些容器的配置文件,以便这些容器能够识别这个POJO类是wenservices,并根据配置文件中的比如命名空间、参数类型、web服务的方法等信息提供web服务。而通过jsr 181规范中的定义可以自动识别这些信息,这样这些信息不必在每个容器中所配置,这些容器通过java注释就可以得到这些信息,所以说jsr181在这方面进行了简化。XFire通过services.XML文件得到哪个类被定义为web服务, XFire可以通过java注释来获取web服务的相关信息。
好了,让我们先写一个带jsr181注释的java文件:
package com.kuaff.xfire.samples;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
@WebService(name="MathService",serviceName="MathService",targetNamespace="http://www.kuaff.com/xfire/samples/MathService")
public class MathService
{
@WebMethod
@WebResult
public long add(@WebParam int p1, @WebParam int p2)
{
return p1 + p2;
}
}
这个例子中将MathService定义为web服务程序,服务名为MathService,命名空间为MathService,将add方法定义为web服务的方法,带有两个参数。