在Eclipse上使用XFire开发WebService

终于，使用Java完成了一个WebService的例子，其中的一个非常小的问题，折腾了我将近一天的时间。下面给出步骤，说明在Java平台上如何开发WebService。

    采用的工具：Eclipse3.1.2 + Tomcat5.5 + XFire1.1 。使用XFire开发WebService应该说非常的容易，只需要按照下面例子的步骤来做：

（1）在Eclipse中新建一个dynamic Web Project ，假设名为XFireZhuweiTest。

（2）导入XFire用户库。该库中应包含xfire-1.1目录下的xfire-all-1.1.jar文件，以及xfire-1.1/lib目录下的所有文件。

（3）将上述的XFire用户库中的所有文件拷贝到XFireZhuweiTest项目的WebContent/WEB-INF/lib目录下。

（4）修改WebContent/WEB-INF/web.xml配置文件的内容，下面是修改后web.xml：

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
    <display-name>
    XFireZhuweiTest</display-name>
    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
        <welcome-file>default.html</welcome-file>
        <welcome-file>default.htm</welcome-file>
        <welcome-file>default.jsp</welcome-file>
    </welcome-file-list>
    
    <servlet>
         <servlet-name>XFireServlet</servlet-name>
         <servlet-class>
                 org.codehaus.xfire.transport.http.XFireConfigurableServlet
         </servlet-class>
     </servlet>
     
     <servlet-mapping>
         <servlet-name>XFireServlet</servlet-name>
         <url-pattern>/servlet/XFireServlet/*</url-pattern>
     </servlet-mapping>
 
     <servlet-mapping>
         <servlet-name>XFireServlet</servlet-name>
          <url-pattern>/services/*</url-pattern>
     </servlet-mapping>
    
</web-app>

    web.xml中添加的servlet映射表明，所有匹配“/services/*”的url请求全部交给org.codehaus.xfire.transport.http.XFireConfigurableServlet来处理。

（5）编写需要发布为WebService的Java类，这个例子中是一个非常简单的MathService.java。

package com.zhuweisky.xfireDemo;
public class MathService 
{
    public int Add(int a ,int b)
    {
        return a+b ;
    }
}

（6）在WebContent/META-INF目录下新建xfire文件夹，然后在xfire目录下添加一个XFire使用的配置文件services.xml，该配置文件中的内容反映了要将哪些java类发布为web服务。本例中的services.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://xfire.codehaus.org/config/1.0">
    <service>
      <name>MathService</name>
      <namespace>http://com.zhuweisky.xfireDemo/MathService</namespace>
      <serviceClass>com.zhuweisky.xfireDemo.MathService</serviceClass>
    </service>
</beans>

    XFire会借助Spring来解析services.xml，从中提取需要发布为WebService的配置信息。

    很多文章介绍到这里就完了，然而当我按照他们所说的启动WebService ，然后通过http://localhost:8080/XFireZhuweiTest/services/MathService?wsdl 来访问服务描述时，却抛出了异常，说services.xml文件不存在－－
“org.springframework.beans.factory.BeanDefinitionStoreException: IOException parsing XML document from class path resource [META-INF/xfire/services.xml]; nested exception is java.io.FileNotFoundException: class path resource [META-INF/xfire/services.xml] cannot be opened because it does not exist”。   
注意：根据我的测试，单单剪切META-INF文件夹还是不行，必须在SRC中新建，然后编译之后在classes下生成
（7）非常关键的一点，就是这个小难题花费了我将近一天的时间。
    在WebContent/WEB-INF目录下新建classes文件夹，然后需要将WebContent下的整个META-INF文件夹剪切到新建的classes文件夹下。
    到这里，项目的完整目录结构如下：



（8）在Package Explorer中选中XFireZhuweiTest项目，右键->Run As ->Run On Server，关联到你机器上的TomCat，然后会启动Tomcat，以启动web服务。（注意，在进行此步骤之前，请先停止TomCat） 

（9）在IE中输入 http://localhost:8080/XFireZhuweiTest/services/MathService?wsdl 会得到正确的web服务描述文档。

（10）测试刚发布的webService。我使用C#动态调用Web服务：

                //C#
                string url = "http://localhost:8080/XFireZhuweiTest/services/MathService" ;
                object[] args ={1,2} ;
                object result = ESFramework.WebService.WebServiceHelper.InvokeWebService(url ,"Add" ,args) ;
                MessageBox.Show(result.ToString());

 

（关于C#动态调用Web服务，请参见这里）

    执行后，弹出对话框，显示结果是3。 

 

总结

1)     需要附加的JAR类库jdom.jar, wsdl4j.jar, xbean-spring-2.2.jar, xfire-all-1.1.jar

2)     若想在Eclipse做XFire的客户端测试，可以参照用<<xfire的Eclipse Plugin生成web服务的客户端.doc>>一文