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

转载

mob604756e80bb7 2012-02-03 11:50:00

文章标签 web服务 java文件客户端 jar xml文件 文章分类 代码人生

在这一节，你将了解到如何将一个普通的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文件，文件内容为：

<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/，正常情况下应该浏览器应该显示类似下图所示的页面。

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

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

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

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

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

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

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

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);

}