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

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

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

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)該仔細查看下面的指導說明來執(zhí)行它：

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

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

清單 6：本地應(yī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 展示了第二個使用 WSDL 的示例，來自 Web 服務(wù)站點 Xmethods.net 而不是本地示例文件。

清單 7：跨網(wǎng)絡(luò)的動態(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!

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

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

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

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

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

總結(jié)

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

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

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

參考資料

• 請參加關(guān)于這篇文章的討論論壇。
  
• 請閱讀介紹性文章，它討論了 WSIF 怎樣促成當前 Web 服務(wù)調(diào)用模型的改進，并且描述了 WSIF 的一些主要功能。
  
• 您可以從此處下載本文清單 5 的所有代碼以及清單 6 和清單 7 中的示例。
  
• 請下載 alphaWorks 上的 WSIF 分發(fā)包，并且試驗比較簡單的樣本。它將給您一個由 WSIF 支持的不同調(diào)用風格的第一手示例以及它優(yōu)于特定協(xié)議客戶機 API 的優(yōu)勢。
  
• 重溫 WSDL 規(guī)范，看一看允許哪一種擴展；您也可以學習怎樣使用 WSDL 擴展機制定義用來訪問 Web 服務(wù)的 SOAP 綁定。
  
• 重溫 SOAP 規(guī)范本身。
  
• 如果以前您沒有對 Web 服務(wù)編過程，Web Services Toolkit 是很好的起點。
  
• 請查看 WSDL4J，一個可擴展的 WSDL 分析框架，WSIF 在此基礎(chǔ)上進行構(gòu)建。

關(guān)于作者

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

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

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