服务热线:13616026886

技术文档 欢迎使用技术文档,我们为你提供从新手到专业开发者的所有资源,你也可以通过它日益精进

位置:首页 > 技术文档 > JAVA > 新手入门 > 基础入门 > 查看文档

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


  引言
  
  在典型的 web 服务场景中,通常使用工具技术来处理命名空间的所有细微差别。但是有些时候,特别是在使用 saaj(soap with attachments api for java)为特定的 web 服务构造 soap 消息时,您必须自己处理命名空间问题。在没有任何工具辅助的情况下构造消息?d?d或是部分消息时?d?d可以使用该技巧。
  
  虽然命名空间看似复杂,但您真正只需要掌握的是以下一份简短的规则清单:
  
  如果 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?”?d?d参见参考资料。)
  
  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 的常规实例?d?d在这种情况下是“http://apinamespace.com”?d?d作为该操作的命名空间,但是这仅仅是通常情况。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。所有参数数据都不通过根元素定义,仅仅是根类型?d?d数据?d?d以及它的子元素。既然没有使用根元素,那么这些元素都是不合要求的。
  
  清单 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

扫描关注微信公众号