WebSphere Application Server Network Deployment for i5/OS, Version 6.1   
             オペレーティング・システム: i5/OS

             目次と検索結果のパーソナライズ化

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 オペレーション
オペレーション 説明
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 のライフ・サイクルを簡単に管理することができます。




関連概念
Web Services Addressing サポート
Web Services Resource Framework サポート
関連タスク
Web サービス・リソース・フレームワークを使用したステートフル Web サービスの作成
参照トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 8:28:52 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.iseries.doc/info/iseriesnd/ae/rwbs_wsrf_ops.html