【原创】xfire开发web service实例

本篇中，你将了解到：
       如何将一个普通的Java文件转换为一个web服务，
       services.xml文件是如何定义的，
       如何发布这个web服务,
       如何获得这个服务的WSDL,
      如何创建Client代码,
       如何测试这个web服务.

本文从最基础的javaProMath用例开始，介绍如何利用xfire开发web service应用，以后就可以开发复杂的web service应用了。 

开发环境：eclipse3.5+tomcat5.5.9+xfire1.2.6

xfire开发web service实例分两步进行：
一、配置XFire 1.2.6:http://rxxluowei.iteye.com/admin/blogs/660702
二、开发web service

1、首先，打开Eclipse，创建一个普通的Java工程，这里我们命名为“javaProMath”。（该工程在我机器上的路径：D:\workspace\javaProMath，为方便后文叙述，特此列出）
注意，要导入所需jar包，jar包的获取见如下第2步。

2、将xfire所需的jar包加入到工程所需的类库引用中。
2.1jar包的获取：
方法一：在xfire官方网站http://xfire.codehaus.org/Download下载,选择xfire-distribution-1.2.6.zip，所需jar包包括解压后的xfire-1.2.6\下的xfire-all-1.2.6.jar和xfire-1.2.6\lib目录下的所有*.jar文件
2.2jar包的导入
将按上述步骤获取的jar包全部拷贝到D:\Web site page\apache-tomcat-6.0.26\webapps\xfire\WEB-INF\lib

3、创建一个简单的Java文件，这个Java文件简单到只提供一个add方法：

package com.kuaff.xfire.samples;

public class MathService 
{
	public long add(int p1, int p2)
	{
		return p1 + p2;
	}

}

将将编译后的MathService.class文件和service.xml文件部署到tomcat中，即将这两个文件放到如下位置：

D:\Web site page\apache-tomcat-6.0.26\webapps\xfire\WEB-INF\classes\META-INF\xfire\services.xml;

D:\Web site page\apache-tomcat-6.0.26\webapps\xfire\WEB-INF\classes\com\liuxiang\xfire\HelloService.class;
【注：我的tomcat安装在D:\Web site page\apache-tomcat-6.0.26\】

4、在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.sample.MathService.

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

5、将工程bin目录下的所有文件复制到第一节配置的tomcat/webapps/xfire/WEB-INF/classes文件夹下，
6、启动tomcat,你就可以检查这个web服务是否发布成功了。
打开浏览器，在地址栏中输入http://localhost:8080/xfire/services/,正常情况下该浏览器应该显示下图所示的页面

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

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

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

参考文献：
http://tech.it168.com/j/2007-12-21/200712211525073.shtml

----------------------------------------------------------------------------------------------------------------------------------------
接下来的问题就是如何开发一个client，来消费（使用、调用）这个web服务，我们将在下一篇中讨论，欢迎关注。