我的漫漫程序之旅

　　因為使用接口的設計是一個好的實踐，所以我們的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>

　　我們如何知道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已經可用的第一個證明。

　　但是這個測試是不夠的。可能會發生這種情況，可以看到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)，我們可以得到一個服務的本地代理。