Blueprint リソース参照 [設定]

Blueprint コンポーネントは WebSphere® Application Server リソース参照にアクセスできます。各参照は Blueprint XML ファイルで宣言され、Java™ Platform, Enterprise Edition (Java EE) コネクター・アーキテクチャー (JCA) 認証別名を使用して保護することができます。 OSGi アプリケーション内の各バンドルは、複数の Blueprint XML ファイルのリソース参照の宣言をいくつでも含むことができます。

管理コンソールでこのパネルを表示するには、次のいずれかのパスをクリックします。

「アプリケーション」 > 「アプリケーション・タイプ」 > 「ビジネス・レベル・アプリケーション」 > application_name > [デプロイされるアセット] 追加 > 「アセットの追加」 > asset_name > ウィザード・ステップ: Blueprint リソース参照のバインド
「アプリケーション」 > 「アプリケーション・タイプ」 > 「ビジネス・レベル・アプリケーション」 > application_name > composition_unit_name > 「[追加プロパティー] Blueprint リソース参照」

「Blueprint リソース参照のバインド (Bind Blueprint resource references)」ウィザード・ステップおよび「Blueprint リソース参照」プロパティーは、バンドルに Blueprint リソース参照宣言が含まれている場合にのみ表示されます。

リソース参照を保護する場合、それらのリソース参照をバインドできる先は、アプリケーションがデプロイされた各サーバーまたはクラスターに存在する JCA 認証別名のみです。OSGi アプリケーションは、同じセキュリティー・ドメイン内にある複数のサーバーおよびクラスターにデプロイすることができます。そのため、各 JCA 認証別名は、ターゲット・サーバーおよびクラスターのセキュリティー・ドメイン内か、あるいはグローバル・セキュリティー・ドメイン内に存在する必要があります。

Blueprint XML ファイルにリソース参照を宣言する必要があります。以下に例を示します。

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" 
  xmlns:rr="http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference">
  <!-- Other Blueprint declarations ... -->
  
  <rr:resource-reference id="resourceRef" 
          interface="javax.sql.DataSource"
          filter="(osgi.jndi.service.name=jdbc/Account)">
    <rr:res-auth>Container</rr:res-auth>
    <rr:res-sharing-scope>Shareable</rr:res-sharing-scope>
  </rr:resource-reference>
</blueprint>

この宣言には、リソース参照 ID (例えば resourceRef)、サービス・フィルター (例えば jdbc/Account)、認証タイプ (例えば Container)、および共有設定 (例えば Shareable) が含まれます。

各バンドルの認証別名バインディングへの Blueprint リソース参照は、そのバンドルの META-INF ディレクトリー内のファイル ibm-eba-bnd.xml に保管されています。アセットとしてデプロイされるときに OSGi アプリケーションにこれらのファイルのいずれかが 1 つでも含まれる場合は、これらのファイルが、リソース参照のバインディング時に使用されるデフォルトの認証別名の値を提供します。以下に例を示します。

<eba-bnd>
  <resource-ref>
    <jndi-name>jdbc/Acount</jndi-name>
    <authentication-alias>Alias1</authentication-alias>
    <interface>javax.sql.DataSource</interface>
    <authentication>Container</authentication>
    <sharing-scope>Shareable</sharing-scope>
    <id>resourceRef</id>
  </resource-ref>
</eba-bnd>

一般プロパティー

複合バンドル ID

この ID は、EBA アセットが複合バンドルを使用する場合のみ表示されます。各複合バンドルは、Composite bundle archive (CBA)'composite.bundle.symbolic.name_composite.bundle.version' という形式のストリングで識別されます。複合バンドルの一部であるバンドルは、複合バンドル ID の下にリストされます。

複合バンドルのシンボル名: この複合バンドルのローカライズできない名前。
複合バンドルのバージョン: この複合バンドルのバージョン。

シンボル名とバージョンによって、複合バンドルを一意的に識別します。

バンドル ID

各バンドルは、そのバンドルのシンボル名およびバンドル・バージョンを含むストリングによって識別されます。複合バンドルの一部であるバンドルは、複合バンドル ID の下にリストされます。

バンドルのシンボル名

このバンドル用の、ローカライズできない名前。

バンドル・バージョン

このバンドルのバージョン。

バンドルのシンボル名とバンドルのバージョンによって、バンドルを一意的に識別します。

リソース参照 ID

Blueprint で宣言されたリソース参照の ID。

リソース参照インターフェース

このリソース参照用のインターフェース。

Blueprint アプリケーションでは以下のリソース・タイプのいずれも使用することができます。

デフォルトのメッセージング JMS キュー宛先
デフォルトのメッセージング JMS トピック宛先
データ・ソース
一般 JMS 接続ファクトリー
メール・セッション
J2C 接続ファクトリー
WebSphere MQ の JMS プロバイダー用 JMS キュー接続ファクトリー
WebSphere MQ 用 JMS キュー宛先
WebSphere MQ 用 JMS トピック接続ファクトリー
WebSphere MQ 用 JMS トピック宛先
WebSphere MQ 用統合された JMS 接続ファクトリー
URL 構成

リソース参照サービス・フィルター

リソース参照のマッピング・ターゲットであるサービス・フィルターの名前。例えば、jdbc/AccountDS2 です。

リソース参照認証

リソース参照は、アプリケーションまたはコンテナーのいずれかにより認証されます。

リソース参照の共有

リソース参照は共有可能かまたは共有不可です。

認証別名

リソース参照を保護するために使用する認証別名 (ある場合)。

各参照について、オプションでリストから認証別名を選択することができます。デフォルトの認証別名 (ibm-eba-bnd.xml ファイルから) は、それがすべてのターゲット・サーバーまたはクラスターに存在する場合にのみ提供されます。

マーク付きのリンク (オンライン) では、インターネットにアクセスする必要があります。各リンクにより、オンライン情報センター内のトピックの検索が開始されます。検索結果がリストされたら、お客様の構成に最も当てはまるトピックを選択します。

このトピックの更新を確認します。 (オンライン)

ファイル名: OSGi_BLA_BlueprintResourceRefs.html