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

該服務(wù)提供兩種綁定：HTTP 之上的 SOAP 和本機(jī) Java。在 WSDL 中直接綁定 Java 類沒有標(biāo)準(zhǔn)的方法，但是這只會(huì)造成理解上的障礙，因此我們不再贅述。給定該服務(wù)多綁定的可用性，客戶機(jī)將希望使用可能提供最好性能（比如 Java 綁定）的一個(gè)，大概因?yàn)樗橄蟛僮鞯?Java 方法調(diào)用直接轉(zhuǎn)換，而不需要網(wǎng)絡(luò)、序列化／反序列化等操作。當(dāng)然，Java 綁定只在部署了服務(wù)的環(huán)境可用。不象 SOAP 綁定，它不能在因特網(wǎng)上公用。因此我們希望做的是當(dāng)可以時(shí)選擇 Java 綁定，而在其它情況下使用 SOAP 綁定。如清單 5 所示，可以通過(guò)編寫我們自己的 WSIFPortFactory 來(lái)實(shí)現(xiàn)。

清單 5：定制的綁定選擇算法（請(qǐng)參閱參考資料以獲取全部代碼）

public class MyWSIFPortFactory extends
WSIFDynamicPortFactory {
public WSIFPort getPort () throws WSIFException {
WSIFException ex = null;
WSIFPort portInstance = null;
// examine list of available ports
// do we have a port with a Java binding?
for(int i = 0; i < myPortsArr.length; ++i) {
try {
Port port = myPortsArr[i];
Binding binding = port.getBinding();
if (binding instanceof JavaBinding) {
// attempt to create a port that can
// make invocations using this binding
portInstance =
createDynamicWSIFPort(def, service, port);
if(portInstance != null) {
return portInstance;
}
}
} catch(WSIFException wex) {
if(ex == null) {
ex = wex;
}
}
}
// unable to create a port that can invoke a Java
// binding (why? perhaps there is no Java port
// for this service, or the Java port cannot be
// created for invocation since we are not in
// an environment that has access to the resources
// that the Java binding uses)
// use WSDL ports with other
// bindings for invoking the service
// Full code not shown here due to length.
// Please see the Resources section at the end of
// this article to download the actual code.
}
}

如果您下載了清單 5 中示例的全部代碼（參考資料部分中可得到），您應(yīng)該仔細(xì)查看下面的指導(dǎo)說(shuō)明來(lái)執(zhí)行它：

將 zip 壓縮文檔解壓縮到某個(gè)目錄（本例我們使用 C:Forge）。它將創(chuàng)建一個(gè)子目錄，比如 C:Forgetwsif-1.0-my-factory。
當(dāng)您準(zhǔn)備好編譯這個(gè)示例時(shí)，務(wù)必包括 WSIF 文檔中描述的所有必需的 JAR 文件。
編譯 C:FORGEwsif-1.0-my-factorysamples 中的樣本源代碼，然后將包含已編譯的 Java .class 文件的這個(gè)目錄添加到 CLASSPATH 環(huán)境變量中。

當(dāng)它完全編譯成功時(shí)，在命令行運(yùn)行清單 6 中的第一個(gè)命令。它使用本地示例文件，并且利用修改的動(dòng)態(tài)調(diào)用器。

清單 6：本地應(yīng)用程序中的動(dòng)態(tài)調(diào)用

C:jdk1.3binjava.exe -classpath ".;C:Forgewsif-1.0-my-factorysamples;
C:Forgewsif-1.0samples;C:Forgewsif-1.0samplesgenerated;
C:Forgewsif-1.0samplesgenerated;C:Forgexml-soapxml_soap22.jar;C:Forge
jaxp-1.1jaxp.jar;C:Forgejaxp-1.1crimson.jar;C:Forgejavamail-1.2mail.jar;
C:Forgejaf-1.0.1activation.jar;C:Forgewsif-1.0libwsif-all-1.0.jar"
clients.MyDynamicInvoker samplesservicesstockquoteStockquote.wsdl
getQuote IBM
Reading WSDL document from 'samplesservicesstockquoteStockquote.wsdl'
Preparing WSIF dynamic invocation
DEBUG: examining for selection port SOAPPort
DEBUG: selected soap port SOAPPort
DEBUG: examining for selection port JavaPort
DEBUG: selected java port JavaPort
Preffered port name 'JavaPort'
Executing operation getQuote
Result:
quote=90.05
Done!

