eclipse下使用xfire 全记录

 最近在做一个基于soa的简单的学籍管理，接触到xfire这个开发的工具。xfire能够简化web service的开发过程，让程序员从底层soap,wsdl解脱出来。下面就简述我测试xfire的开发过程。测试环境：eclipse3.2+tomcat5.5+xfire1.1

构建web服务端（参考http://blog.csdn.net/sxqem/archive/2006/06/05/774327.aspx）

1.在eclipse中新建名为xfireTest的dynamic Web Project项目

2.导入XFire用户库到WebContent\WEB-INF\lib目录下。该库中应包含xfire-1.1目录下的xfire-all-1.1.jar文件，以及xfire-1.1\lib目录下的所有文件

3.修改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> xfireTest</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>

4.编写需要发布为web service的Java类，这个例子中编写了一个简单的Hello.java，代码如下：

package com.life; public class Hello { public String hello(String name){ return "hello "+name; } }

5.在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>Hello</name> <namespace>http://com.life/Hello</namespace> <serviceClass>com.life.Hello</serviceClass> </service> </beans>

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

很多文章介绍到这里就完了，然而当按照他们所说的启动WebService ，然后通过http://localhost:8080/xfireTest/services/Hello?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”.

6.以上的问题的解决方案：在WebContent\WEB-INF目录下新建classes文件夹，然后需要将WebContent下的整个META-INF文件夹剪切到新建的classes文件夹下。

至此，服务器端的构建已完成，下面是eclipse下的项目文件结构图：

发件人 备用

客户端的构建

说明：本客户端使用xfire针对eclipse开发的插件(还可使用ant生成客户端，请参考其他材料)，下载和使用说明参见：http://xfire.codehaus.org/Eclipse+Plugin

1.在eclipse中新建一个名为helloClient的java object。

2.使用xfire插件调用服务器端的wsdl(web服务描述语言)文档生成客户端可调用的java类（步骤参见官网说明）。

3.新建一个名为Client的客户端类。其代码如下：

package life.com.hello; public class Client { HelloClient hello; HelloPortType port; public Client(){ hello=new HelloClient(); port=hello.getHelloHttpPort(); System.out.println(port.hello("life")); } public static void main(String[] args){ new Client(); } }

4.如果这个时候运行，你可能会遇见以下报错信息：

Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/httpclient/methods/RequestEntity at java.lang.Class.getDeclaredConstructors0(Native Method) at java.lang.Class.privateGetDeclaredConstructors(Unknown Source) at java.lang.Class.getConstructor0(Unknown Source) at java.lang.Class.getConstructor(Unknown Source) at org.codehaus.xfire.transport.http.HttpChannel.sendViaClient(HttpChannel.java:108) at org.codehaus.xfire.transport.http.HttpChannel.send(HttpChannel.java:48) at org.codehaus.xfire.handler.OutMessageSender.invoke(OutMessageSender.java:26) at org.codehaus.xfire.handler.HandlerPipeline.invoke(HandlerPipeline.java:131) at org.codehaus.xfire.client.Invocation.invoke(Invocation.java:79) at org.codehaus.xfire.client.Invocation.invoke(Invocation.java:114) at org.codehaus.xfire.client.Client.invoke(Client.java:336) at org.codehaus.xfire.client.XFireProxy.handleRequest(XFireProxy.java:77) at org.codehaus.xfire.client.XFireProxy.invoke(XFireProxy.java:57) at $Proxy8.hello(Unknown Source) at life.com.hello.Client.<init>(Client.java:11) at life.com.hello.Client.main(Client.java:15)

这是由于缺少apache的commons httpclient库文件.添加进去再试，又报错

Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/codec/DecoderException at org.apache.commons.httpclient.HttpMethodBase.<init>(HttpMethodBase.java:220) at org.apache.commons.httpclient.methods.ExpectContinueMethod.<init>(ExpectContinueMethod.java:93) at org.apache.commons.httpclient.methods.EntityEnclosingMethod.<init>(EntityEnclosingMethod.java:119) at org.apache.commons.httpclient.methods.PostMethod.<init>(PostMethod.java:106) at org.codehaus.xfire.transport.http.CommonsHttpMessageSender.open(CommonsHttpMessageSender.java:135) at org.codehaus.xfire.transport.http.HttpChannel.sendViaClient(HttpChannel.java:121) at org.codehaus.xfire.transport.http.HttpChannel.send(HttpChannel.java:48) at org.codehaus.xfire.handler.OutMessageSender.invoke(OutMessageSender.java:26) at org.codehaus.xfire.handler.HandlerPipeline.invoke(HandlerPipeline.java:131) at org.codehaus.xfire.client.Invocation.invoke(Invocation.java:79) at org.codehaus.xfire.client.Invocation.invoke(Invocation.java:114) at org.codehaus.xfire.client.Client.invoke(Client.java:336) at org.codehaus.xfire.client.XFireProxy.handleRequest(XFireProxy.java:77) at org.codehaus.xfire.client.XFireProxy.invoke(XFireProxy.java:57) at $Proxy8.hello(Unknown Source) at life.com.hello.Client.<init>(Client.java:11) at life.com.hello.Client.main(Client.java:15)

这是由于缺少apache的commons codec库文件，添加进去再试，成功显示如下

发件人 备用

客户端项目文件结构图：

发件人 备用