クラスNamingManager

java.lang.Object
javax.naming.spi.NamingManager
直系の既知のサブクラス:
DirectoryManager
public class NamingManager extends Object
コンテキスト・オブジェクト、およびネーミング・サービスまたはディレクトリ・サービスの位置情 の参照先オブジェクトを生成するメソッドを 納するクラスです。

このクラスはインスタンス化できません。 このクラスはstaticメソッド けを持っています。

このクラスのドキュメントのURLの記載は、RFC 1738およびその関連RFCで定義されているURL文字列を指しています。 それは、そこで記述されている構文規則に準 する任意の文字列であり、対応するサポートがjava.net.URLクラスまたはWebブラウザに必ずあるとは限りません。

NamingManagerは、複数のスレッドによる並行アクセスに対して安全です。

特に明記されていないかぎり、メソッドに渡されるNameまたは環境パラメータは、コール元によって所有されます。 実装はオブジェクトを変更せず、そのオブジェクトに対する参照も保持しませんが、その複製またはコピーに対する参照を保持することがあります。

導入されたバージョン:
1.3

  • フィールド詳細

    • CPE

      public static final String CPE
      getContinuationContext()がそのCannotProceedExceptionパラメータの値を 納する環境プロパティの名前を保持する定数。 このプロパティは継続コンテキストが継承し、そのコンテキストのサービス・プロバイダが例外のフィールドを調べるのに使います。

      この定数の値はjava.naming.spi.CannotProceedExceptionです。

      導入されたバージョン:
      1.3
      関連 目:

  • メソッドの詳細

    • setObjectFactoryBuilder

      public static void setObjectFactoryBuilder(ObjectFactoryBuilder builder) throws NamingException
      ObjectFactoryBuilderは、オブジェクト・ファクトリをロードする際に使用するポリシーを決定します。 デフォルトのポリシーの説明については、getObjectInstance()およびclass ObjectFactoryを参照してく さい。ObjectFactoryBuilderをインストールすることによって、setObjectFactoryBuilder()がこのデフォルトのポリシーをオーバーライドします。 後続のオブジェクト・ファクトリは、インストールされたビルダーを使用してロードおよび生成されます。
      パラメータ:
      builder - インストールするファクトリ・ビルダー。 nullの 合、インストールされるビルダーがない。
      スロー:
      NamingException - セキュリティに関連しない理由で、ビルダーをインストールできない 合。
      IllegalStateException - ファクトリがすでにインストールされている 合。
      関連 目:

    • getObjectInstance

      public static Object getObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?,?> environment) throws Exception
      指定されたオブジェクトおよび環境にオブジェクトのインスタンスを生成します。

      オブジェクト・ファクトリ・ビルダーがインストールされている 合、そのビルダーを使って、オブジェクトを生成するファクトリを生成します。 そうでない 合は、次の規則を使用してオブジェクトを生成します。

      1. refInfoがファクトリ・クラス名を 納するReferenceまたはReferenceableである 合、指定されたファクトリを使用してオブジェクトを生成します。 ファクトリを生成できない 合はrefInfoを返します。 参照で指定されたロケーションからのファクトリ・クラスのダウンロードは、ObjectFactoryBuilderのカスタ 実装でサポートできます。 「ファクトリ・クラスのロケーション」(存在する 合)は無視されます。 別のポリシーが必要な 合は、カスタ ObjectFactoryBuilder 「使用することができます」。 ファクトリの生成中に例外が検出された 合、その例外は呼出し側に引き渡されます。
      2. refInfoがファクトリ・クラス名のないReferenceまたはReferenceableで、アドレスまたはアドレスがアドレス・タイプが"URL"のStringRefAddrの 合は、各URLのスキー IDに対応するURLコンテキスト・ファクトリを試行して、オブジェクト(getURLContext()を参照してく さい)を作成します。 これが失敗した 合は、次のステップに進みます。
      3. 環境のContext.OBJECT_FACTORIESプロパティに指定されているオブジェクト・ファクトリと、nameCtxに関連付けられたプロバイダ・リソース・ファイルのオブジェクト・ファクトリを、その 序で使用します。 このプロパティの値は、 に試されるファクトリ・クラス名の、コロンで区切られたリストであり、オブジェクト生成に最初に成功した値が使用されます。 どのファクトリもロードできない 合は、refInfoを返します。 オブジェクトの生成中に例外が検出された 合、その例外は呼出し側に引き渡されます。

      DirContextインタフェースを実装するサービス・プロバイダは、このメソッドではなくDirectoryManager.getObjectInstance()を使用する必要があります。 Contextインタフェースのみを実装するサービス・プロバイダは、このメソッドを使用する必要があります。

      オブジェクト・ファクトリ(ObjectFactoryインタフェースを実装しているオブジェクト)はpublicであることが必要で、また引数を取らないpublicコンストラクタを持つ必要があります。 ファクトリが名前付きモジュール内にある 合は、そのモジュールによってjava.namingモジュールにエクスポートされるパッケージ内に存在する必要があります。

      作成されるオブジェクトの名前を指定するために、オプションでnameパラメータやnameCtxパラメータを使用できます。nameは、コンテキストnameCtxを基準にした、オブジェクトの名前です。 この情 は、オブジェクト・ファクトリまたはオブジェクト実装に有用な 合があります。 オブジェクトを命名できるコンテキストが複数あることもありますが、その 合は呼出し側が選択します。 適切な経験則として、使用可能な「もっとも深い」コンテキストを選択することをお薦めします。 nameCtxがnullの 合、nameはデフォルトの初期コンテキストを基準にしています。 名前を指定しない 合は、nameパラメータをnullにします。

      パラメータ:
      refInfo - オブジェクトを作成する対象となるnullの可能性があるオブジェクト。
      name - nameCtxを基準にしたこのオブジェクトの名前。 名前の指定はオプション。省略される 合は、nameをnullにする。
      nameCtx - nameパラメータが基準にして指定されているコンテキスト。 nullの 合、nameはデフォルトの初期コンテキストを基準にする。
      environment - オブジェクト・ファクトリとオブジェクトの作成で使用されるnullの可能性がある環境。
      戻り値:
      refInfoを使って生成されたオブジェクト、または上記のアルゴリズ を使ってオブジェクトを生成できなかった 合はrefInfo。
      スロー:
      NamingException - URLコンテキストを取得するときにネーミング例外が見つかった 合、またはアクセスしたファクトリの1つがNamingExceptionをスローした 合。
      Exception - アクセスされたいずれかのファクトリが例外をスローした 合、またはファクトリやオブジェクト・クラスのロード中およびインスタンス化中にエラーが検出された 合。 ファクトリは、オブジェクトの作成にほかのファクトリが使用されるようにしたくない 合にのみ例外をスローするようにする。 ObjectFactory.getObjectInstance()を参照。
      関連 目:

    • getURLContext

      public static Context getURLContext(String scheme, Hashtable<?,?> environment) throws NamingException
      指定されたURLスキー IDにコンテキストを生成します。

      生成されたコンテキストは、スキー schemeのURLを解決するためのものです。 結果のコンテキストは特定のURLに結び付いていません。 このコンテキストは指定されたスキー で任意のURLを処理できます。

      結果のコンテキストを生成するファクトリのクラス名は、次に指定されるように、パッケージに名前変換scheme-idURLContextFactory (ftpスキー IDであればftpURLContextFactoryなど)を持っています。 Context.URL_PKG_PREFIXES環境プロパティ(システ ・プロパティまたはアプリケーション・リソース・ファイルから取得された値を含む 合があります)には、パッケージ・プレフィクスのコロン区切りのリストが含まれます。 プロパティの各パッケージ接 辞には、指定された 序でファクトリ・クラスのロードが試みられます。 デフォルトのパッケージ接 辞はcom.sun.jndi.urlです(指定されたパッケージがどれも成功しない 合、このデフォルトが試される)。 完全なパッケージ名がパッケージ接 辞を使って構築され、スキー IDに連結されます。

      たとえば、スキー IDが"ldap"で、Context.URL_PKG_PREFIXESプロパティに"com.widget:com.wiz.jndi"が含まれている 合、ネーミング・マネージャは次のクラスを正常にインスタンス化されるまでロードしようとします:

      • com.widget.ldap.ldapURLContextFactory
      • com.wiz.jndi.ldap.ldapURLContextFactory
      • com.sun.jndi.url.ldap.ldapURLContextFactory
      パッケージ接 辞がどれも成功しない 合、nullが返されます。

      ファクトリがインスタンス化されると、そのインスタンスは次のパラメータで呼び出され、コンテキストを生成します。

      factory.getObjectInstance(null, environment);

      たとえば、LDAP URLコンテキスト・ファクトリでgetObjectInstance()を上記のように呼び出すと、LDAP URLを解決できるコンテキストが返されます(ldap://ldap.wiz.com/o=wiz,c=us、ldap://ldap.umich.edu/o=umich,c=usなど)。

      オブジェクト・ファクトリ(ObjectFactoryインタフェースを実装しているオブジェクト)はpublicであることが必要で、また引数を取らないpublicコンストラクタを持つ必要があります。 ファクトリが名前付きモジュール内にある 合は、そのモジュールによってjava.namingモジュールにエクスポートされるパッケージ内に存在する必要があります。

      パラメータ:
      scheme - コンテキストがサポートするURLのnull以外のスキー ID。
      environment - nullの可能性がある、オブジェクト・ファクトリおよびコンテキストの生成に使用される環境プロパティ。
      戻り値:
      スキー ID schemeを使用してURLを解決するコンテキスト。コンテキストを生成するファクトリが検出されない 合はnull。
      スロー:
      NamingException - コンテキストの作成中にネーミング例外が発生した 合。
      関連 目:

    • getInitialContext

      public static Context getInitialContext(Hashtable<?,?> env) throws NamingException
      指定された環境プロパティを使って、初期コンテキストを生成します。

      次のように行います。

      • InitialContextFactoryBuilderがインストールされている 合、それを使って初期コンテキストを生成するファクトリを生成します
      • それ以外の 合は、Context.INITIAL_CONTEXT_FACTORY環境プロパティで指定されたクラスが使用されます
        • 最初に、ServiceLoaderメカニズ は、現在のスレッドのコンテキスト・クラス・ローダーを使用してInitialContextFactoryプロバイダを検出しようとします
        • これに失敗すると、この実装は組込みメカニズ を使用して適切なInitialContextFactoryを検出しようとします
          (初期コンテキスト・ファクトリ(InitialContextFactoryインタフェースを実装するオブジェクト)はpublicである必要があり、引数を受け付けないpublicコンストラクタが必要です。           ファクトリが名前付きモジュールにある 合は、そのモジュールがjava.namingモジュールにエクスポートするパッケージ内にある必要があります。

      パラメータ:
      env - nullの可能性がある、コンテキストの生成時に使用される環境プロパティ。
      戻り値:
      null以外の初期コンテキスト。
      スロー:
      NoInitialContextException - Context.INITIAL_CONTEXT_FACTORYプロパティが見つからないか、存在しないクラスまたはインスタンス化できないクラスを指定した 合、または初期コンテキストを他の理由で作成できなかった 合。
      NamingException - ほかのネーミング例外が見つかった 合。
      関連 目:

    • setInitialContextFactoryBuilder

      public static void setInitialContextFactoryBuilder(InitialContextFactoryBuilder builder) throws NamingException
      InitialContextFactoryビルダーがビルダーであることを指定します。
      パラメータ:
      builder - インストールする初期コンテキスト・ファクトリ・ビルダー。 nullの 合、ビルダーが設定されていない。
      スロー:
      NamingException - セキュリティに関連しない理由で、ビルダーをインストールできない 合。
      IllegalStateException - ビルダーがすでにインストールされている 合。
      関連 目:

    • hasInitialContextFactoryBuilder

      public static boolean hasInitialContextFactoryBuilder()
      初期コンテキスト・ファクトリ・ビルダーが設定されているかどうかを判定します。
      戻り値:
      初期コンテキスト・ファクトリ・ビルダーが設定されている 合はtrue、そうでない 合はfalse。
      関連 目:

    • getContinuationContext

      public static Context getContinuationContext(CannotProceedException cpe) throws NamingException
      コンテキスト操作を継続するコンテキストを生成します。

      複数の名前空間にまたがる名前で操作を行う 合、1つのネーミング・システ のコンテキストがその操作を次のネーミング・システ に渡す必要があることがあります。 コンテキスト実装はこれを行うために、どれ け処理したかを正確に示す情 を 納するCannotProceedExceptionを最初に構築します。 次に、getContinuationContextを呼び出すことによって、JNDIから継続コンテキストを取得します。 コンテキスト実装は継続コンテキストの同じ操作を呼び出して、ま 解決されていない名前の残りの部分を使ってコンテキスト操作を再開します。

      このメソッドは、cpeパラメータを使用する前に、プロパティCPEの値をcpeに設定して、そのオブジェクトに関連付けられた環境を更新します。 このプロパティは継続コンテキストが継承し、そのコンテキストのサービス・プロバイダがこの例外のフィールドを調べるのに使います。

      パラメータ:
      cpe - この継続をトリガーしたnull以外の例外。
      戻り値:
      操作を継続するnull以外のContextオブジェクト。
      スロー:
      NamingException - ネーミング例外が発生した 合。

    • getStateToBind

      public static Object getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment) throws NamingException
      オブジェクトのバインディングの状態を取得します。

      DirContextインタフェースを実装するサービス・プロバイダは、このメソッドではなくDirectoryManager.getStateToBind()を使用する必要があります。 Contextインタフェースのみを実装するサービス・プロバイダは、このメソッドを使用する必要があります。

      このメソッドでは、環境プロパティから、およびnameCtxに関連付けられたプロバイダ・リソース・ファイルから、Context.STATE_FACTORIESプロパティで指定された状態ファクトリをこの 序で使用します。 このプロパティの値は、 に試されるファクトリ・クラス名の、コロンで区切られたリストであり、オブジェクトの状態を返すことに成功した最初の値が使用されます。 この方法でオブジェクトの状態を何も取得できない 合、オブジェクト自体を返します。 状態の取得中に例外が検出された 合、その例外は呼出し側に引き渡されます。

      状態ファクトリ(StateFactoryインタフェースを実装しているオブジェクト)はpublicであることが必要で、また引数を取らないpublicコンストラクタを持つ必要があります。 ファクトリが名前付きモジュール内にある 合は、そのモジュールによってjava.namingモジュールにエクスポートされるパッケージ内に存在する必要があります。

      作成されるオブジェクトの名前を指定するために、必要に応じてnameパラメータやnameCtxパラメータを使用できます。 詳細は、ObjectFactory.getObjectInstance()にある「名前パラメータとコンテキスト・パラメータ」の説明を参照してく さい。

      このメソッドは、Referenceableオブジェクトを返すことができます。 このオブジェクトを取得するサービス・プロバイダは、オブジェクトを直接 納するか、参照(Referenceable.getReference()を使用して)を抽出して 納するかを選択できます。

      パラメータ:
      obj - バインドする状態を取得する対象となるnull以外のオブジェクト。
      name - nameCtxを基準にしたこのオブジェクトの名前、または名前が指定されていない 合はnull。
      nameCtx - nameパラメータが基準にして指定されているコンテキスト、またはnameがデフォルトの初期コンテキストを基準にしている 合はnull。
      environment - 状態ファクトリとオブジェクトの状態の作成で使用されるnullの可能性がある環境。
      戻り値:
      バインディングのためのobjの状態を表すnull以外のオブジェクト。 これは、オブジェクト(obj)自体である可能性があります。
      スロー:
      NamingException - アクセスされたいずれかのファクトリが例外をスローした 合、またはファクトリやオブジェクト・クラスのロード中およびインスタンス化中にエラーが検出された 合。 ファクトリは、オブジェクトの作成にほかのファクトリが使用されるようにしたくない 合にのみ例外をスローするようにする。 StateFactory.getStateToBind()を参照してく さい。
      導入されたバージョン:
      1.3
      関連 目: