XFire：輕鬆簡單地開發Web Services

 

　　問一下.Net的開發人員，開發Web Services有多困難?他們會被你的問題逗樂，他們會告訴你所有步驟花費的時間不會超過一分鐘。再問一下Java開發人員，運氣好的話你會碰到上面的回答，一般情況下，你會得到一個完全不同的答案。從Web Services引入到Java中至今已經5年了，然而它仍然被認為是一門較新的技術，一個主要的原因就是使用Java實現Web Services太困難了。現在，隨著新一代Web Services引擎XFire的發布，這種情況將會發生明顯的變化。使用XFire，你可以把Java類方法發布為Web Services而不需要編寫額外的代碼。在這篇文章中，你將會看到XFire使Web Services開發變得多麼容易和簡單。

　　Web Services使我們能夠在網路上建立分布式系統，應用程式組件可以通過任何平台、任何語言和任何方式訪問。無論應用程式如何開發，使用了什麼語言，以及運行在什麼作業系統平台上，只要它作為Web Service，並且為協同解決問題而設計，那麼你的應用程式，以任何語言開發或在任何平台上，都可以利用它的服務。這是Web Service的主要概念。

　　為了實現Web Services的平台無關性和實現訪問獨立性，軟體行業需要遵循一些作為標準的技術。其中一些包括:

　　---XML:在Web Services環境中各層之間進行傳遞的預設資料格式。

　　---SOAP:封裝和交換資訊的預設協議。第一次被提出時，它是只取Simple Object Access Protocol(簡易物件存取通訊協定 (SOAP))的首字母。但是現在SOAP更多被認為是一個特定的名詞，以它自己而命名，同樣很多人認為這是用詞不當:SOAP實際上不是用來訪問對象的。另外，它也不再簡單。

　　---WSDL(Web Services Description Language，Web Services描述語言):描述Web Services的語言。儘管基於XML並且可以被人理解，WSDL主要是由機器處理，由用戶端程式讀取和理解。

　　下面的進階層次圖表，基於WWW協會發布的“Web Services Architecture”(Web Services架構)文檔，顯示了這些技術在實際的工作環境中是如何發揮作用:

 

　　這個流程圖顯示了Web Services中的核心技術是如何工作的。

　　這裡，Provider是提供服務的應用程式組件，Requester是使用服務的用戶端程式。很多其他技術也會參與到互動中，但是這個圖只顯示了在Web Services環境中必需的核心技術組件。

　　XFire是一個免費的開源SOAP架構，它不僅可以極大方便地實現這樣一個環境，並且可以提供許多Web Services規範中進階特徵，這些特徵在多數的商業或者開源工具都沒有提供。你要恰當的理解這些單詞:great ease and simplicity(非常輕鬆和簡單)。你將會看到使用XFire建立Web Services是多麼的簡單。

　　假如你的Web應用有一個Java類，並且你想把它的一個方法發布為Web Services，當使用XFire時，你不需要編寫一行額外的Java代碼。只需要編輯發布描述符，然後你就會得到一個Web Services。是的，它相當地簡單。我們來看一個例子。

 

 

　　services.xml

　　現在我們不得不說一下我們的Web Services的由什麼組成的了。這由一個叫做services.xml的檔案完成，它存放在META-INF/xfire目錄下，而這整個目錄放在WEB-INF/classes檔案夾中，它在Web應用程式的標準類路徑中。這裡是services.xml中的基本配置條目:

<beans xmlns="http://xfire.codehaus.org/config/1.0">     <service>     <name>Banking</name>     <namespace>mybank</namespace>     <serviceClass>com.mybank.xfire.example.IBankingService</serviceClass>     <implementationClass>com.mybank.xfire.example.BankingService</implementationClass>   </service>    </beans>

 　　讓我們看看這裡都包含了什麼內容。Web Services的定義包含在元素中，它還含有一些子項目。第一個子項目是，它可以是你提供任何的合法名字。這將會被用戶端程式和其它需要定位你的服務的組件用到。例如，在服務準備好以後，你將在瀏覽器上使用這個名字來查看WSDL。

　　下一個子項目是<namespace>。任何合法的XML名字都是可以的。<namespace>用來唯一標識你的服務的各個參數。
<serviceClass>元素包含了Java類的名字，它指定了方法簽名。在我們的例子中，它是介面IBankingService。如果Java類沒有實現任何介面，你就需要把類的名字放在這裡。在你的Java類或者介面中可能有幾個方法。只需要一個入口把它們全部發布為Web Services。

