引言 在典型的 Web 服务场景中,通常使用工具技术来处理命名空间的所有细微差别。但是有些时候,特别是在使用 SAAJ(SOAP with Attachments API for Java)为特定的 Web 服务构造 SOAP 消息时,您必须自己处理命名空间问题。在没有任何工具辅助的情况下构造消息――或是部分消息时――可以使用该技巧。
虽然命名空间看似复杂,但您真正只需要掌握的是以下一份简短的规则清单:
如果 WSDL 样式为 RPC,那么可在 WSDL 绑定的 wsdlsoap:body 元素中查看命名空间。
如果 wsdlsoap:body 有命名空间属性(且 Web 服务互操作性组织(WS-I)的 Basic Profile(参见参考资料部分)需要该属性用于 RPC 样式),那么这就是 SOAP 消息中操作元素的命名空间。
如果 wsdlsoap:body 没有命名空间,那么该操作元素不符合要求。
对于数据元素而言:
如果元素通过根元素(不是根类型)定义,那么它的命名空间就是根元素的命名空间;
如果元素不是通过根定义的,那么该元素不符合要求(对于该规则的说明请参见以下 elementFormDefault 部分的讨论。)
这些都是简单的规则,但如同大多数规则一样,需要对其进行少许说明。本文的其余部分将展示使用这些规则的各类实例。
有两种常用类型的 Web 服务描述语言(WSDL)文件: RPC/literal 和 document/literal 封装。当然还有其它的类型,但在本文中只包含这两种。(各类 WSDL 的详细内容参见文章“我应该使用哪种样式的 WSDL?”――参见参考资料。)
RPC/literal WSDL
清单 1 中的 RPC/literal WSDL 有三个操作:op1、op2 和 op3。注意 WSDL 文件中用粗体强调的不同命名空间。
清单 1. RPC/literal WSDL
<?xml version="1.0" encoding="UTF-8"?>
<definitions
targetNamespace="http://apiNamespace.com"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:tns="http://apiNamespace.com"
xmlns:data="http://dataNamespace.com"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/">
<types>
<schema
targetNamespace="http://refNamespace.com"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:tns="http://refNamespace.com">
<element name="RefDataElem" type="int"/>
</schema>
<schema
targetNamespace="http://dataNamespace.com"
xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:ref="http://refNamespace.com"
xmlns:tns="http://dataNamespace.com"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<import namespace="http://refNamespace.com"/>
<complexType name="Data">
<sequence>
<element name="data1" type="int"/>
<element name="data2" type="int"/>
</sequence>
</complexType>
<element name="DataElem" nillable=
"true" type="tns:Data"/>
<complexType name="Data2">
<sequence>
<element ref="ref:RefDataElem"/>
</sequence>
</complexType>
</schema>
</types>
<message name="op1Request">
<part name="in" type="data:Data"/>
</message>
<message name="op1Response">
<part name="op1Return"
type="data:Data"/>
</message>
<message name="op2Request">
<part name="in" type="data:Data"/>
</message>
<message name="op2Response">
<part name="op2Return" type="data:Data"/>
</message>
<message name="op3Request">
<part name="in1" element="data:DataElem"/>
<part name="in2" type="data:Data2"/>
</message>
<message name="op3Response">
<part name="op3Return" type="data:Data2"/>
</message>
<portType name="Sample">
<operation name="op1">
<input message="tns:op1Request"/>
<output message="tns:op1Response"/>
</operation>
<operation name="op2">
<input message="tns:op2Request"/>
<output message="tns:op2Response"/>
</operation>
<operation name="op3">
<input message="tns:op3Request"/>
<output message="tns:op3Response"/>
</operation>
</portType>
<binding name="SampleSoapBinding" type="tns:Sample">
<wsdlsoap:binding style="rpc" transport=
"http://schemas.xmlsoap.org/soap/http"/>
<operation name="op1">
<wsdlsoap:operation soapAction=""/>
<input>
<wsdlsoap:body namespace=
"http://apiNamespace.com" use="literal"/>
</input>
<output>
<wsdlsoap:body namespace=
"http://apiNamespace.com" use="literal"/>
</output>
</operation>
<operation name="op2">
<wsdlsoap:operation soapAction=""/>
<input>
<wsdlsoap:body namespace=
"http://op2Namespace.com" use="literal"/> </input>
<output>
<wsdlsoap:body namespace=
"http://op2Namespace.com" use="literal"/>
</output>
</operation>
<operation name="op3">
<wsdlsoap:operation soapAction=""/>
<input>
<wsdlsoap:body use="literal"/>
</input>
<output>
<wsdlsoap:body use="literal"/>
</output>
</operation>
</binding>
<service name="SampleService">
<port binding="tns:SampleSoapBinding" name=
"Sample">
<wsdlsoap:address location=
"http://localhost:9080/RPCNamespaces/services/Sample"/>
</port>
</service>
</definitions>
WS-I 遵从性 WS-I(参见参考资料)为 WSDL 定义遵从性标准。从两个方面来讲,op3 不遵从 RPC/literal WSDL:它并不在绑定的 wsdlsoap:body 中定义命名空间;它的消息部分引用了元素,而不是类型。在此提出是为了展示可以用 WS-I 的 Basic Profile 解决的一些命名空间问题。
查看用于每个操作的绑定的 wsdlsoap:body 元素中的命名空间。op1 和 op2 是规则 1.1 的实例(参见以下有关 SOAP 消息的内容)。op3 是规则 1.2 的实例。op1 展示了使用 targetNamespace 的常规实例――在这种情况下是“http://apiNamespace.com”――作为该操作的命名空间,但是这仅仅是通常情况。op2 使用的命名空间将不会在 WSDL 中的其他任何地方被使用。op3 无需定义任何命名空间。
清单 2、3 和 4 分别展示了 op1、op2 和 op3 的 SOAP 消息。注意消息中用粗体强调的命名空间。
清单 2. op1 的 RPC/literal 请求/响应 SOAP 消息
<soapenv:Envelope xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<p582:op1 xmlns:p582="http://apiNamespace.com">
<in>
<data1>1</data1>
<data2>2</data2>
</in>
</p582:op1>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Envelope xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<p582:op1Response xmlns:p582=
"http://apiNamespace.com">
<op1Return>
<data1>10</data1>
<data2>20</data2>
</op1Return>
</p582:op1Response>
</soapenv:Body>
</soapenv:Envelope>
在上文中已经提及,清单 2 中的 SOAP 消息遵从规则 1.1。op1 的命名空间为“http://apiNamespace.com”。这些消息同样遵从规则 2.2。所有参数数据都不通过根元素定义,仅仅是根类型――数据――以及它的子元素。既然没有使用根元素,那么这些元素都是不合要求的。
清单 3. op2 的 RPC/literal 请求/响应 SOAP 消息
<soapenv:Envelope xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<p999:op2 xmlns:p999=
"http://op2Namespace.com">
<in>
<data1>3</data1>
<data2>4</data2>
</in>
</p999:op2>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Envelope xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<p999:op2Response xmlns:p999=
"http://op2Namespace.com">
<op2Return>
<data1>300</data