[webservices开发]使用XFire开发一个简单的web服务

在这一节，你将了解到如何将一个普通的java文件转换为一个web服务，services.xml文件是如何定义的，如何发布这个web服务、如何获得这个服务的WSDL、如何创建Client代码、如何测试这个web服务。

 

首先打开Eclipse，创建一个普通的java工程，将xfire所需的jar和xfire的jar加入到工程所需的类库引用中。创建一个简单的java文件，这个java文件简单到只提供一个add方法。

package com.kuaff.xfire.samples; public class MathService {     public long add(int p1, int p2)     {         return p1 + p2;     } }

 

在src目录下创建META-INF/xfire目录，然后在META-INF/xfire目录下创建services.xml文件，文件内容为：

<beans xmlns="http://xfire.codehaus.org/config/1.0">   <service>     <name>MathService</name>     <namespace>http://www.kuaff.com/xfire/samples/MathService</namespace>     <serviceClass>com.kuaff.xfire.samples.MathService</serviceClass>   </service> </beans>

这个文档定义了你要发布的web服务，这个定义了一个名为MathService的服务，服务类为com.kuaff.xfire.samples.MathService。

 

这样我们的一个简单的web服务就开发完成了，下面就要把它发布出去。

 

将工程bin目录下的所有的文件复制到第一节中配置的tomcat/webapps/xfire/WEB-INF/classes文件夹下，启动tomcat，你就可以检查这个web服务是否发布成功了。

打开浏览器，在浏览器地址栏中输入http://localhost:8080/xfire/services/，正常情况下应该浏览器应该显示类似下图所示的页面。

<!--[if !vml]--><!--[endif]-->

 

<!--[if !vml]--><!--[endif]-->

  注意：请在浏览器中输入http://localhost:8080/xfire/services/而不是http://localhost:8080/xfire/services，虽然两者显示的页面相同，但是点击页面上的链接，后者的链接会出错，因为后者后面少加了一个“/”。

 

点击[wsdl]链接，可以查看这个web服务的wsdl文档。

<!--[if !vml]--><!--[endif]-->

 

如果在你的机器上的显示如上面所示，则说明你的这个web服务发布成功，可以正常提供基于http的web服务。

 

下面一个问题就是如何开发一个Client，来消费（使用）这个web服务。

XFire、Axis、asp.net以及其它的一些商业产品都提供了根据wsdl文档创建客户端代码的工具。这里采用Xfire提供的wsgen工具来创建客户端的访问代码。

 

Wsgen是xfire提供的一个ant task，task的申明如下：

<taskdef name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask" classpathref="xfire的jar路径" />

 

这样，就可以在build.xml文件中使用这个task：

<wsgen outputDirectory="client" wsdl="MathService.wsdl" package="com.kuaff.xfire.samples" />

outputDirectory属性定义创建的代码所在的文件夹，wsdl是web服务的wsdl文件，package代表创建的代码的packege。还可以通过binding属性制定bind类型：jaxb或者是xmlbeans，

 

这样，就会在client文件夹下创建多个java文件，这些文件提供了访问web服务的方法。

在这里声明一点，创建的代码大量的使用了java注释，这个JSE5中提供的新特性，所以你需要使用JSE5编译，Eclipse也必须要3.1以上的版本。

 

这段ant脚本将创建三个文件：MathServicePortType、MathServiceImpl和MathServiceClient。MathServicePortType是这个web服务的客户端接口存根、MathServiceImpl实现了这个接口。MathServiceClient封装了访问这个web服务的方法。

最后，你可以创建一个单元测试类，用来测试这个客户端类。这个类的内容如下：

package com.kuaff.xfire.samples; import junit.framework.TestCase; public class MathServiceClientTest extends TestCase {     public void testAdd()     {         MathServiceClient client = new MathServiceClient();         MathServicePortType ms = client.getMathServiceHttpPort();         long result = ms.add(10, 20);         assertEquals(result, 30);     } }