　　<implementationClass>儲存了實現方法的Java類名。這是一個可選元素。如果上一個元素<serviceClass>包含了一個介面，那麼相應的實作類別必須在這裡指定。

　　就是這樣。我們的Web Services配置完成了。

　　XFire和其它類庫

　　現在是最後一步了，需要得到所有必需的類庫。我們怎樣得到它們呢?去XFire網站，下載xfire-distribution-1.0.zip，然後解壓到一個本地檔案夾。複製下面的jar檔案和它的庫檔案夾到WEB-INF/lib中:

• 　　• activation-1.0.2.jar
• 　　• commons-codec-1.3.jar
• 　　• commons-httpclient-3.0.jar
• 　　• commons-logging-1.0.4.jar
• 　　• jaxen-1.1-beta-8.jar
• 　　• jdom-1.0.jar
• 　　• log4j-1.2.x.jar
• 　　• mail-1.3.3_01.jar
• 　　• spring-1.2.x.jar
• 　　• stax-api-1.0.jar
• 　　• wsdl4j-1.5.2.jar
• 　　• wstx-asl-2.9.jar
• 　　• xbean-2.1.0.jar
• 　　• xbean-spring-2.2.jar
• 　　• xfire-all-1.0.jar
• 　　• XmlSchema-1.0.jar

　　一切妥當。我們來部署和啟動應用程式。為了部署樣本應用，只需要複製websvc.war到Apache Tomcat的webapps檔案夾中，再等待幾秒鐘。它將會自動啟動。這個應用的全部原始碼也包含在這個war檔案中。我們的程式已經準備作為一個Web Service了。

 

　　我們如何知道Web Service正在工作呢?

　　為了瞭解Web Service是否正在工作，我們需要測試。首先，我們測試來看WSDL是否可用。我們在瀏覽器中輸入URL。哪個URL?因為我們的應用程式的war檔案是websvc.war，並且在services.xml中給出的服務名是Banking，WSDL的URL應該是:http://localhost:8080/websvc/services/Banking?wsdl。

　　請注意:URL的第一部分，例如，http://localhost:8080，可能會根據你的應用伺服器不同而不同。無論怎樣，當你輸入URL後，將會看到一個XML文檔，它的根項目是。這個文檔叫做服務的WSDL。如果你看到了，這就是你的應用作為Web Service已經可用的第一個證明。

 

　　就是它了。這個代理就是實際的用戶端。現在，我們可以調用它的transferFunds()方法來得到我們需要的Web Service。

　　一旦樣本應用發布並啟動，就可以嘗試servlet URL:

　　http://localhost:8080/websvc/ws。

　　這個Servlet使用預設參數來調用Web Service和顯示接收到的響應。頁面的最後兩行應該讀取:

　　Response Received
　　COMPLETED: CDN$ 500.00 was successfully transferred from A/C# 11111-01234 to A/C# 99999-05678

　　現在你可以確定Web Service已經發布並且在運行中了。

　　為了嘗試不同的輸入值，你可以使用完整的URL，例如:

　　http://localhost:8080/websvc/ws?from=11-2345&to=77-9876&amt=250.00&cur=EUR。

　　基本的Web Services開發步驟清單

　　這個清單總結了將一個Java方法發布為Web Service所必須的步驟:

• 　　1、 檢查Java類的方法和預設建構函式確保為public
• 　　2、 增加XFire servlet相關條目到web.xml中
• 　　3、 建立services.xml，把它放到WEB-INF/classes/META-INF/xfire目錄下
• 　　4、 增加XFire和第三方包到你的Web應用的WEB-INF/lib檔案夾中

　　這就是所有需要的步驟，是的，相當簡單。

　　XFire的其他進階特性

　　XFire的使用可能比較簡單，但是在特性和功能性上，它卻佔據著領導者的位置。下面是它的進階特性:

• 　　---本機資料綁定支援POJOs(plain-old Java objects)、XMLBeans、JAXB(Java Architecture for XML Binding)、Castor等等。資料繫結說明了Web Services的XML請求和映射到Java對象的XML響應。
• 　　---使用StAX(Streaming API for XML)處理XML文檔。同DOM的基於樹和SAX的事件驅動的處理方式相比，StAX使用了拉(pull)機制，它使處理更快速，記憶體效率更高。
• 　　---支援多種傳輸協議，如HTTP、JMS(Java Message Service)和JVM內部傳輸。
• 　　---嵌入式，這是XFire的核心功能之一。你可以把這個SOAP引擎嵌入到你的應用中，完全隱藏所有XFire特定引用，同樣所有配置都是程式驅動。
• 　　---豐富的API，它使XFire可高度自訂，允許開發人員在不同的階段截獲請求，並且對他們進行處理。
• 　　---相容最新的標準例如SOAP1.1(沒有加密遠程工程調用，或者RPC)和1.2、WSDL1.1、the Web Services Interoperability Organization’s Basic Profile 1.0、Web Services Addressing和WS-Security。

