WSDL 设计 XML 模式注意事项(二)

日期: 2007-12-17 作者:Shawn X. K. Hu 来源:TechTarget中国

  清单 2. Document 样式的 Employee 消息的 WSDL 定义
    

   <wsdl:message name="publishEmployeeServiceRequest">
     <wsdl:part name="employee" element="typeIn:Employee">
       <wsdl:documentation>publish employee data</wsdl:documentation>
     </wsdl:part>
   </wsdl:message>
   …

   <wsdl:binding … >
     <soap:binding … />
     <wsdl:operation name="publishEmployeeService">
       <soap:operation  style="document"/>
       <wsdl:input name="employee">
         <soap:body use="literal"/>
       </wsdl:input>
       …
     </wsdl:operation>
   </wsdl:binding>
   
  请注意,wsdl:binding 部分中的 wsdl:input "name" 属性的值与 wsdl:message 中的“name”属性的值相同,而后者引用了 Employee 元素。typeIn 是输入模式 targetNamespace 的前缀,而 Employee 为模式的根元素。

  Russian Doll 模式提供了具有最低扩展性的模式结构。在上面列出的示例中,除了根元素之外的所有组件均已本地化,不能进行重用。此模式适合在 Document 样式的 WSDL 中使用,但并不适合 RPC 样式,因为未定义全局级别的类型。同样,“类型”也是 WS-I BP 对 RPC 绑定样式的一个限制。

  此外,此模式还不用于 WSDL 中可能需要扩展元素的情况,如为消息定义使用模式元素 ErpAddress 时。ErpAddress 是 XML 模式中的一个元素,但是并不位于全局级别。

  Salami Slice

  顾名思义,Salami Slice 模式将 XML 模式划分为具有更多全局级别元素的“片”。此模式非常适合 Document 样式的 WSDL,其灵活性高于 Russian Doll 样式。以下模式包含与 Russian Doll 模式相同的 Employee 信息,但采用不同的方式对其进行表示。

  清单 3. 采用 Slice pattern 模式的示例 XSD
    
<xs:element name="Employee">
    <xs:complexType>
      <xs:sequence>
 <xs:element ref="ErpPerson"/>
 <xs:element ref="ErpAddress"/>
      </xs:sequence>
    </xs:complexType>
</xs:element>
<xs:element name="ErpPerson">
    <xs:complexType mixed="false">
      <xs:sequence>
 <xs:element name="lastName" type="xs:string"/>
 <xs:element name="firstName" type="xs:string"/>
 <xs:element name="mName" type="xs:string"/>
      </xs:sequence>
    </xs:complexType>
</xs:element>
<xs:element name="ErpAddress">
    <xs:complexType mixed="false">
      <xs:sequence>
 <xs:element name="streetNumber" type="xs:string"/>
 <xs:element name="streetName" type="xs:string"/>
 <xs:element name="suiteNumber" type="xs:string"/>
 <xs:element name="city" type="xs:string"/>
 <xs:element name="stateOrProvince" type="xs:string"/>
 <xs:element name="country" type="xs:string"/>
 <xs:element name="postalCode" type="xs:string"/>
      </xs:sequence>
    </xs:complexType>
</xs:element>

  ErpPerson 和 ErpAddress 元素实际上可以进一步进行“切分”,以获得更多的元素粒度级别,但为了简单起见,我们仅到此为止。

  现在 ErpPerson 和 ErpAddress 成为了模式中的全局级别元素,是能够在其他组件(如元素“Employee”)中引用的可重用组件。而且,使用 Salami Slice 模式的一个好处就是可以在 WSDL 定义中引用更多的元素。例如,现在可以在 WSDL 中将 ErpPerson 和 ErpAddress 分别用于为 ErpPerson 和 ErpAddress 有效负载定义 Document 样式的消息。

  简要总结一下,Salami Slice 模式中的 Employee 模式可用于使用以下消息定义 WSDL:

  Document 绑定样式的 Employee 消息
  Document 绑定样式的 ErpPerson 消息
  Document 绑定样式的 ErpAddress 消息

  以下是上面所列出的内容对应的 WSDL 消息和绑定定义:

 

 

我们一直都在努力坚持原创.......请不要一声不吭,就悄悄拿走。

我原创,你原创,我们的内容世界才会更加精彩!

【所有原创内容版权均属TechTarget,欢迎大家转发分享。但未经授权,严禁任何媒体(平面媒体、网络媒体、自媒体等)以及微信公众号复制、转载、摘编或以其他方式进行使用。】

微信公众号

TechTarget微信公众号二维码

TechTarget

官方微博

TechTarget中国官方微博二维码

TechTarget中国

相关推荐