WS-Policy 構成クラスの詳細

<configuration>

<configuration> 要素は、XData ブロックのルート要素です。この要素には次の項目が含まれます。

<service>

<service> 要素は、ポリシーを Caché Web サービスまたは Web クライアントに関連付けます。この要素には次の項目が含まれます。

以下はその例です。

<cfg:configuration 
xmlns:cfg="http://www.intersystems.com/configuration" 
xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702" 
xmlns:wsap="http://www.w3.org/2006/05/addressing/wsdl" 
xmlns:wsp="http://www.w3.org/ns/ws-policy" 
name="service">
  <cfg:service classname="DemoPolicies.NoSecurity">
    <wsp:Policy>
      <wsap:UsingAddressing/>
    </wsp:Policy>
  </cfg:service>
</cfg:configuration>

<service> の子である <wsp:Policy> または <wsp:PolicyReference> 内で、cfg:wsdlElement 属性を指定できます。この属性は、このポリシー要素の添付先となる WSDL のパートを指定するものです。このコンテキストでは、この属性に次のいずれの値も指定できます。

• "service" — このポリシー要素を WSDL <service> 要素に添付します。

• "port" — このポリシー要素を WSDL <port> 要素に添付します。

• "binding" (既定) — このポリシー要素を WSDL <binding> 要素に添付します。

• "portType" — このポリシー要素を WSDL <portType> 要素に添付します。

<method>

<method> 要素は、親の <service> 要素によって指定された Web サービスまたはクライアント内の特定の Web メソッドにポリシーを関連付けます。<method> 要素には次の項目が含まれます。

<method> の子である <wsp:Policy> または <wsp:PolicyReference> 内で、cfg:wsdlElement attribute 属性を指定できます。この属性は、このポリシー要素の添付先となる WSDL のパートを指定するものです。このコンテキストでは、この属性に次のいずれの値も指定できます。

• "binding" (既定) — このポリシー要素を WSDL <binding> 要素に添付します。

• "portType" — このポリシー要素を WSDL <portType> 要素に添付します。

<request>

<request> 要素は、親の <method> 要素が参照する Web メソッドの要求メッセージにポリシーを関連付けます。<request> 要素には次の項目が含まれます。

<request> の子である <wsp:Policy> または <wsp:PolicyReference> 内で、cfg:wsdlElement 属性を指定できます。この属性は、このポリシー要素の添付先となる WSDL のパートを指定するものです。このコンテキストでは、この属性に次のいずれの値も指定できます。

• "binding" (既定) — このポリシー要素を WSDL <binding> 要素に添付します。

• "portType" — このポリシー要素を WSDL <portType> 要素に添付します。

• "message" — このポリシー要素を WSDL <message> 要素に添付します。

<response>

<response> 要素は、親の <method> 要素が参照する Web メソッドの応答メッセージにポリシーを関連付けます。<response> 要素には次の項目が含まれます。

<response> の子である <wsp:Policy> または <wsp:PolicyReference> 内で、cfg:wsdlElement 属性を指定できます。この属性は、このポリシー要素の添付先となる WSDL のパートを指定するものです。このコンテキストでは、この属性に次のいずれの値も指定できます。

• "binding" (既定) — このポリシー要素を WSDL <binding> 要素に添付します。

• "portType" — このポリシー要素を WSDL <portType> 要素に添付します。

• "message" — このポリシー要素を WSDL <message> 要素に添付します。

代替ポリシーを使用した構成

次の構成クラスには、2 つの代替ポリシー、すなわち WS-Addressing ヘッダを使用するものと使用しないものが含まれています。

/// PolicyAlternatives.DivideWSConfig
Class PolicyAlternatives.DivideWSConfig Extends %SOAP.Configuration
{

XData service
{
<cfg:configuration xmlns:cfg="http://www.intersystems.com/configuration" 
xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702" 
xmlns:wsap="http://www.w3.org/2006/05/addressing/wsdl" 
xmlns:wsp="http://www.w3.org/ns/ws-policy" 
name="service">
  <cfg:service classname="PolicyAlternatives.DivideWS">
   <wsp:Policy>
     <wsp:ExactlyOne>
       <wsp:All>
         <wsap:UsingAddressing/>
       </wsp:All>
       <wsp:All>
         <wsp:Policy/>
       </wsp:All>
     </wsp:ExactlyOne>
    </wsp:Policy>
  </cfg:service>
</cfg:configuration>
}

}

WS-Addressing を必要とするポリシーが添付されている Web クライアントで使用されると、この Web サービスは、WS-Addressing ヘッダを持つメッセージで応答します。WS-Addressing を使用しないポリシーのクライアントで使用されると、この Web サービスは、WS-Addressing ヘッダを持たないメッセージで応答します。

別のシナリオとしては、あるポリシーでは SSL/TLS を必要とし、別なポリシーではメッセージの暗号化を使用する (X.509 相互証明書セキュリティ ポリシーなど) といったものがあります。

ポリシー参照を使用した構成

次の構成クラスには、2 つの XData ブロックが含まれています。1 つには、ID 属性が mypolicy であるポリシーが含まれており、もう 1 つには、Web サービスの構成が含まれています。この構成は、他の XData ブロックにあるポリシーを参照します。

Class DemoPolicies.WithReferenceConfig Extends %SOAP.Configuration
{

XData service
{
<cfg:configuration 
xmlns:cfg="http://www.intersystems.com/configuration"  
xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702" 
xmlns:wsp="http://www.w3.org/ns/ws-policy" 
name="service">
  <cfg:service classname="DemoPolicies.WithReference">
    <wsp:PolicyReference URI="#mypolicy">
    </wsp:PolicyReference>
  </cfg:service>
</cfg:configuration>
}

XData Policy1
{
<wsp:Policy 
  xmlns:wsp="http://www.w3.org/ns/ws-policy" 
  xmlns:wsu="http://schemas.xmlsoap.org/ws/2003/06/utility"
  xmlns:wsap="http://www.w3.org/2006/05/addressing/wsdl" 
  xmlns:wsoma="http://schemas.xmlsoap.org/ws/2004/09/policy/optimizedmimeserialization" 
  wsu:Id="mypolicy">
 <wsap:UsingAddressing/>
 <wsoma:OptimizedMimeSerialization/>
</wsp:Policy>
}

}

この例では、ポリシー式は Policy1 という名前の XData ブロックに含まれています。このブロックの名前は、WSDL または SOAP の操作に影響しません。