使用xfire开发jsr181风格的web服务

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服务的方法，带有两个参数。

 

修改services.xml文件，修改完毕后的内容如下：

<beans xmlns="http://xfire.codehaus.org/config/1.0">

  <service>

    <serviceClass>com.kuaff.xfire.samples.MathService</serviceClass>

    <serviceFactory>jsr181</serviceFactory>

  </service>

</beans>

 

在这个配置文件中，你只需指定serviceClass和serviceFactory即可，XFire会根据注释获取这个web服务的元数据。