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 - 初期コンテキストを生成できない場合