Понимание WS-Policy, часть II: правила составления оператора и приложения

<wsp:Policy>
  <wsp:PolicyReference URI="#reliability-policy"/>
  <wsam:Addressing>
<wsp:Policy/>
</wsam:Addressing>
</wsp:Policy>

<wsp:Policy wsu:Id="reliability-policy">
  <wsrmp:RMAssertion>
<wsp:Policy/>
</wsrmp:RMAssertion>
</wsp:Policy>

В этом примере содержимое выражения политики, озаглавленного «надежность-политика», включено в верхнее выражение политики, что приведет к составной политике, состоящей из обоих типов утверждений: wsrmp: RMAssertion и wsam: Addressing .

Использование значения wsu: Id было введено в начале этой главы в разделе « Новые пространства имен и префиксы ». Это очень похоже на атрибут расширяемости, так как позволяет назначать идентификатор выражению политики, чтобы на него можно было ссылаться в другом месте.

Встроенные вложения
Чтобы встроить выражение политики в документ WSDL, мы просто добавляем код политики в конструкцию определений WSDL вместе с требуемым пространством имен, как указано выделенными разделами в этом примере.

<definitions targetNamespace=
  "http://actioncon.com/contract/po"
  xmlns="http://schemas.xmlsoap.org/wsdl/"
  xmlns:tns="http://actioncon.com/contract/po"
  xmlns:po="http://actioncon.com/schema/po"
  xmlns:soap11bind="http://schemas.xmlsoap.org/wsdl/soap/"
  xmlns:soap12bind="http://schemas.xmlsoap.org/wsdl/soap12/"
  xmlns:wsp="http://www.w3.org/2006/07/ws-policy"
  xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata"
  xmlns:wsrmp="http://docs.oasis-open.org/ws-rx/wsrmp/200702"
  xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-
    200401-wss-wssecurity-utility-1.0.xsd">
    ...
    ...
    ...
  <wsp:Policy wsu:Id="composite-policy">
    <wsp:PolicyReference URI="#security-policy"/>
    <wsam:Addressing>
<wsp:Policy/>
</wsam:Addressing>
    <wsrmp:RMAssertion optional="true"/>
  </wsp:Policy>
  <wsp:Policy wsu:Id="security-policy">
    ...
  </wsp:Policy>
</definitions>

Возможно, вы заметили следующую дополнительную строку кода в первом утверждении встроенной политики предыдущего примера:

<wsp:PolicyReference URI="#security-policy"/> 

Здесь мы видим, что элемент wsp: PolicyReference снова используется в качестве механизма включения между двумя отдельными выражениями политики. Хотя предыдущий пример показал, что этот элемент включает содержимое политики в выражения политики, он также используется при привязке встроенных утверждений политики к элементам WSDL, как показано в следующем примере.

<binding name="bdPO-SOAP12HTTP" type="tns:ptPurchaseOrder">
  <wsp:PolicyReference URI="#composite-policy"/>
  <soap12bind:binding style="document"
    transport="http://schemas.xmlsoap.org/soap/http"/>
  <operation name="opSubmitOrder">
    <soap12bind:operation
      soapAction="http://action.com/submitOrder/request"
      soapActionRequired="true" required="true"/>
    <input>
      <soap12bind:body use="literal"/>
    </input>
    <output>
      <soap12bind:body use="literal"/>
    </output>
  </operation>
  ...
</binding> 

Здесь конструкция привязки WSDL содержит элемент расширяемости, состоящий из элемента wsp: PolicyReference, который устанавливает ссылку на выражение политики, называемое «составной-политикой».

Обратите внимание, что код выражения «составная политика» мог быть просто встроен непосредственно в конструкцию привязки WSDL . Поскольку был использован элемент wsp: PolicyReference , теперь это выражение можно использовать в другом месте в определении WSDL. Например, вы заметите, что этот пример состоит из привязки для SOAP 1.2. Если документ WSDL также поддерживает SOAP 1.1, то же утверждение политики можно было бы повторно использовать, добавив тот же элемент wsp: PolicyReference к привязке SOAP 1.1.

Полное определение WSDL с приложенным выражением политики

Одна из причин, по которой Стив изначально разработал контракт веб-службы для службы заказов на покупку, чтобы включить привязки SOAP 1.1 и 1.2, заключается в том, что эта служба может учитывать потребителей разных типов. Те, кто поддерживает SOAP 1.2, обычно имеют более прогрессивные платформы и поэтому могут поддерживать дополнительные функции WS- *.

В частности, у Стива есть требование к службе использовать заголовки WS-Addressing (объяснено в Главе 18). Однако после переговоров с Кевином, техническим директором, возникло нежелание навязывать требование, чтобы все потребители поддерживали WS-адресацию. Поэтому Кевин и Стив решают, что только те потребители, которые общаются с сервисом через SOAP 1.2, также должны поддерживать обработку заголовков WS-Addressing, которые они будут проектировать.

Чтобы реализовать это новое требование, создается простое выражение политики, а определение WSDL обновляется в соответствии с выделенным кодом:

