無SOAP的Web服務，第一部分

這是一個標準的 SOAP 綁定，使用 RPC 風格和作為傳輸協(xié)議的 HTTP 與服務進行通信。在文檔的 port 部分中，我定義了使用 SOAP 綁定可以訪問服務的 URI。在清單 3 中，我將就通過 Apache SOAP 2.2 客戶機端 API 和 WSIF 的客戶機 API 使用該服務進行對比。

清單 3：用于服務訪問的 Apache SOAP API 與 WSIF API 對比

--------------------------------------------------------------------------------
Apache SOAP API
--------------------------------------------------------------------------------
// Step 1: identify the service
Call call = new Call();
call.setTargetObjectURI("urn:xmltoday-delayed-quotes");
// Step 2: identify the operation
call.setMethodName("getQuote");
call.setEncodingStyleURI(encodingStyleURI);
// Step 3: identify the parameters
Vector params = new Vector();
params.addElement(new Parameter("symbol",
String.class, symbol, null));
call.setParams(params);
// Step 4: execute the operation
Response resp = call.invoke(url,
"http://example.com/GetTradePrice");
// Step 5: extract the result or fault
if(resp.generatedFault())
{
Fault fault = resp.getFault();
System.out.println("Ouch, the call failed: ");
System.out.println(" Fault Code = " +
fault.getFaultCode());
System.out.println(" Fault String = " +
fault.getFaultString());
throw new SOAPException("Execution failed " + fault);
}
else
{
Parameter result = resp.getReturnValue();
return ((Float) result.getValue()).floatValue();
}
--------------------------------------------------------------------------------
WSIF API
--------------------------------------------------------------------------------
// Step 1: identify the service
Definition def = WSIFUtils.readWSDL(null,wsdlLocation);
// Step 2: identify the operation (choose an
// appropriate service port)
WSIFDynamicPortFactory portFactory =
new WSIFDynamicPortFactory(def, null, null);
// Get default port
WSIFPort port = portFactory.getPort();
// The user can also explicitly select a port
// to use.
// WSIFPort port =
// portFactory.getPort("SOAPPort");
// Step 3: identify the parameters
// Prepare the input message
WSIFMessage input = port.createInputMessage();
input.setPart("symbol",
new WSIFJavaPart(String.class, symbol));
// Prepare a placeholder for the output value
WSIFMessage output = port.createOutputMessage();
// Step 4: execute the operation
port.executeRequestResponseOperation("getQuote",
input, output, null);
// Step 5: extract the result or fault
WSIFPart part = output.getPart("quote");
return ((Float)part.getJavaValue()).floatValue();

正如您可以看到的，WSIF 的 API 由以 WSDL 編寫的抽象服務描述驅動；它完全從實際使用的綁定中分離出來。該調(diào)用 API 是面向 WSDL 的，并且使用它更自然，因為它使用 WSDL 術語引用消息部件（message part）、操作等等。當您閱讀一個 WSDL 描述，出于直覺會想到選用支持所需端口類型的端口，然后通過提供必需抽象輸入消息（由必要部件組成）調(diào)用操作（不用擔心怎樣將消息映射到特定的綁定協(xié)議）；WSIF API 就是這樣設計的。

常用的 API，比如上面所示的 Apache SOAP API 采用了以特殊協(xié)議為中心的概念，比如在使用 SOAP 的情況下，目標 URI 和編碼風格。這是不可避免的，因為 API 不是普遍適用于 WSDL，而是為特殊的協(xié)議設計。

兩種使用 WSIF 的調(diào)用模型

WSIF 允許 Web 服務以兩種方式調(diào)用。一種是無存根的動態(tài)調(diào)用，它要求直接使用 WSIF API；另一種是通過生成允許應用程序使用 Java 接口（直接對應于 WSDL 端口類型）和隱藏了 WSIF API 的存根的調(diào)用。

無存根（動態(tài)的）調(diào)用

訪問 Web 服務所需的所有信息 — 抽象接口、綁定和服務端點可以通過 WSDL 得到。如果您仔細查看上面的客戶機 API 示例，您將會注意到唯一由用戶提供的信息是用于服務的 WSDL 文件位置和所需要的股票報價符號。很明顯接下來是用 WSFL API 在運行時裝入這個服務和進行該調(diào)用。

