Java 命名およびディレクトリ インターフェース

Java Naming and Directory Interface ( JNDI ) は、 Java ソフトウェア クライアントが名前を介してデータとリソース (Javaオブジェクトの形式) を検出および検索できるようにするディレクトリ サービス用のJava APIです。ホスト システムとインターフェイスするすべてのJava API と同様に、JNDI は基礎となる実装に依存しません。さらに、ディレクトリ サービス実装をフレームワークにプラグインできるようにするサービス プロバイダー インターフェイス(SPI)を指定します。 ^[1] JNDI を介して検索される情報は、サーバー、フラット ファイル、またはデータベースによって提供される場合があり、選択は使用される実装によって異なります。

JNDI の一般的な用途は次のとおりです。

• Java アプリケーションを外部ディレクトリ サービス (アドレス データベースやLDAPサーバーなど)に接続する
• JavaサーブレットがホスティングWebコンテナによって提供される構成情報を参照できるようにする^[2]

Java RMIおよびJava EE APIは、JNDI APIを使用してネットワーク内のオブジェクトを検索します。^[3]

API は以下を提供します。

• オブジェクトを名前に結び付けるメカニズム
• 一般的なクエリを可能にするディレクトリ検索インターフェース
• ディレクトリエントリが変更されたかどうかをクライアントが判断できるようにするイベントインターフェース
• LDAP サービスの追加機能をサポートする LDAP 拡張機能

SPI部分では、次のような実質的にあらゆる種類の命名サービスまたはディレクトリ サービスがサポートされます。

• LDAP の
• ドメイン名
• 国家情報院
• CORBA名前サービス
• ファイルシステム

Sun Microsystemsは1997年3月10日に初めてJNDI仕様をリリースしました。^[4] 2006年現在^{[アップデート]}、現在のバージョンはJNDI 1.2です。

JNDI (Java Naming and Directory Interface) は、名前を階層構造に整理します。名前は、"com.example.ejb.MyBean" などの任意の文字列にすることができます。また、インターフェイスを実装するオブジェクトを名前にすることもできますNameが、文字列はオブジェクトに名前を付ける最も一般的な方法です。名前は、名前で識別されるディレクトリ サービスにオブジェクトまたはオブジェクトへの参照を保存することによって、ディレクトリ内のオブジェクトにバインドされます。

JNDI API は、オブジェクトを検索する場所を指定するコンテキストを定義します。初期コンテキストは通常​​、開始点として使用されます。

最も単純なケースでは、特定の実装と実装に必要な追加のパラメータを使用して初期コンテキストを作成する必要があります。初期コンテキストは名前の検索に使用されます。初期コンテキストは、ファイル システムのディレクトリ ツリーのルートまたは最上位に似ています。以下は、初期コンテキストを作成する例です。

ハッシュテーブルcontextArgs = new Hashtable < String , String > ();     

// まず、コンテキスト ファクトリを指定する必要があります。 // これは、jboss 実装と
Sun または他のベンダーの実装のどちらかを選択する方法です。 
contextArgs . put ( Context . INITIAL_CONTEXT_FACTORY , "com.jndiprovider.TheirContextFactory" );
   

// 次の引数は、データ ストアの場所を指定する URL です: 
contextArgs . put ( Context . PROVIDER_URL , "jndiprovider-database" );   

// (セキュリティ資格情報も提供する必要があるかもしれません)

// 次に初期コンテキストを作成します
Context myCurrentContext = new InitialContext ( contextArgs );    

次に、コンテキストを使用して、そのコンテキスト内で以前にバインドされた名前を検索します。例:

MyBean myBean = ( MyBean ) myCurrentContext . lookup ( "com.mydomain.MyBean" );     

上記のコードの代替は以下のとおりです。

Context オブジェクトは、初期コンテキスト ファクトリ クラス名とプロバイダー URL を含む jndi.properties ファイルをクラスパスに追加することによっても構成できます。上記のコードは以下のように短縮されます。

//初期コンテキスト オブジェクトを作成するだけで、クラスパスから jndi.properties ファイルを読み取ろうとします。Context myCurrentContext = new InitialContext ();    

次に、コンテキストを使用して、そのコンテキスト内で以前にバインドされた名前を検索します。例:

MyBean myBean = ( MyBean ) myCurrentContext . lookup ( "com.mydomain.MyBean" );     

属性は、ディレクトリと呼ばれる特別なエントリに添付することができます。ディレクトリを使用すると、関連付けられた属性でオブジェクトを検索できます。ディレクトリはコンテキストの一種であり、ファイルシステム上のディレクトリ構造と同様に名前空間を制限します。^[5]

• サービスロケータパターン
• ログ4シェル

• Java SE 7 JNDI ページ
• Java SE 8 JNDI ページ
• Java SE 8 JNDI javax.naming リファレンスドキュメント
• JNDI チュートリアル