我使用的是Eclipse3.5 + Tomcat7.0 + XFire1.2.6,以下是普通服務端的開發方法。 終於,使用Java完成了一個WebService的例子,其中的一個非常小的問題,折騰了我將近一天的時間。下面給出步驟,說明在Java平台上如何開發WebService。 採用的工具:Eclipse3.1.2 + Tomcat5.5 + XFire1.1 。使用XFire開發WebService應該說非常的容易,只需要按照下面例子的步驟來做: (1)在Eclipse中建立一個dynamic Web Project ,假設名為XFireTest。 (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: <?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/"和"/servlet/XFireServlet/*"的url請求全部交給org.codehaus.xfire.transport.http.XFireConfigurableServlet來處理。 (5)編寫需要發布為WebService的Java類,這個例子中是一個非常簡單的HelloWorldSimple.java.放在eclipse下面的src下。 package com.xfire; public class MyService { 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>HelloWorldSimple3</name> <namespace>http://webservice.xfire.simple2/HelloWorld</namespace> <serviceClass>webservice.xfire.simple2.HelloWorld</serviceClass> <!--<scope>request</scope> --> </service> beans> XFire解析services.xml,從中提取需要發布為WebService的配置資訊。 很多文章介紹到這裡就完了,然而當我按照他們所說的啟動WebService ,然後通過http://localhost:8080/XFiretest/services/HelloWorldSimple?wsdl (注意XFiretest是工程名,HelloWorldSimple是service.xml中的<service>下的<name>值,即發布的服務名)來訪問服務描述時,卻拋出了異常,說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)非常關鍵的一點,就是這個小難題花費了我將近一天的時間。 在WebContent\WEB-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服務: //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()); (關於C#動態調用Web服務,請參見這裡) 執行後,彈出對話方塊,顯示結果是3 |