Posted on 2007-08-15 16:13
憶童年 閱讀(13638)
評論(11) 編輯 收藏 所屬分類:
Java Web
終于，使用Java完成了一個(gè)WebService的例子，其中的一個(gè)非常小的問題，折騰了我將近一天的時(shí)間。下面給出步驟，說明在Java平臺上如何開發(fā)WebService。
采用的工具：Eclipse3.1.2 + Tomcat5.5 + XFire1.1 。使用XFire開發(fā)WebService應(yīng)該說非常的容易，只需要按照下面例子的步驟來做：
（1）在Eclipse中新建一個(gè)dynamic Web Project ，假設(shè)名為XFireZhuweiTest。
（2）導(dǎo)入XFire用戶庫。該庫中應(yīng)包含xfire-1.1目錄下的xfire-all-1.1.jar文件，以及xfire-1.1\lib目錄下的所有文件。
（3）將上述的XFire用戶庫中的所有文件拷貝到XFireZhuweiTest項(xiàng)目的WebContent\WEB-INF\lib目錄下。
（4）修改WebContent\WEB-INF\web.xml配置文件的內(nèi)容，下面是修改后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）編寫需要發(fā)布為WebService的Java類，這個(gè)例子中是一個(gè)非常簡單的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目錄下添加一個(gè)XFire使用的配置文件services.xml，該配置文件中的內(nèi)容反映了要將哪些java類發(fā)布為web服務(wù)。本例中的services.xml內(nèi)容如下：
<?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，從中提取需要發(fā)布為WebService的配置信息。
很多文章介紹到這里就完了，然而當(dāng)我按照他們所說的啟動WebService ，然后通過http://localhost:8080/XFireZhuweiTest/services/MathService?wsdl 來訪問服務(wù)描述時(shí)，卻拋出了異常，說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）非常關(guān)鍵的一點(diǎn)，就是這個(gè)小難題花費(fèi)了我將近一天的時(shí)間。
在WebContent\WEB-INF目錄下新建classes文件夾，然后需要將WebContent下的整個(gè)META-INF文件夾剪切到新建的classes文件夾下。
到這里，項(xiàng)目的完整目錄結(jié)構(gòu)如下：
（8）在處理完這個(gè)問題后.從新部署并運(yùn)Tomcat.但接著問題又來了錯(cuò)誤內(nèi)容如下：Unrecognized xbean element mapping: services in namespace http://xfire.codeh.
經(jīng)過分析得出XFire1.26需要xalan.jar包的支持.但它自身的Lib下無此jar。需要我們在apache官方下載.然后將此包放入工程的lib下
（9）再次從新編譯運(yùn)行.本以為一切OK了.但還是出來問題java.lang.NoClassDefFoundError: org/apache/xml/serializer/TreeWalker錯(cuò)誤
這次通過在Apache官方找到了出錯(cuò)誤的原因：
原本這個(gè)類是包含在xalan.jar中的，但是xalan-j2.7.0版的發(fā)布包中，將serializer包中的類單獨(dú)打包成serializer.jar，不再包含在xalan.jar中，所以才會即使添加了
xalan.jar也無法找到該類，添加后即可解決問題
（10）OK。一切搞定在IE中輸入 http://localhost:8080/XFireZhuweiTest/services/MathService?wsdl 會得到正確的web服務(wù)描述文檔