無(wú)SOAP的Web服務(wù)，第一部分

這是一個(gè)標(biāo)準(zhǔn)的 SOAP 綁定，使用 RPC 風(fēng)格和作為傳輸協(xié)議的 HTTP 與服務(wù)進(jìn)行通信。在文檔的 port 部分中，我定義了使用 SOAP 綁定可以訪問(wèn)服務(wù)的 URI。在清單 3 中，我將就通過(guò) Apache SOAP 2.2 客戶機(jī)端 API 和 WSIF 的客戶機(jī) API 使用該服務(wù)進(jìn)行對(duì)比。

清單 3：用于服務(wù)訪問(wèn)的 Apache SOAP API 與 WSIF API 對(duì)比

--------------------------------------------------------------------------------
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 編寫的抽象服務(wù)描述驅(qū)動(dòng)；它完全從實(shí)際使用的綁定中分離出來(lái)。該調(diào)用 API 是面向 WSDL 的，并且使用它更自然，因?yàn)樗褂?WSDL 術(shù)語(yǔ)引用消息部件（message part）、操作等等。當(dāng)您閱讀一個(gè) WSDL 描述，出于直覺(jué)會(huì)想到選用支持所需端口類型的端口，然后通過(guò)提供必需抽象輸入消息（由必要部件組成）調(diào)用操作（不用擔(dān)心怎樣將消息映射到特定的綁定協(xié)議）；WSIF API 就是這樣設(shè)計(jì)的。

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

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

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

無(wú)存根（動(dòng)態(tài)的）調(diào)用

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

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

因?yàn)檫@類調(diào)用不會(huì)導(dǎo)致生成存根類，并且不需要單獨(dú)的編譯周期，所以它很方便。

清單 4：使用 DynamicInvoker 訪問(wèn)股票報(bào)價(jià)服務(wù)

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)用

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

清單 5：使用生成存根的 WSIF 訪問(wèn)股票報(bào)價(jià)服務(wù)。

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

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

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

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

參考資料

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

關(guān)于作者

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

瀏覽：無(wú)SOAP的Web服務(wù)，第二部分