清單 7 展示了第二個(gè)使用 WSDL 的示例，來(lái)自 Web 服務(wù)站點(diǎn) Xmethods.net 而不是本地示例文件。

清單 7：跨網(wǎng)絡(luò)的動(dòng)態(tài)調(diào)用

C:jdk1.3binjava.exe -classpath ".;C:Forgewsif-1.0-my-factorysamples;
C:Forgewsif-1.0samples;C:Forgewsif-1.0samplesgenerated;
C:Forgewsif-1.0samplesgenerated;C:Forgexml-soapxml_soap22.jar;
C:Forgejaxp-1.1jaxp.jar;C:Forgejaxp-1.1crimson.jar;
C:Forgejavamail-1.2mail.jar;C:Forgejaf-1.0.1activation.jar;
C:Forgewsif-1.0libwsif-all-1.0.jar" clients.MyDynamicInvoker
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
DEBUG: examining for selection port net.xmethods.services.stockquote.StockQuotePort
DEBUG: selected soap port net.xmethods.services.stockquote.StockQuotePort
Preffered port name 'net.xmethods.services.stockquote.StockQuotePort'
Executing operation getQuote
Result:
Result=90.0
Done!

在運(yùn)行時(shí)更新／添加綁定實(shí)現(xiàn)

假如我們想要升級(jí) SOAP 實(shí)現(xiàn)。使用該體系結(jié)構(gòu)，我們可以不必重編譯用戶代碼或存根代碼完成到新的實(shí)現(xiàn)的遷移，因?yàn)?WSIF API 將保持不變。我們將編寫新的 WSIFPort 實(shí)現(xiàn)，能夠使用由新的 SOAP 實(shí)現(xiàn)提供的修改過(guò)的 SOAP 客戶機(jī) API 進(jìn)行調(diào)用。接著，我們編寫將 WSDL SOAP 接口轉(zhuǎn)換到新的 WSIFPort 實(shí)現(xiàn)的動(dòng)態(tài)提供者。一旦我們注冊(cè)了這個(gè)新的動(dòng)態(tài)提供者，它將代替以前注冊(cè)的 SOAP 動(dòng)態(tài)提供者，并且將通過(guò)新的 WSIFPort 實(shí)現(xiàn)進(jìn)行所有 WSDL SOAP 端口調(diào)用。

請(qǐng)考慮一下我們定義我們自己的 WSDL 綁定的情況。首先，我們必須確保 WSIF 運(yùn)行時(shí)能夠裝入帶有新的綁定的 WSDL 文檔；這需要我們?yōu)榭蓴U(kuò)展性元素定義處理程序，這些元素是使用 WSDL4J（請(qǐng)參閱參考資料）的擴(kuò)展注冊(cè)中心 API 添加到我們的 WSDL 中的元素。我們將不深入到這怎樣實(shí)現(xiàn)的細(xì)節(jié)中。然后我們可以編寫 WSIFPort 和動(dòng)態(tài)提供者實(shí)現(xiàn)，以更新 SOAP 綁定同樣的方式向端口工廠注冊(cè)新的動(dòng)態(tài)提供者。

存根體系結(jié)構(gòu)

我們可以從這種體系結(jié)構(gòu)得到的最重要的好處是：它使我們能夠得到可由受管環(huán)境定制的客戶機(jī)存根。所有 WSIF 存根擴(kuò)展清單 8 指定的基本類。

清單 8：WSIFStub 基本類

// some methods and other details omitted
public abstract class WSIFStub {
/**
* Locates a port factory using JNDI if available,
* otherwise uses dynamic port factory with
* pre-registered dynamic providers
*/
protected void locatePortFactory(.....) {
.....
}
/**
* Initializes stub with ports defined in WSDL document
* document must contain *exactly* one service and all
* ports must implement one and only one port type.
*/
protected void initializeFromLocation (...) {
.....
}
/**
* Return the port currently being used.
*/
public WSIFPort getPort () {
return wp;
}
/**
* Return the port factory currently being used.
*/
public WSIFPortFactory getPortFactory () {
return wpf;
}
/**
* Create a new proxy using the given WSIFPortFactory.
*/
public void setPortFactory (WSIFPortFactory wpf) {
.....
}
/**
* Create a new proxy pre-configured to use the given port
* for interacting with the service.
*/
public void setPort (WSIFPort wp) {
.....
}
/**
* Select the port to use by giving the name of the port
* that is desired. If a port of that name cannot be retrived from
* the port factory than an exception will be thrown. The port
* I use will only be updated if this method is successful.
*/
public void selectPort (String portName) {
.....
}
}

