采用的工具: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:
<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。
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内容如下:
< 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
到这里,项目的完整目录结构如下:
(8)在Package Explorer中选中XFireZhuweiTest项目,右键->Run As ->Run On Server,关联到你机器上的TomCat,然后会启动Tomcat,以启动web服务。(注意,在进行此步骤之前,请先停止TomCat)
(9)在IE中输入 http://localhost:8080/XFireZhuweiTest/services/MathService?wsdl 会得到正确的web服务描述文档。
(10)连接测试
源码:
import org.codehaus.xfire.client.Client;
/**
* 当然第一种采用纯Java的方式进行测试,且在控制台输出的方式
* 第一种测试的方案 客户端调用采用XFire客户端直接调用的访问
* @author 漆艾林 2010年11月
*
*/
public class HelloServiceTest {
/**
* main主方法,测试在控制台进行输出
* @param args
* @throws Exception
*/
public static void main(String[] args) throws Exception {
//根据地址得到Url得到客户端,采用XFire进行进行加载
Client client = new Client(new URL("http://localhost:8080/XfireWebService/services/HelloService?wsdl"));
System.out.println("---------Service测试-----------------");
//采用Client的invoke方法需要两个参数,第一个是方法的名称,第二个数组类型的参数
Object[] results = client.invoke("sayHello", new Object[] {"wing", "game" });
//得到结果
System.out.println("测试结果:");
//返回结果
if (results[0]!=null) {
System.out.println(results[0].toString());
} else {
System.err.println("error");
}
}
}
结果:
---------Service测试-----------------
测试结果:
wing,你好!
异常处理:
1:
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”。
Fixed: 非常关键的一点,就是这个小难题花费了我将近一天的时间。
在WebContent\WEB-INF目录下新建classes文件夹,然后需要将WebContent下的整个META-INF文件夹剪切到新建的classes文件夹下。
2: xfire/services.xml 中配置的 XFireConfigurableServlet 找不到