使用XFire开发WebService【服务端】

Java平台上如何开发WebService。

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

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

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

/XFireTest/WebContent/WEB-INF/lib/commons-codec-1.3.jar

/XFireTest/WebContent/WEB-INF/lib/commons-httpclient-3.0.jar

/XFireTest/WebContent/WEB-INF/lib/commons-logging-1.0.4.jar

/XFireTest/WebContent/WEB-INF/lib/jaxen-1.1-beta-9.jar

/XFireTest/WebContent/WEB-INF/lib/jdom-1.0.jar

/XFireTest/WebContent/WEB-INF/lib/spring-1.2.6.jar

/XFireTest/WebContent/WEB-INF/lib/stax-api-1.0.1.jar

/XFireTest/WebContent/WEB-INF/lib/stax-utils-20040917.jar

/XFireTest/WebContent/WEB-INF/lib/wsdl4j-1.6.1.jar

/XFireTest/WebContent/WEB-INF/lib/wss4j-1.5.1.jar

/XFireTest/WebContent/WEB-INF/lib/wstx-asl-3.2.0.jar

/XFireTest/WebContent/WEB-INF/lib/xbean-spring-2.8.jar

/XFireTest/WebContent/WEB-INF/lib/xfire-all-1.2.6.jar

/XFireTest/WebContent/WEB-INF/lib/xfire-jsr181-api-1.0-M1.jar

/XFireTest/WebContent/WEB-INF/lib/xml-apis-1.0.b2.jar

/XFireTest/WebContent/WEB-INF/lib/XmlSchema-1.1.jar

/XFireTest/WebContent/WEB-INF/lib/xmlsec-1.3.0.jar

3）将上述的XFire用户库中的所有文件拷贝到XFireTest项目的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类，这个例子中是一个非常简单的SayHello.java。

package com.liuyang.webservice;

public class SayHello {

public String hello(String name) {

return "Hello," + name;

}

}

6）在WebContentMETA-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>SayHello</name>

<namespace>http://com.liuyang.webservice/SayHello</namespace>

<serviceClass>com.liuyang.webservice.SayHello</serviceClass>

</service>

</beans>

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

很多文章介绍到这里就完了，然而当我按照他们所说的启动WebService　，然后通过http://localhost:8080/XFireTest/services/SayHello?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/XFireTest/services/SayHello?wsdl 　会得到正确的web服务描述文档。