モジュール 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)

  • メソッドのサマリー

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

  • メソッドの詳細

    • createObjectFactory

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

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

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