這種體系結(jié)構(gòu)給了我們巨大的好處。在允許受管環(huán)境順著模式作出改變的同時(shí)，它使應(yīng)用程序能夠使用同一存根，而不必重新編譯任何東西。請(qǐng)考慮清單 5 中的例子，我們使用定制的綁定選擇算法編寫了我們自己的端口工廠。如果我們?cè)趹?yīng)用程序服務(wù)器環(huán)境操作 JNDI，我們可以將該端口工廠實(shí)現(xiàn)綁定到恰當(dāng)?shù)闹付ǖ?JNDI 環(huán)境。當(dāng)存根在初始化期間查找端口工廠時(shí)，它將得到新的實(shí)現(xiàn)。當(dāng)然，我們可以通過(guò)直接調(diào)用存根上的 setPortFactory 方法強(qiáng)制在存根所使用的端口工廠進(jìn)行改變（如果這是我們想要做的），或者我們可以通過(guò)使用存根的 setPort 方法強(qiáng)制使用特殊端口。

總結(jié)

隨著 Web 服務(wù)持續(xù)發(fā)展，使用 SOAP 之外的協(xié)議訪問(wèn)服務(wù)端點(diǎn)將變得很普遍。因此當(dāng)我們編寫使用 Web 服務(wù)的應(yīng)用程序時(shí)，我們需要工作在 WSDL 級(jí)而不是在 SOAP 級(jí)的 API。

WSIF 提供了著眼于 Web 服務(wù)調(diào)用的抽象方式，這樣我們可以使用不受綁定束縛的調(diào)用 API 編寫應(yīng)用程序。WSIF 有生成可定制存根的端口類型編譯器；WSIF API 足夠簡(jiǎn)單，以至于應(yīng)用程序能夠通過(guò)直接使用它來(lái)進(jìn)行無(wú)存根調(diào)用。WSIF 的體系結(jié)構(gòu)能夠以靈活的方式定義定制端口和端口工廠，并且也使被創(chuàng)建的消息能夠使用任何本機(jī)類型系統(tǒng)。在存根用來(lái)進(jìn)行調(diào)用的端口或端口工廠中，對(duì)于受管環(huán)境（比如應(yīng)用程序服務(wù)器），生成的存根有入口點(diǎn)來(lái)進(jìn)行運(yùn)行時(shí)修改。

Web 服務(wù)需要獨(dú)立于綁定的可擴(kuò)展調(diào)用框架，WSIF 是朝該方向邁出的第一步。

參考資料

• 請(qǐng)參加關(guān)于這篇文章的討論論壇。
  
• 請(qǐng)閱讀介紹性文章，它討論了 WSIF 怎樣促成當(dāng)前 Web 服務(wù)調(diào)用模型的改進(jìn)，并且描述了 WSIF 的一些主要功能。
  
• 您可以從此處下載本文清單 5 的所有代碼以及清單 6 和清單 7 中的示例。
  
• 請(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ò)展；您也可以學(xué)習(xí)怎樣使用 WSDL 擴(kuò)展機(jī)制定義用來(lái)訪問(wèn) Web 服務(wù)的 SOAP 綁定。
  
• 重溫 SOAP 規(guī)范本身。
  
• 如果以前您沒有對(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)系。

Aleksander Slominski 是 Indiana University 的博士生，他是 IU Extreme! Lab 的研究助理，致力于實(shí)現(xiàn)“公共組件體系結(jié)構(gòu)”的 XML/SOAP 啟用版。他還設(shè)計(jì)和實(shí)現(xiàn)了“XML 拖解析器”（XML Pull Parser），并且對(duì) XML 的性能和可用性方面感興趣。在 2001 年夏天期間，他是 IBM 的 T J Watson Research Lab 的實(shí)習(xí)生，在那里他從事 WSIF 第一版的研究。您能夠通過(guò) aslom@indiana.edu 和 Alek 聯(lián)系。

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