モジュール java.naming
パッケージ 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)

    • メソッドの詳細

      • createObjectFactory

        ObjectFactory createObjectFactory​(Object obj,
                                  Hashtable<?,​?> environment)
                           throws NamingException
        指定された環境を使って、新しいオブジェクト・ファクトリを生成します。

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

        パラメータ:
        obj - nullの可能性がある、ファクトリ生成対象のオブジェクト。
        environment - ファクトリを生成する際に使用する環境。 nullも可。
        戻り値:
        ObjectFactoryのnull以外の新しいインスタンス。
        例外:
        NamingException - オブジェクト・ファクトリを生成できない場合。