Java －在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.1lib目录下的所有文件。

　　（3）将上述的XFire用户库中的所有文件拷贝到XFireZhuweiTest项目的WebContentWEB-INFlib目录下。

　　（4）修改WebContentWEB-INFweb.xml配置文件的内容，下面是修改后web.xml：

双击代码全选

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61

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

双击代码全选

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

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

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

双击代码全选

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

<?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）非常关键的一点，就是这个小难题花费了我将近一天的时间。

　　 在WebContentWEB-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服务：

双击代码全选

1 2 3 4 5 6 7 8 9

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

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