WSIF 分發(fā)包包含了演示怎樣執(zhí)行 WSDL 的任意一個操作的 DynamicInvoker。它以 WSDL 文件的 URI 和所需的操作參數(shù)作為命令行參數(shù)（在最初的實現(xiàn)中只接受簡單的類型，如字符串），并且直接使用 WSIF API 完成工作。其用來調(diào)用股票報價服務的示例如清單 4 所示；您可以在包含 WSIF 分發(fā)包的文檔中查找詳細信息。

因為這類調(diào)用不會導致生成存根類，并且不需要單獨的編譯周期，所以它很方便。

清單 4：使用 DynamicInvoker 訪問股票報價服務

java clients.DynamicInvoker http://services.xmethods.net/soap/urn:
xmethods-delayed-quotes.wsdl getQuote IBM
Reading WSDL document from 'http://services.xmethods.net/soap/urn:
xmethods-delayed-quotes.wsdl'
Preparing WSIF dynamic invocation
Executing operation getQuote
Result:
Result=108.8
Done!

使用存根的調(diào)用

在應用程序需要更抽象的服務視圖和不希望處理 WSIF 客戶機 API 的情況下，無存根調(diào)用不適用。WSIF 提供一個端口編譯器，如果給定一個 WSDL，與所用到的復雜類型的 Java 等價物（以 JavaBean 的形式）一起，端口編譯器將為每一個端口類型生成一個客戶機存根。使用生成存根的應用程序可以利用抽象服務接口，并且這樣與協(xié)議和 WSIF 客戶機 API 分離。對于實際服務調(diào)用，這些存根使用缺省端口。通過由 WSIF 的端口類型編譯器生成的存根使用股票報價服務的示例如清單 5 所示。

清單 5：使用生成存根的 WSIF 訪問股票報價服務。

StockquotePT service = new StockquotePTStub(WSIFUtils.readWSDL(null, wsdlLocation),
null, null);
float quote = service.getQuote("IBM");
System.err.println (">> Received quote: "+quote);

值得注意的是存根駐留在某些受管環(huán)境（如應用程序服務器）的情況，它們能夠被定制；例如，可以改變負責返回恰當端口的工廠來定制端口選擇算法，或者可以改變用于調(diào)用自身的實際端口。

在這篇文章中，我略述了對 WSIF 的需要，分析其通過高級 API 進行獨立于綁定的服務訪問的主要特征以及生成可定制的存根（通過其抽象接口使用服務）的端口類型編譯器的可用性。直接通過 SOAP 客戶機 API 和使用 WSIF API 進行服務訪問之間的對比展示了 WSIF（由服務的 WSDL 描述驅動）怎樣將 Web 服務調(diào)用的全部問題從以綁定為中心的觀點轉移到更抽象的級別。這是 WSIF 的設計原則之一，使服務綁定能被看作是根據(jù)特殊協(xié)議進行調(diào)用所需的代碼片斷，可以在任何時候插入它們。

在接下來的文章，我將分析 WSIF 的體系結構，看一看它怎樣允許新的或更新的綁定實現(xiàn)被插入，它怎樣使定制的類型系統(tǒng)用于 Web 服務以及怎樣使運行時環(huán)境使用定制的探索性方法在多端口之間進行選擇。

參考資料

• 請參加關于這篇文章的討論論壇。
  
• 請下載 alphaworks 上的 WSIF 分發(fā)包，并且試驗比較簡單的樣本。它將給您一個由 WSIF 支持的不同調(diào)用風格的第一手示例以及它優(yōu)于特定協(xié)議客戶機 API 的優(yōu)勢。
  
• 重溫 WSDL 規(guī)范，看一看允許哪一種擴展；如果用來為訪問 Web 服務定義 SOAP 綁定，您也可以學習 WSDL 的擴展機制。
  
• 重溫 SOAP 規(guī)范本身。
  
• 如果以前您沒有對 Web 服務編過程，Web Services Toolkit 是很好的起點。
  
• 請查看 WSDL4J，一個可擴展的 WSDL 分析框架，WSIF 在此基礎上進行構建。

關于作者

Nirmal K. Mukhi 是 IBM 的 T J Watson Research Lab 的副研究員，自 2000 年 11 月，他一直在從事各種 Web 服務技術的研究。他還對 AI、創(chuàng)造性寫作以及過時的計算機游戲感興趣。您可以通過 nmukhi@us.ibm.com 與 Nirmal 聯(lián)系。

瀏覽：無SOAP的Web服務，第二部分