　　最重要的是，XFire屬於新一代Web Services引擎。不僅僅是營銷用語，“新一代”有一些重要的意義。Apache Axis是第一代Java語言的Web Services引擎，已經成為了所有後來工具的參考標準。在過去的幾年裡，Axis以及這些其它的工具已經在很多生產環境中進行了實地測試。從中得出的一個關鍵的問題就是Web Services並不最適合RPC類型的通訊。對於效能和效率，面向文檔的訊息形式是最好的方式。但是Apache Axis和很多其他的Web Services引擎都被設計成了面向RPC的(儘管它們支援文檔形式)。現在，整個行業正在開發新一代的SOAP引擎，設計為面向文檔的。Apache已經宣布結束舊版本的Axis引擎開發，現在專註於Axis2，現在它的預發布版本是0.95。XFire在今年的2月份發布了它的第一個產品版本(1.0)。它的下一個版本(1.1)僅僅在幾個星期之後就進行了發布。

 

 

　　效能

　　Web Services需要消耗很多資源，但是效能方面它們不是那麼引人注目。XFire打破了這種趨勢。它消耗更少的記憶體(部分因為 StAX的使用)，但是表現卻比多數可比較的SOAP引擎出色。你可以在資源中提供的連結中看到比較的結果。

　　此外，XFire還提供了各種方法來進一步最佳化效能。一個方法是使用JVM內建傳輸(in-JVM transport)。如果你知道Web Services和用戶端運行在同一個JVM上，你可以選擇使用本地傳輸，它可以大幅提升效能。在樣本中的用戶端代碼，看以下指定服務端點URL的這行:

　　String serviceUrl = "http://localhost:8080/websvc/services/Banking";

　　替換為

　　String serviceUrl = "xfire.local://Banking";

　　你會看到效能上的明顯提高，因為它繞過了整個網路層。

　　局限性

　　XFire有些重要的局限性你應該清楚:

• 　　---開發Web Services的好的實踐是從WSDL開始。大部分的SOAP引擎提供了從WSDL產生服務stub的工具。XFire也提供了這樣一個工具。但是它是基於注釋(annotations-based)的，因此需要J2SE5.0。對於仍堅持使用J2SE1.4.x的人來說，它不是一個令人拍手叫好的工具，因為我們有很多其他方式來編寫用戶端，一個就是文章中示範的方式。
• 　　---附件支援，它將會包含在未來發行的版本中。
• 　　---易於學習的使用者嚮導。XFire團隊在這個方面還有很多工作需要做。

　　結論

　　Java當前的趨勢是簡化技術的使用。因此，我們正看到一波基於POJO的開發成就。同時，面向服務架構(SOA，Services-oriented architecture)和Web Services已經變成了當前行業的熱點話題。XFire正是在這種情況下產生的。它能夠使POJO發布為最少的Web Services，而只需要付出最小化的努力。從而，它使希望使用這項技術的初級開發人員的學習曲線變得平緩。同時，由於它相容最新標準和提供了豐富的API，XFire為進階使用者提供了更多的大好機會。

著作權聲明：Techtarget獲Matrix授權發布,如需轉載請聯絡Matrix
作者:Shahid Ahmed ;mydeman
原文:http://www.javaworld.com/javaworld/jw-05-2006/jw-0501-xfire.html
Matrix:http://www.matrix.org.cn/resource/article/2006-09-24/XFire_6bd1061c-4bc6-11db-978f-43b3336b7e51.html

　　但是這個測試是不夠的。可能會發生這種情況，可以看到WSDL，但是從用戶端程式可能會訪問不到服務。因此為了核實服務是否可以訪問了，我們必須使用一個用戶端進行服務的實際調用來進行一個真正的測試。

　　開發一個用戶端

　　你可以使用任何的SOAP工具建立用戶端，例如，.Net或者Apache Axis，有很多種方法:使用從WSDL產生的stubs，使用動態代理，等等。在例子中，我們使用一個動態代理，以一個簡單的Servlet形式，叫做WsClient.java。為了保持代碼兩最小，所有在螢幕顯示的元素都放在了doGet()方法中。對Web Service的實際調用由callWebService()方法完成，它相當地簡單。和下面的類似:

