在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”。  

（7）非常关键的一点，就是这个小难题花费了我将近一天的时间。
    在WebContent/WEB-INF目录下新建classes文件夹，然后需要将WebContent下的整个META-INF文件夹剪切到新建的classes文件夹下。
    到这里，项目的完整目录结构如下：



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

备注：

javax.servlet.ServletException: Error occured during request processing: Provider org.apache.xalan.processor.TransformerFactoryImpl not found

错误原因：
认为是由于jdk1.5 与 tomcat5.0之间的关于 TransformerFactoryImpl 类的冲突造成的。
tomcat-5.0.28/common/endorsed下有两个jar包：xercesImpl.jar和xml-apis.jar，其中的类 javax.xml.transform.TransformerFactory 与jdk1.5中的类org.apache.xalan.processor.TransformerFactoryImpl其实是同一个类。
解决办法：
1. 将xml-apis.jar移出endorsed文件夹。
2. 用xalan系列jar包替换原来的xercesImpl.jar和xml-apis.jar。
    xalan系列jar包：serializer.jar、xalan.jar、xercesImpl.jar和xml-apis.jar。
3. For other application, just check this file or dom3-xml-apis.jar in your class path.

（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。