服务热线:13616026886

技术文档 欢迎使用技术文档,我们为你提供从新手到专业开发者的所有资源,你也可以通过它日益精进

位置:首页 > 技术文档 > JAVA > 新手入门 > 基础入门 > 查看文档

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

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

 

首先打开eclipse,创建一个普通的java工程,将xfire所需的jarxfirejar加入到工程所需的类库引用中。创建一个简单的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/,正常情况下应该浏览器应该显示类似下图所示的页面。

[webservices开发]使用xfire开发一个简单的web服务(图一)

 

[webservices开发]使用xfire开发一个简单的web服务(图二)

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

 

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

[webservices开发]使用xfire开发一个简单的web服务(图三)

 

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

 

下面一个问题就是如何开发一个client,来消费(使用)这个web服务。

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

 

wsgenxfire提供的一个ant tasktask的申明如下:

<taskdef name="wsgen" classname="org.codehaus.xfire.gen.wsgentask" classpathref="xfirejar路径" />

 

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

<wsgen outputdirectory="client" wsdl="mathservice.wsdl" package="com.kuaff.xfire.samples" />

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

 

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

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

 

这段ant脚本将创建三个文件:mathserviceporttypemathserviceimplmathserviceclientmathserviceporttype是这个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);

    }

}

扫描关注微信公众号