/* Call the Web service     *     */     public String callWebService(         String fromAccount, String toAccount, double amount, String currency)         throws MalformedURLException, Exception {                 //Create a metadata of the service              Service serviceModel = new ObjectServiceFactory().create(IBankingService.class);                log.debug("callSoapServiceLocal(): got service model." );            //Create a proxy for the deployed service         XFire xfire = XFireFactory.newInstance().getXFire();         XFireProxyFactory factory = new XFireProxyFactory(xfire);                  String serviceUrl = "http://localhost:8080/websvc/services/Banking";                 IBankingService client = null;         try {             client = (IBankingService) factory.create(serviceModel, serviceUrl);         } catch (MalformedURLException e) {             log.error("WsClient.callWebService(): EXCEPTION: " + e.toString());         }                           //Invoke the service         String serviceResponse = "";         try {             serviceResponse = client.transferFunds(fromAccount, toAccount, amount, currency);        } catch (Exception e){             log.error("WsClient.callWebService(): EXCEPTION: " + e.toString());                             serviceResponse = e.toString();         }                log.debug("WsClient.callWebService(): status=" + serviceResponse);                      //Return the response         return serviceResponse;     }

　　這個代碼是如何工作的呢?我來解釋一下:首先，我們建立一個服務模型，它包含服務的說明——換句話說，就是服務的中繼資料。我們使用XFire的ObjectServiceFactory從IBankingService.class介面建立這個模型。

　　接著，為XFire獲得一個代理工廠對象，它包含了常規的代碼，也相當地簡單和易懂。這一步中沒有任何特定應用的東西。從這個proxyFactory，使用服務模型和服務端點URL(用來獲得WSDL)，我們可以得到一個服務的本地代理。

 

　　一個簡單的Java類

　　我們的例子是一個銀行業應用程式，伺服器是運行在J2SE1.4.2_07下的Apache Tomcat5.5.7。假定你已經瞭解如何使用Java編寫Web應用程式，並知道應該如何把它部署到Apache Tomcat伺服器上。我們的Web應用程式非常簡單;它只做一件事——將資金從一個賬戶轉到另外一個賬戶上。一個普通的Java類BankingService包含了一個叫做transferFunds()的方法來為我們完成這項工作。它需要四個輸入參數:

• 　　1、 String fromAccount
• 　　2、 String toAccount
• 　　3、 double amount
• 　　4、 String currency

　　代碼如下:

package com.mybank.xfire.example; import java.text.NumberFormat; import java.text.DecimalFormat; /** XFire WebServices sample implementation class. */ public class BankingService implements IBankingService {         //Default constructor.     public BankingService(){        }         /** Transfers fund from one account to another.     */     public String transferFunds(         String fromAccount, String toAccount, double amount, String currency){                 String statusMessage = "";                               //Call business objects and other components to get the job done.         //Then create a status message and return.         try {             NumberFormat formatter = new DecimalFormat("###,###,###,###.00");                   statusMessage = "COMPLETED: " + currency + " " + formatter.format(amount)+             " was successfully transferred from A/C# " + fromAccount + " to A/C# " + toAccount;         } catch (Exception e){             statusMessage = "BankingService.transferFunds(): EXCEPTION: " + e.toString();         }         return statusMessage;     }     }

　　在這裡你看到了什麼異常的東西了嗎?或許沒有，除了預設的建構函式，類型是public。這是必須的。否則，XFire不能夠初始化這個類。

 

 

　　因為使用介面的設計是一個好的實踐，所以我們的Java類也實現了一個稱為IBankingService的介面。代碼十分簡單:

package com.mybank.xfire.example; public interface IBankingService {      public String transferFunds(         String fromAccount, String toAccount, double amount, String currency);         }

　　在實際實現中，這樣一個方法可能包括各種類型的複雜調用、查詢和處理操作。但是我們的範例程式碼已經最小化了，以至於我們可以集中精力在主要目標上:把這個方法發布為Web Services。

　　你可以看到BankingService是一個普通的Java類，沒有任何代碼告訴我們它將會在Web Services中使用。好的，這裡我們不需要增加任何東西。我們所有的工作都在部署描述符裡完成。

　　Web應用的部署描述符

　　在Java中，Web應用程式通常需要至少一個部署描述符(叫做web.xml)對其進行配置。XFire本身是一個基於servlet的應用程式。因此，我們需要增加必要的引用到描述符檔案中。然後我們還必須配置將要建立的Web Services。我們使用一個稱為services.xml的新檔案來完成這件事。

　　web.xml

　　首先，修改web.xml。我們需要增加下面的XFire servlet相關的條目:

<servlet>         <servlet-name>XFireServlet</servlet-name>         <display-name>XFire Servlet</display-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>