Web Services Resource Framework のリソース・プロパティーとライフサイクル・オペレーション

Web Services Resource Framework (WSRF) 仕様には、リソース・プロパティー文書を操作して、リソースの状態を取得、設定、または照会する際に Web Services Resource (WS-Resource) が実装できるオペレーションが記述されています。

Web Services Resource Framework (WSRF) によって定義される標準のプロパティー および存続時間のすべてのオペレーションに関する詳細については、WS-ResourceProperties 仕様および WS-ResourceLifetime 仕様を参照してください。 Web Services Resource (WS-Resource) が サポートできる主な WSRF オペレーションについて、以下の表で説明します。

表 1. WS-Resources がサポートする主な WSRF オペレーション. 表は、主な WSRF オペレーションをリストし、メッセージおよび応答フォーマットを含むそれぞれの説明を提供します。
オペレーション 説明
GetResourcePropertyDocument WS-Resource の完全なリソース・プロパティー文書を戻します。
メッセージ・フォーマット
<wsrf-rp:GetResourcePropertyDocument/>
応答フォーマット
<wsrf-rp:GetResourcePropertyDocumentResponse>
  {any}
</wsrf-rp:GetResourcePropertyDocumentResponse>
ここで、{any} は リソース・プロパティー文書のコンテンツです。
PutResourcePropertyDocument WS-Resource の完全なリソース・プロパティー文書を、指定した文書で置き換えます。
メッセージ・フォーマット
<wsrf-rp:PutResourcePropertyDocument>
  {any}
</wsrf-rp:PutResourcePropertyDocument>
ここで、{any} は 新規リソース・プロパティー文書のコンテンツです。
応答フォーマット
<wsrf-rp:PutResourcePropertyDocumentResponse>
  {any} ?
</wsrf-rp:PutResourcePropertyDocumentResponse>
ここで、{any} は 新規リソース・プロパティー文書のコンテンツです。 コンテンツが要求されたコンテンツと同じなら、 {any} エレメントは指定しないでください。
GetResourceProperty WS-Resource のリソース・プロパティー文書内で見つかった、 指定されたリソース・プロパティーの値を戻します。
メッセージ・フォーマット
<wsrf-rp:GetResourceProperty>
  QName
</wsrf-rp:GetResourceProperty>
応答フォーマット
<wsrf-rp:GetResourcePropertyResponse>
  {any}*
</wsrf-rp:GetResourcePropertyResponse>
ここで、{any}* は要求で指定した QName と一致するエレメントのシーケンスです。
GetMultipleResourceProperties WS-Resource のリソース・プロパティー文書内で見つかった、 指定されたリソース・プロパティーの値を戻します。
メッセージ・フォーマット
<wsrf-rp:GetMultipleResourceProperties>
  <wsrf-rp:ResourceProperty>QName<wsrf-rp:ResourceProperty>+
</wsrf-rp:GetMultipleResourceProperties>
応答フォーマット
<wsrf-rp:GetMultipleResourcePropertiesResponse>
  {any}*
</wsrf-rp:GetMultipleResourcePropertiesResponse>
ここで、{any}* は要求で指定した QNames と一致するエレメントのシーケンスです。
InsertResourceProperties WS-Resource のリソース・プロパティー文書に、指定したリソース・プロパティー・エレメントを挿入します。
メッセージ・フォーマット
<wsrf-rp:InsertResourceProperties>
  <wsrf-rp:Insert>
    {any}*
  </wsrf-rp:Insert> 
</wsrf-rp:InsertResourceProperties>
ここで、{any}* は同じ QName を持つエレメントのシーケンスです。
応答フォーマット
<wsrf-rp:InsertResourcePropertiesResponse/>
UpdateResourceProperties 指定したリソース・プロパティー・エレメントを、WS-Resource のリソース・プロパティー文書に更新します。
メッセージ・フォーマット
<wsrf-rp:UpateResourceProperties>
  <wsrf-rp:Upate>
    {any}*
  </wsrf-rp:Upate> 
</wsrf-rp:UpateResourceProperties>
ここで、{any}* は同じ QName を持つエレメントのシーケンスです。
応答フォーマット
<wsrf-rp:UpateResourcePropertiesResponse/>
DeleteResourceProperties 指定したリソース・プロパティー・エレメントを、WS-Resource のリソース・プロパティー文書から削除します。
メッセージ・フォーマット
<wsrf-rp:DeleteResourceProperties>
  <wsrf-rp:Delete ResourceProperty="QName"/>
</wsrf-rp:DeleteResourceProperties>
ここで、QName は削除する リソース・プロパティーの QName です。
応答フォーマット
<wsrf-rp:DeleteResourcePropertiesResponse/>
QueryResourceProperties XPath などの照会式を使用して、リソース・プロパティー文書を照会します。
メッセージ・フォーマット
<wsrf-rp:QueryResourceProperties>
  <wsrf-rp:QueryExpression 
           Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116">
    xsd:any
  </wsrf-rp:QueryExpression>
</wsrf-rp:QueryResourceProperties>
ここで、xsd:any は、リソース・プロパティー文書に適用される XPath 照会式です。
応答フォーマット
<wsrf-rp:QueryResourcePropertiesResponse>
  {any}
</wsrf-rp:QueryResourcePropertiesResponse>
ここで、{any} はリソース・プロパティー文書に対して照会式を実行した結果です。
Destroy WS-Resource を破棄します。
メッセージ・フォーマット
<wsrf-rl:Destroy/>
応答フォーマット
<wsrf-rl:DestroyResponse/>
この応答は、 WS-Resource の破棄が正常に行われたことを示しています。
SetTerminationTime スケジュール設定された終了をサポートしている WS-Resource では、 このオペレーションを実装することにより、リクエスターによる、WS-Resource の破棄時刻の変更が可能になります。
メッセージ・フォーマット
<wsrf-rl:SetTerminationTime>
  [<wsrf-rl:RequestedTerminationTime>
    xsd:dateTime
  </wsrf-rl:RequestedTerminationTime>] 
    | 
  [<wsrf-rl:RequestedLifetimeDuration> 
    xsd:duration
  </wsrf-rl:RequestedLifetimeDuration>]
</wsrf-rl:SetTerminationTime>
ここで、終了時刻は絶対時刻か相対的な継続時間のいずれかです。
応答フォーマット
<wsrf-rl:SetTerminationTimeResponse>
  <wsrf-rl:NewTerminationTime>
    xsd:dateTime
  </wsrf-rl:NewTerminationTime>
  <wsrf-rl:CurrentTime>
    xsd:dateTime
  </wsrf-rl:CurrentTime>
<wsrf-rl:SetTerminationTimeResponse>
この応答には、WS-Resource から見た、WS-Resource の 破棄時刻が含まれています。また、現在時刻の WS-Resource 値も含まれています。

WS-Resource は、さまざまな方法で、スケジュール設定された破棄を実施することができます。 例えば、エンタープライズ Bean として 実装されている WS-Resource は、javax.ejb.TimedObject インターフェースの ejbTimeout コールバック・メソッドを実装 し、スケジュール設定された破棄時刻に期限切れになってこのコ ールバック・メソッドを起動する Timer オブジェクトを作成することで、 エンタープライズ Bean コンテナー・タイマー・サービスを使用できるようになります。 EJB タイマー・サービスの Timer オブジェクトは、サーバーの再始動後も保持されます。したがって、ライフサイクルに限界があるため時間に基づく破棄のメカニズムが必要な WS-Resource のライフサイクルを簡単に管理することができます。


トピックのタイプを示すアイコン 概念トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_wsrf_ops
ファイル名:cwbs_wsrf_ops.html