Java Naming and Directory Interface
このフィーチャーは、DataSources や JMS 接続ファクトリーなど、サーバーが構成したリソースにアクセスするための Java Naming and Directory Interface (JNDI) の使用を可能にします。また、jndiEntry として、サーバー内に構成された Java プリミティブにアクセスできます。
このフィーチャーの使用可能化
Java Naming and Directory Interface フィーチャーを有効にするには、
server.xml ファイルの featureManager エレメント内に次のエレメント宣言を追加します。
<feature>jndi-1.0</feature>
Supported Java™ バージョン
- JavaSE-1.6
- JavaSE-1.7
- JavaSE-1.8
このフィーチャーに依存するフィーチャーの開発
Java Naming and Directory Interface フィーチャーに依存するフィーチャーを作成している場合は、新しいフィーチャーのためにフィーチャー・マニフェスト・ファイルの Subsystem-Content ヘッダーに次の項目を含めます。
com.ibm.websphere.appserver.jndi-1.0; type="osgi.subsystem.feature"
このフィーチャーを使用可能にするフィーチャー
- Distributed Map interface for Dynamic Caching
- Enterprise JavaBeans Lite 3.1
- Enterprise JavaBeans Lite 3.2
- Java Database Connectivity 4.0
- Java Persistence API 2.0
- Java Persistence API 2.1
- Java EE Managed Bean 1.0
- OSGi Java Persistence API
- Database Session Persistence
- Java EE Web Profile 6.0
- Java EE Web Profile 7.0
フィーチャーの構成エレメント
server.xml ファイルの次のエレメントを使用して、Java Naming and Directory Interface フィーチャーを構成することができます。
- classloading
- グローバル・クラス・ロード
属性名 データ型 デフォルト値 説明 useJarUrls boolean false アーカイブ内のファイルを参照するために jar: または wsjar: の URL を使用するかどうか - jndiEntry
- デフォルトの JNDI ネーム・スペース内の単一エントリー。
属性名 データ型 デフォルト値 説明 id string 固有の構成 ID。 jndiName string このエントリーに使用する JNDI 名。 value string 名前に関連付ける JNDI 値。 - jndiObjectFactory
- JNDI 参照エントリーが使用する ObjectFactory。
属性名 データ型 デフォルト値 説明 className string ObjectFactory 実装クラス名。 id string 固有の構成 ID。 libraryRef 最上位の library エレメント (ストリング) の参照。 ファクトリー実装クラスを含むライブラリー。 objectClassName string java.lang.Object ファクトリーから返されるオブジェクトの型。 - jndiObjectFactory > library
説明: ファクトリー実装クラスを含むライブラリー。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 apiTypeVisibility string spec,ibm-api,api このライブラリーのクラス・ローダーから参照可能になる API パッケージのタイプ。spec、ibm-api、api、third-party を任意に組み合わせたコンマ区切りリストで示されます。 description string 管理者用の共有ライブラリーの説明 filesetRef 最上位の fileset エレメント (コンマ区切りのストリング) の参照のリスト。 参照されるファイル・セットの ID name string 管理者用の共有ライブラリーの名前 - jndiObjectFactory > library > file
説明: 参照されるファイルの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 id string 固有の構成 ID。 name ファイルのパス 完全修飾ファイル名
- jndiObjectFactory > library > fileset
説明: 参照されるファイル・セットの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 caseSensitive boolean true 検索で大/小文字を区別するかどうかを指示するブール値 (デフォルト: true)。 dir ディレクトリーのパス ${server.config.dir} ファイルを検索するベース・ディレクトリー。 excludes string 検索結果から除外するファイル名パターンのコンマ区切りリストまたはスペース区切りリスト。デフォルトでは、除外されるファイルがありません。 id string 固有の構成 ID。 includes string * 検索結果に組み込むファイル名パターンのコンマ区切りリストまたはスペース区切りリスト (デフォルト: *)。 scanInterval 期間 (精度: ミリ秒) 0 long と時間単位のサフィックス (h - 時間、m - 分、s - 秒、ms - ミリ秒 (例: 2ms、5s)) で表した、ファイル・セットの変更をチェックするスキャン間隔。 デフォルトでは使用不可です (scanInterval=0)。. 正整数の後に時間単位 (時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms)) を付けて指定してください。 例えば、500 ミリ秒は 500ms と指定します。 単一エントリーに複数の値を含めることができます。 例えば、1.5 秒の場合、1s500ms とすることができます。
- jndiReferenceEntry
- デフォルトの JNDI ネーム・スペース内の参照エントリー。
属性名 データ型 デフォルト値 説明 factoryRef 最上位の jndiObjectFactory エレメント (ストリング) の参照。 参照エントリーのオブジェクト・ファクトリー。 id string 固有の構成 ID。 jndiName string 参照エントリーの JNDI 名。 - jndiReferenceEntry > factory
説明: 参照エントリーのオブジェクト・ファクトリー。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 className string ObjectFactory 実装クラス名。 libraryRef 最上位の library エレメント (ストリング) の参照。 ファクトリー実装クラスを含むライブラリー。 objectClassName string java.lang.Object ファクトリーから返されるオブジェクトの型。 - jndiReferenceEntry > factory > library
説明: ファクトリー実装クラスを含むライブラリー。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 apiTypeVisibility string spec,ibm-api,api このライブラリーのクラス・ローダーから参照可能になる API パッケージのタイプ。spec、ibm-api、api、third-party を任意に組み合わせたコンマ区切りリストで示されます。 description string 管理者用の共有ライブラリーの説明 filesetRef 最上位の fileset エレメント (コンマ区切りのストリング) の参照のリスト。 参照されるファイル・セットの ID name string 管理者用の共有ライブラリーの名前 - jndiReferenceEntry > factory > library > file
説明: 参照されるファイルの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 id string 固有の構成 ID。 name ファイルのパス 完全修飾ファイル名
- jndiReferenceEntry > factory > library > fileset
説明: 参照されるファイル・セットの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 caseSensitive boolean true 検索で大/小文字を区別するかどうかを指示するブール値 (デフォルト: true)。 dir ディレクトリーのパス ${server.config.dir} ファイルを検索するベース・ディレクトリー。 excludes string 検索結果から除外するファイル名パターンのコンマ区切りリストまたはスペース区切りリスト。デフォルトでは、除外されるファイルがありません。 id string 固有の構成 ID。 includes string * 検索結果に組み込むファイル名パターンのコンマ区切りリストまたはスペース区切りリスト (デフォルト: *)。 scanInterval 期間 (精度: ミリ秒) 0 long と時間単位のサフィックス (h - 時間、m - 分、s - 秒、ms - ミリ秒 (例: 2ms、5s)) で表した、ファイル・セットの変更をチェックするスキャン間隔。 デフォルトでは使用不可です (scanInterval=0)。. 正整数の後に時間単位 (時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms)) を付けて指定してください。 例えば、500 ミリ秒は 500ms と指定します。 単一エントリーに複数の値を含めることができます。 例えば、1.5 秒の場合、1s500ms とすることができます。
- jndiURLEntry
- java.net.URL エントリーをバインドするために使用される JNDI デフォルト・ネーム・スペース内の単一エントリー。
属性名 データ型 デフォルト値 説明 id string 固有の構成 ID。 jndiName string このエントリーに使用する JNDI 名。 value string 名前に関連付ける JNDI URL 値。 - library
- 共有ライブラリー
属性名 データ型 デフォルト値 説明 apiTypeVisibility string spec,ibm-api,api このライブラリーのクラス・ローダーから参照可能になる API パッケージのタイプ。spec、ibm-api、api、third-party を任意に組み合わせたコンマ区切りリストで示されます。 description string 管理者用の共有ライブラリーの説明 filesetRef 最上位の fileset エレメント (コンマ区切りのストリング) の参照のリスト。 参照されるファイル・セットの ID id string 固有の構成 ID。 name string 管理者用の共有ライブラリーの名前 - library > file
説明: 参照されるファイルの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 id string 固有の構成 ID。 name ファイルのパス 完全修飾ファイル名
- library > fileset
説明: 参照されるファイル・セットの ID必須: falseデータ型: 属性名 データ型 デフォルト値 説明 caseSensitive boolean true 検索で大/小文字を区別するかどうかを指示するブール値 (デフォルト: true)。 dir ディレクトリーのパス ${server.config.dir} ファイルを検索するベース・ディレクトリー。 excludes string 検索結果から除外するファイル名パターンのコンマ区切りリストまたはスペース区切りリスト。デフォルトでは、除外されるファイルがありません。 id string 固有の構成 ID。 includes string * 検索結果に組み込むファイル名パターンのコンマ区切りリストまたはスペース区切りリスト (デフォルト: *)。 scanInterval 期間 (精度: ミリ秒) 0 long と時間単位のサフィックス (h - 時間、m - 分、s - 秒、ms - ミリ秒 (例: 2ms、5s)) で表した、ファイル・セットの変更をチェックするスキャン間隔。 デフォルトでは使用不可です (scanInterval=0)。. 正整数の後に時間単位 (時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms)) を付けて指定してください。 例えば、500 ミリ秒は 500ms と指定します。 単一エントリーに複数の値を含めることができます。 例えば、1.5 秒の場合、1s500ms とすることができます。