compact3

javax.naming.spi

インタフェースObjectFactoryBuilder

public interface ObjectFactoryBuilder

このインタフェースは、オブジェクト・ファクトリを生成するビルダーを表します。

JNDIフレームワークでは、オブジェクト・ファクトリを使用してオブジェクト実装を動的にロードできます。たとえば名前空間にバインドされたプリンタを検索する場合、印刷サービスがプリンタ名をReferenceにバインドすると、プリンタReferenceを使ってプリンタ・オブジェクトを生成して、ルックアップの呼出し側がルックアップ後に直接プリンタ・オブジェクトで操作できるようになります。ObjectFactoryは特定の型のオブジェクト生成を行います。JNDIは、オブジェクト・ファクトリの使用およびロードにデフォルトのポリシーを使います。NamingManager.setObjectFactoryBuilder()で、プログラム定義によるオブジェクト・ファクトリの生成およびロードの方法を格納するObjectFactoryBuilderを呼び出すことによって、このデフォルトのポリシーをオーバーライドできます。オブジェクト・ファクトリを生成するために、どのObjectFactoryBuilderの実装でもこのインタフェースを実装する必要があります。

導入されたバージョン:

1.3

関連項目:

ObjectFactory, NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>), NamingManager.setObjectFactoryBuilder(javax.naming.spi.ObjectFactoryBuilder)

メソッドのサマリー

修飾子と型	メソッドと説明
ObjectFactory	createObjectFactory(Object obj, Hashtable<?,?> environment) 指定された環境を使って、新しいオブジェクト・ファクトリを生成します。

メソッドの詳細

createObjectFactory

ObjectFactory createObjectFactory(Object obj,
                                  Hashtable<?,?> environment)
                           throws NamingException

指定された環境を使って、新しいオブジェクト・ファクトリを生成します。

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

パラメータ:

obj - nullの可能性がある、ファクトリ生成対象のオブジェクト。

environment - ファクトリを生成する際に使用する環境。nullも可。

戻り値:

ObjectFactoryのnull以外の新しいインスタンス。

例外:

NamingException - オブジェクト・ファクトリを生成できない場合。