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