compact3

javax.naming.spi

インタフェースInitialContextFactory

public interface InitialContextFactory

このインタフェースは、初期コンテキストを生成するファクトリを表します。

JNDIフレームワークでは、実行時に複数の初期コンテキスト実装を指定できます。初期コンテキストは初期コンテキスト・ファクトリを使用して生成されます。初期コンテキスト・ファクトリはInitialContextFactoryインタフェースを実装する必要があります。このインタフェースは、Contextインタフェースを実装する初期コンテキストのインスタンスを生成するメソッドを提供します。またファクトリ・クラスはpublicであることが必要で、引数を受け入れないpublicコンストラクタを持っていることが必要です。

導入されたバージョン:

1.3

関連項目:

InitialContextFactoryBuilder, NamingManager.getInitialContext(java.util.Hashtable<?, ?>), InitialContext, InitialDirContext

メソッドのサマリー

修飾子と型	メソッドと説明
Context	getInitialContext(Hashtable<?,?> environment) 名前解決を開始する初期コンテキストを生成します。

メソッドの詳細

getInitialContext

Context getInitialContext(Hashtable<?,?> environment)
                   throws NamingException

名前解決を開始する初期コンテキストを生成します。このコンテキストの特殊要件はenvironmentを使って指定されます。

この環境パラメータは呼出し側が所有します。実装はオブジェクトを変更せず、そのオブジェクトに対する参照も保持しませんが、その複製またはコピーに対する参照を保持することがあります。

パラメータ:

environment - nullの可能性がある、初期コンテキストの生成に使用される情報を指定する環境。

戻り値:

Contextインタフェースを実装する、null以外の初期コンテキスト・オブジェクト。

例外:

NamingException - 初期コンテキストを生成できない場合。