<definitions name="Purchase Order"
  targetNamespace="http://actioncon.com/contract/po
  xmlns:tns="http://actioncon.com/contract/po"
  xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
  xmlns:po="http://actioncon.com/schema/po"
  xmlns:soap11="http://schemas.xmlsoap.org/wsdl/soap/"
  xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
  xmlns:wsp="http://www.w3.org/2006/07/ws-policy"
  xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata"
  xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-
    200401-wss-wssecurity-utility-1.0.xsd">
  <documentation>
    This is an entity service responsible for purchase
    order-related processing only.
  </documentation>
  <types>
    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <xsd:import namespace=
        "http://actioncon.com/schema/po"
        schemaLocation="http://actioncon.com/schema/po.xsd"/>
    </xsd:schema>
  </types>
  <message name="msgSubmitOrderRequest">
    <part name="PurchaseOrder" element="po:purchaseOrder"/>
  </message>
  <message name="msgSubmitOrderResponse">
    <part name="Acknowledgement" element="po:acknowledgement"/>
  </message>
  <message name="msgCheckOrderRequest">
    <part name="PONumber" element="po:poNumber"/>
  </message>
  <message name="msgCheckOrderResponse">
    <part name="Status" element="po:status"/>
  </message>
  <message name="msgChangeOrderRequest">
    <part name="PurchaseOrder" element="po:purchaseOrder"/>
  </message>
  <message name="msgChangeOrderResponse">
    <part name="Acknowledgement" element="po:acknowledgement"/>
  </message>
  <message name="msgCancelOrderRequest">
    <part name="PONumber" element="po:poNumber"/>
  </message>
  <message name="msgCancelOrderResponse">
    <part name="Acknowledgement" element="po:acknowledgement"/>
  </message>
  <portType name="ptPurchaseOrder">
    <operation name="opSubmitOrder">
      <input message="tns:msgSubmitOrderRequest"/>
      <output message="tns:msgSubmitOrderResponse"/>
    </operation>
    <operation name="opCheckOrderStatus">
      <input message="tns:msgCheckOrderRequest"/>
      <output message="tns:msgCheckOrderResponse"/>
    </operation>
    <operation name="opChangeOrder">
      <input message="tns:msgChangeOrderRequest"/>
      <output message="tns:msgChangeOrderResponse"/>
    </operation>
    <operation name="opCancelOrder">
      <input message="tns:msgCancelOrderRequest"/>
      <output message="tns:msgCancelOrderResponse"/>
    </operation>
  </portType>
  <binding name="bdPO-SOAP11HTTP" type="tns:ptPurchaseOrder">
    <soap11:binding style="document"
      transport="http://schemas.xmlsoap.org/soap/http"/>
    <operation name="opSubmitOrder">
      <input>
        <soap11:body use="literal"/>
      </input>
      <output>
        <soap11:body use="literal"/>
      </output>
    </operation>
    <operation name="opCheckOrderStatus">
      <input>
        <soap11:body use="literal"/>
      </input>
      <output>
        <soap11:body use="literal"/>
      </output>
    </operation>
    <operation name="opChangeOrder">
      <input>
        <soap11:body use="literal"/>
      </input>
      <output>
        <soap11:body use="literal"/>
      </output>
    </operation>
    <operation name="opCancelOrder">
      <input>
        <soap11:body use="literal"/>
      </input>
      <output>
        <soap11:body use="literal"/>
      </output>
    </operation>
  </binding>
  <binding name="bdPO-SOAP12HTTP" type="tns:ptPurchaseOrder">
  <wsp:PolicyReference URI="#addressing-policy"/>
    <soap12:binding style="document"
      transport="http://schemas.xmlsoap.org/soap/http"/>
    <operation name="opSubmitOrder">
    <soap12:operation soapAction=
      "http://actioncon.com/submitOrder/request"
      soapActionRequired="true" wsdl:required="true"/>
      <input>
        <soap12:body use="literal"/>
      </input>
      <output>
        <soap12:body use="literal"/>
      </output>
    </operation>
    <operation name="opCheckOrderStatus">
    <soap12:operation soapAction=
      "http://actioncon.com/submitOrder/request"
      soapActionRequired="true" wsdl:required="true"/>
      <input>
        <soap12:body use="literal"/>
      </input>
      <output>
        <soap12:body use="literal"/>
      </output>
    </operation>
    <operation name="opChangeOrder">
    <soap12:operation soapAction=
      "http://actioncon.com/submitOrder/request"
      soapActionRequired="true" wsdl:required="true"/>
        <input>
          <soap12:body use="literal"/>
      </input>
      <output>
        <soap12:body use="literal"/>
      </output>
    </operation>
      <operation name="opCancelOrder">
        <soap12:operation soapAction=
          "http://actioncon.com/submitOrder/request"
          soapActionRequired="true" wsdl:required="true"/>
      <input>
        <soap12:body use="literal"/>
      </input>
      <output>
        <soap12:body use="literal"/>
      </output>
    </operation>
  </binding>
  <service name="svPurchaseOrder">
    <port name="purchaseOrder-http-soap11"
    binding="tns:bdPO-SOAP11HTTP">
    <soap11:address location=
      "http://actioncon.com/services/soap11/po"/>
    </port>
    <port name="purchaseOrder-http-soap12"
      binding="tns:bdPO-SOAP12HTTP">
      <soap12:address location=
        "http://actioncon.com/services/soap12/po"/>
    </port>
  </service>
  <wsp:Policy wsu:Id="addressing-policy">
    <wsam:Addressing><wsp:Policy/>
  </wsam:Addressing>
</wsp:Policy>
</definitions>