无SOAP的Web服务，第一部分

这是一个标准的 SOAP 绑定，使用 RPC 风格和作为传输协议的 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 编写的抽象服务描述驱动；它完全从实际使用的绑定中分离出来。该调用 API 是面向 WSDL 的，并且使用它更自然，因为它使用 WSDL 术语引用消息部件（message part）、操作等等。当您阅读一个 WSDL 描述，出于直觉会想到选用支持所需端口类型的端口，然后通过提供必需抽象输入消息（由必要部件组成）调用操作（不用担心怎样将消息映射到特定的绑定协议）；WSIF API 就是这样设计的。

常用的 API，比如上面所示的 Apache SOAP API 采用了以特殊协议为中心的概念，比如在使用 SOAP 的情况下，目标 URI 和编码风格。这是不可避免的，因为 API 不是普遍适用于 WSDL，而是为特殊的协议设计。

两种使用 WSIF 的调用模型

WSIF 允许 Web 服务以两种方式调用。一种是无存根的动态调用，它要求直接使用 WSIF API；另一种是通过生成允许应用程序使用 Java 接口（直接对应于 WSDL 端口类型）和隐藏了 WSIF API 的存根的调用。

无存根（动态的）调用

访问 Web 服务所需的所有信息 — 抽象接口、绑定和服务端点可以通过 WSDL 得到。如果您仔细查看上面的客户机 API 示例，您将会注意到唯一由用户提供的信息是用于服务的 WSDL 文件位置和所需要的股票报价符号。很明显接下来是用 WSFL API 在运行时装入这个服务和进行该调用。

WSIF 分发包包含了演示怎样执行 WSDL 的任意一个操作的 DynamicInvoker。它以 WSDL 文件的 URI 和所需的操作参数作为命令行参数（在最初的实现中只接受简单的类型，如字符串），并且直接使用 WSIF API 完成工作。其用来调用股票报价服务的示例如清单 4 所示；您可以在包含 WSIF 分发包的文档中查找详细信息。

因为这类调用不会导致生成存根类，并且不需要单独的编译周期，所以它很方便。

清单 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!

使用存根的调用

在应用程序需要更抽象的服务视图和不希望处理 WSIF 客户机 API 的情况下，无存根调用不适用。WSIF 提供一个端口编译器，如果给定一个 WSDL，与所用到的复杂类型的 Java 等价物（以 JavaBean 的形式）一起，端口编译器将为每一个端口类型生成一个客户机存根。使用生成存根的应用程序可以利用抽象服务接口，并且这样与协议和 WSIF 客户机 API 分离。对于实际服务调用，这些存根使用缺省端口。通过由 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);

值得注意的是存根驻留在某些受管环境（如应用程序服务器）的情况，它们能够被定制；例如，可以改变负责返回恰当端口的工厂来定制端口选择算法，或者可以改变用于调用自身的实际端口。

在这篇文章中，我略述了对 WSIF 的需要，分析其通过高级 API 进行独立于绑定的服务访问的主要特征以及生成可定制的存根（通过其抽象接口使用服务）的端口类型编译器的可用性。直接通过 SOAP 客户机 API 和使用 WSIF API 进行服务访问之间的对比展示了 WSIF（由服务的 WSDL 描述驱动）怎样将 Web 服务调用的全部问题从以绑定为中心的观点转移到更抽象的级别。这是 WSIF 的设计原则之一，使服务绑定能被看作是根据特殊协议进行调用所需的代码片断，可以在任何时候插入它们。

在接下来的文章，我将分析 WSIF 的体系结构，看一看它怎样允许新的或更新的绑定实现被插入，它怎样使定制的类型系统用于 Web 服务以及怎样使运行时环境使用定制的探索性方法在多端口之间进行选择。

参考资料

• 请参加关于这篇文章的讨论论坛。
  
• 请下载 alphaworks 上的 WSIF 分发包，并且试验比较简单的样本。它将给您一个由 WSIF 支持的不同调用风格的第一手示例以及它优于特定协议客户机 API 的优势。
  
• 重温 WSDL 规范，看一看允许哪一种扩展；如果用来为访问 Web 服务定义 SOAP 绑定，您也可以学习 WSDL 的扩展机制。
  
• 重温 SOAP 规范本身。
  
• 如果以前您没有对 Web 服务编过程，Web Services Toolkit 是很好的起点。
  
• 请查看 WSDL4J，一个可扩展的 WSDL 分析框架，WSIF 在此基础上进行构建。

关于作者

Nirmal K. Mukhi 是 IBM 的 T J Watson Research Lab 的副研究员，自 2000 年 11 月，他一直在从事各种 Web 服务技术的研究。他还对 AI、创造性写作以及过时的计算机游戏感兴趣。您可以通过 nmukhi@us.ibm.com 与 Nirmal 联系。

浏览：无SOAP的Web服务，第二部分