当前位置: 王朝网络 >> other >> 手工创建的SOAP消息中命名空间的处理

手工创建的SOAP消息中命名空间的处理

王朝other·作者佚名 2008-05-31

引言

在典型的 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

<data11</data1

<data22</data2

</in

</p582:op1

</soapenv:Body