リファレンス ガイド

Oracle SALT WS-ReliableMessaging ポリシー アサーションのリファレンス

以下の節では、SALT WS-ReliableMessaging (WS-RM) ポリシー リファレンス情報を説明します。

概要

Oracle SALT では、WS-ReliableMessaging 仕様 (WS-ReliableMessaging 1.0、2005 年 2 月) をサポートしています。WS-ReliableMessaging 仕様により、異なる GWWS インスタンスで動作している 2 つの Web サービス アプリケーションが、ソフトウェア コンポーネント、システムまたはネットワーク障害などの場合にも信頼性のある方法で通信できます。

WS-ReliableMessaging ポリシー アサーションを含む WS-ReliableMessaging ポリシー ファイルを使用して送信先エンドポイントで GWWS サーバの信頼性のあるメッセージングの機能をコンフィグレーションします。SALT では、Oracle WebLogic 9.x/10 との相互運用性を確認するために WS-ReliableMessaging ポリシー アサーションの仕様をサポートしています。

信頼性のある GWWS サーバのコンフィグレーションの詳細については、Oracle SALT の『管理ガイド』の「高度な Web サービス メッセージング機能のコンフィグレーション」を参照してください。

WS-RM ポリシー アサーションの書式

図 C-1 に、WS-Policy ファイルでの WS-ReliableMessaging ポリシー アサーションの書式のグラフィカルな表現を示します。

WS-RM アサーション ファイルの例

コード リスト C-1 に、WS-RM ポリシー アサーションを含む WS-Policy ファイルの例を示します。

<?xml version="1.0"?>
<wsp:Policy wsp:Name="ReliableSomeServicePolicy"
  xmlns:wsrm="http://schemas.xmlsoap.org/ws/2005/02/rm"
  xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
  xmlns:beapolicy="http://www.bea.com/wsrm/policy">
  <wsrm:RMAssertion>
    <wsrm:InactivityTimeout Milliseconds="600000" />
    <wsrm:BaseRetransmissionInterval Milliseconds="500"/>
    <wsrm:ExponentialBackoff />
    <wsrm:AcknowledgementInterval Milliseconds="2000" />
    <beapolicy:Expires Expires="P1D" />
    <beapolicy:QOS QOS="ExactlyOnce InOrder" />
  </wsrm:RMAssertion>
</wsp:Policy>

WS-RM アサーション要素の説明

すべての RM アサーションは省略可能であり、指定しない場合はデフォルト値が使用されます。RM アサーションのオプションについての説明を以下に示します。

<wsrm:InactivityTimeout>

非アクティブ時のタイムアウトが発生するまでの時間間隔 (ミリ秒) を Milliseconds 属性によって指定します。送信先エンドポイントが送信元エンドポイントからのメッセージを受け取ることなく指定の時間が経過した場合、送信先エンドポイントでは、アクティブでないことを理由に現在のシーケンスを終了することが可能です。また、送信元エンドポイントでもこのパラメータを使用できます。

デフォルトでは、シーケンスのタイムアウトは発生しません。

<wsrm:AcknowledgementInterval>

送信先エンドポイントがスタンドアロンの確認応答を伝送する義務がある最長の時間間隔 (ミリ秒) を指定します。

この要素は省略可能です。この要素は指定しない場合、デフォルトでは時間制限はありません。

<wsrm:BaseRetransmissionInterval>

送信元エンドポイントがメッセージを伝送した後でそのメッセージの確認応答が返されるのを待つ時間間隔 (ミリ秒) を指定します。確認応答が得られず指定の時間が経過した場合、送信元エンドポイントで再伝送が実行されます。この値は、GWWS サーバが発信シーケンスにおいて応答を送信する場合に適用されます。

デフォルト値は 20000 ミリ秒です。

<wsrm:ExponentialBackoff>

再伝送までの時間間隔を、指数的バックオフ アルゴリズムに基づいて調整することを指定します。この値は、GWWS サーバが発信シーケンスにおいて応答を送信する場合に適用されます。

<beapolicy:Expires>

信頼性のある Web サービスの有効期限が終了して新しいシーケンス メッセージを受け付けなくなるまでの時間を指定します。

この要素にはただ 1 つ Expires という属性があり、そのデータ型は XML スキーマの duration 型です。たとえば、有効期限を 1 日に設定するには以下のようにします。

< beapolicy:Expires Expires="P1D" />

デフォルト値は、有効期限なしです。

<beapolicy:QOS>

配信の保証方法を指定します。SALT では以下の種類がサポートされています。

デフォルト値は「ExactlyOnce InOrder」です。

<wsrm:RMAssertion>

単一要素の下で全の他のアサーションをグループする主な WS-RM アサーションです。

WS-Policy ファイルでのこのアサーションの存在は、対応する Web サービス アプリケーションを信頼性のある方法で呼び出す必要があることを示します。