各参照に、リソースがランタイム環境で認識される JNDI 名を指定します。 オプションで、認証プロパティーと拡張データ・ソース・カスタム・プロパティーを設定します。これはランタイムでのリソースへのアクセスに影響します。
リソース参照をバインドすると、エンタープライズ Bean のリソース依存関係が、サーバー・ランタイム環境で使用可能な実際のリソースにマップされます。少なくとも、リソース参照がランタイム環境で認識される JNDI 名を指定することにより、このマッピングを行えます。JNDI 名は、デフォルトで、既存のバインディングから取得されるか、またはリソース定義で指定されているマップされる名前の値に設定されます。
リソース参照の JNDI 名マッピングがバンドルの ibm-ejb-jar-bnd.xml ファイルに定義されている場合は、該当する JNDI 名がその参照の「JNDI 名」列に表示されます。定義されていない場合、JNDI 名はデフォルトでリソース参照名になります。
必要に応じて、「JNDI 名」列に適切な値を入力して、マッピングを変更することができます。
管理コンソールでこのパネルを表示するには、次のいずれかのパスをクリックします。
注: 「EJB リソース参照をリソースにマップ (Map EJB resource references to resources)」ウィザード・ステップおよび「EJB リソース参照」プロパティーは、ejb-jar.xml ファイル内に定義されているか、またはエンタープライズ Bean の @Resource アノテーションを通して定義されているリソース参照が、OSGi アプリケーションに少なくとも 1 つ含まれている場合にのみ表示されます。
一般プロパティー
- 選択
- 認証メソッドを変更する、または、データベース接続に適用する拡張データ・ソース・カスタム・プロパティーを設定するには、参照を 1 つ選択し、「リソース認証メソッドの変更...」または「拡張プロパティー...」をクリックします。
- バンドルのシンボル名
- このバンドル用の、ローカライズできない名前。
- バンドル・バージョン
- このバンドルのバージョン。
バンドルのシンボル名とバンドルのバージョンによって、バンドルを一意的に識別します。
- EJBName
- リソース参照を宣言するエンタープライズ Bean の名前。
- リソース参照
- アプリケーションで使用されるリソース参照の名前。該当する場合は、EJB バンドルのデプロイメント記述子で宣言します。
- リソース・タイプ
- リソース参照のタイプ。
このパネルを使用すると、いずれかの
resource-ref (リソース参照) リソースのバインディングを指定できます (Java™ 仕様 JSR-250: Common Annotations for the Java Platform で定義)。
例えば、以下に示すものは、
resource-ref リソースのすべてのタイプです。
- データ・ソース
- 一般 JMS 接続ファクトリー
- メール・セッション
- J2C 接続ファクトリー
- WebSphere® MQ の JMS プロバイダー用 JMS キュー接続ファクトリー
- WebSphere MQ 用 JMS トピック接続ファクトリー
- WebSphere MQ 用統合された JMS 接続ファクトリー
- URL 構成
- JNDI 名
- リソース参照のマッピング・ターゲットである、リソースの
Java Naming and Directory Interface (JNDI) 名。
- ログイン構成
- リソースを保護するための承認タイプと認証メソッド。コンテナー管理許可は、エンタープライズ Bean コードではなく製品が、リソースにサインオンすることを示します。
ボタン
| ラベル |
アクション |
|---|
参照
|
特定の EJB リソース参照用に JNDI
名のマッピングを指定する場合に、このオプションを使用して、使用可能なリソースのリストからリソース参照を選択します。
|
リソース認証メソッドの変更
|
以下のオプションのいずれかを選択できます。
- なし
- デフォルト・メソッドの使用 (多対 1 のマッピング)
- デフォルトのマッピング構成について詳しくは、J2EE コネクター・セキュリティー (オンライン)を参照してください。
- このオプションを選択し、リストから認証別名を選択します。
- トラステッド接続の使用 (1 対 1 のマッピング)
- リソースが、使用可能なトラステッド・コンテキストを持つデータ・ソースである場合に、このオプションを使用します。
- このオプションを選択し、リストから、データ・ソースで定義済みの別名と一致する認証別名を選択します。
- カスタム・ログイン構成の使用
- カスタム Java 認証・承認サービス (JAAS) ログイン構成
について詳しくは、J2EE コネクター・セキュリティー (オンライン)を参照してください。
- このオプションを選択し、リストから JAAS ログイン構成を選択します。
|
拡張プロパティー
|
リソースがデータ・ソースで、バックエンド・データベースが拡張データ・ソースのカスタム・プロパティーをサポートしている場合は、このオプションを使用してこれらのプロパティーの追加、変更、削除を行うことができます。これらは、データ・ソースを取得するために使用できる、名前/値ペアの形式のカスタム・プロパティーです。 注: 1 つの拡張データ・ソース・プロパティーに対して複数の
値を使用する場合、それらの値を引用符で囲む必要があります。
詳しくは、拡張データ・ソース・プロパティー (オンライン)を参照してください。
|
マッピング・プロパティー
|
リソース認証メソッドに適用する拡張データ・ソース・プロパティーの、任意の名前と値のペアを定義します。このボタンは、リソース認証メソッドに「トラステッド接続の使用」または「カスタム・ログイン構成を使用」を選択した場合にのみ表示されます。
|
マーク付きのリンク (オンライン) では、インターネットにアクセスする必要があります。各リンクにより、オンライン情報センター内のトピックの検索が開始されます。検索結果がリストされたら、お客様の構成に最も当てはまるトピックを選択します。