WebSphere Enterprise Service Bus for z/OS バージョン 6.2.0 オペレーティング・システム: z/OS


JCA 対話仕様および接続仕様の動的プロパティー

EIS バインディングは、ペイロードに付随する明確に定義された子データ・オブジェクトを使用することによって指定された InteractionSpec および ConnectionSpec に対する入力を受け入れることができます。これにより、InteractionSpec を介した リソース・アダプターとの動的要求応答対話と、ConnectionSpec を介した コンポーネント認証が可能になります。

javax.cci.InteractionSpec は、リソース・アダプターとの 対話要求の処理方法に関する情報を保持します。また、要求後に 対話を行う方法に関する情報も保持します。対話によるこれらの両方向通信は、会話とも呼ばれます。

EIS バインディングはペイロードを必要とします。このペイロードは、properties という子データ・オブジェクトを格納するためのリソース・アダプターに対する引数になります。このプロパティー・データ・オブジェクトは、名前と値のペアを含みます。この名前は、特定のフォーマットでの対話仕様プロパティーの名前になります。フォーマット設定の規則は以下のとおりです。

この例ではインターフェースによって、操作の入力は「Account」データ・オブジェクトと指定されます。このインターフェースは、値が xyz である workingSet という動的 InteractionSpec プロパティーを送受信するために、EIS インポート・バインディング・アプリケーションを呼び出します。

サーバーのビジネス・グラフまたはビジネス・オブジェクトには下位の「properties」ビジネス・オブジェクトが含まれていて、このビジネス・オブジェクトによってペイロードを持つプロトコル固有データを送信できます。この properties ビジネス・オブジェクトは組み込みのものであり、ビジネス・オブジェクトを構成するときに XML スキーマで指定する 必要はありません。単に作成するだけで 使用できます。XML スキーマに基づいて独自のデータ型を定義している場合は、必要な名前と値のペアを含む properties エレメントを指定する必要があります。
 BOFactory dataFactory = (BOFactory) ¥
 serviceManager.locateService("com/ibm/websphere/bo/BOFactory");
  //Wrapper for doc-lit wrapped style interfaces,
  //skip to payload for non doc-lit
  DataObject docLitWrapper = dataFactory.createByElement /
  ("http://mytest/eis/Account", "AccountWrapper");
ペイロードを作成します。
DataObject account = docLitWrapper.createDataObject(0);
  DataObject accountInfo = account.createDataObject("AccountInfo");
  //Perform your setting up of payload


  //Construct properties data for dynamic interaction
  
  DataObject properties = account.createDataObject("properties");
名前 workingSet に対して予想される値 (xyz) を設定します。
properties.setString("ISworkingSet", "xyz");


  //Invoke the service with argument

  Service accountImport = (Service) ¥
  serviceManager.locateService("AccountOutbound");
  DataObject result = accountImport.invoke("createAccount", docLitWrapper);               

  //Get returned property
  DataObject retProperties = result.getDataObject("properties");

  String workingset = retProperties.getString("ISworkingSet");
ConnectionSpec プロパティーは動的 コンポーネント認証に使用できます。上記と同じ規則が適用されます。ただし、プロパティー名のプレフィックスは CS にする必要があります (IS ではありません)。ConnectionSpec プロパティーは 両方向ではありません。同じ properties データ・オブジェクトに IS プロパティーと CS プロパティーの 両方を入れることができます。

ConnectionSpec プロパティーを使用するには、 インポート・バインディングで指定する resAuth を「Application」に設定します。 また、リソース・アダプターがコンポーネント許可をサポートする必要があります。詳しくは、J2EE Connector Architecture Specification の第 8 章を参照してください。


concept 概念トピック

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


タイムスタンプ・アイコン 最終更新: 2010/07/05


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.zseries.doc/doc/cadm_dynamicheader.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています (http://www.eclipse.org)。