- 直系の既知のサブクラス:
DirectoryManager
このクラスはインスタンス化できません。 このクラスはstaticメソッドだけを持っています。
このクラスのドキュメントのURLの記載は、RFC 1738およびその関連RFCで定義されているURL文字列を指しています。 それは、そこで記述されている構文規則に準拠する任意の文字列であり、対応するサポートがjava.net.URLクラスまたはWebブラウザに必ずあるとは限りません。
NamingManagerは、複数のスレッドによる並行アクセスに対して安全です。
特に明記されていないかぎり、メソッドに渡されるNameまたは環境パラメータは、コール元によって所有されます。 実装はオブジェクトを変更せず、そのオブジェクトに対する参照も保持しませんが、その複製またはコピーに対する参照を保持することがあります。
- 導入されたバージョン:
- 1.3
-
フィールドのサマリー
フィールド -
メソッドのサマリー
修飾子と型メソッド説明static Contextコンテキスト操作を継続するコンテキストを生成します。static ContextgetInitialContext(Hashtable<?, ?> env) 指定された環境プロパティを使って、初期コンテキストを生成します。static ObjectgetObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?, ?> environment) 指定されたオブジェクトおよび環境にオブジェクトのインスタンスを生成します。static ObjectgetStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?, ?> environment) オブジェクトのバインディングの状態を取得します。static ContextgetURLContext(String scheme, Hashtable<?, ?> environment) 指定されたURLスキームIDにコンテキストを生成します。static boolean初期コンテキスト・ファクトリ・ビルダーが設定されているかどうかを判定します。static voidInitialContextFactoryビルダーがビルダーであることを指定します。static voidObjectFactoryBuilderは、オブジェクト・ファクトリをロードする際に使用するポリシーを決定します。
-
フィールド詳細
-
CPE
public static final String CPEgetContinuationContext()がそのCannotProceedExceptionパラメータの値を格納する環境プロパティの名前を保持する定数。 このプロパティは継続コンテキストが継承し、そのコンテキストのサービス・プロバイダが例外のフィールドを調べるのに使います。この定数の値はjava.naming.spi.CannotProceedExceptionです。
- 導入されたバージョン:
- 1.3
- 関連項目:
-
-
メソッドの詳細
-
setObjectFactoryBuilder
public static void setObjectFactoryBuilder(ObjectFactoryBuilder builder) throws NamingException ObjectFactoryBuilderは、オブジェクト・ファクトリをロードする際に使用するポリシーを決定します。 デフォルトのポリシーの説明については、getObjectInstance()およびclass ObjectFactoryを参照してください。ObjectFactoryBuilderをインストールすることによって、setObjectFactoryBuilder()がこのデフォルトのポリシーをオーバーライドします。 後続のオブジェクト・ファクトリは、インストールされたビルダーを使用してロードおよび生成されます。ビルダーをインストールできるのは、セキュリティ・マネージャのcheckSetFactory()メソッドが実行中のスレッドにインストールを許可した場合に限ります。 一度インストールすると、ビルダーを置き換えることはできません。
- パラメータ:
builder- インストールするファクトリ・ビルダー。 nullの場合、インストールされるビルダーがない。- 例外:
SecurityException- セキュリティ上の理由から、ビルダーをインストールできない場合。NamingException- セキュリティに関連しない理由で、ビルダーをインストールできない場合。IllegalStateException- ファクトリがすでにインストールされている場合。- 関連項目:
-
getObjectInstance
public static Object getObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?, ?> environment) throws Exception指定されたオブジェクトおよび環境にオブジェクトのインスタンスを生成します。オブジェクト・ファクトリ・ビルダーがインストールされている場合、そのビルダーを使って、オブジェクトを生成するファクトリを生成します。 そうでない場合は、次の規則を使用してオブジェクトを生成します。
refInfoがファクトリ・クラス名を格納するReferenceまたはReferenceableである場合、指定されたファクトリを使用してオブジェクトを生成します。 ファクトリを生成できない場合はrefInfoを返します。 JDK 1.1で、参照で指定されたロケーションからファクトリ・クラスをロードする必要がある場合は、SecurityManagerがインストールされている必要があります。そうしないと、ファクトリの作成に失敗します。 ファクトリの生成中に例外が検出された場合、その例外は呼出し側に引き渡されます。refInfoがファクトリ・クラス名のないReferenceまたはReferenceableで、アドレスまたはアドレスがアドレス・タイプが"URL"のStringRefAddrの場合は、各URLのスキームIDに対応するURLコンテキスト・ファクトリを試行して、オブジェクト(getURLContext()を参照してください)を作成します。 これが失敗した場合は、次のステップに進みます。- 環境の
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
ファクトリがインスタンス化されると、そのインスタンスは次のパラメータで呼び出され、コンテキストを生成します。
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モジュールにエクスポートするパッケージ内にある必要があります。
- 最初に、ServiceLoaderメカニズムは、現在のスレッドのコンテキスト・クラス・ローダーを使用して
- パラメータ:
env- nullの可能性がある、コンテキストの生成時に使用される環境プロパティ。- 戻り値:
- null以外の初期コンテキスト。
- 例外:
NoInitialContextException-Context.INITIAL_CONTEXT_FACTORYプロパティが見つからないか、存在しないクラスまたはインスタンス化できないクラスを指定した場合、または初期コンテキストを他の理由で作成できなかった場合。NamingException- ほかのネーミング例外が見つかった場合。- 関連項目:
-
setInitialContextFactoryBuilder
public static void setInitialContextFactoryBuilder(InitialContextFactoryBuilder builder) throws NamingException InitialContextFactoryビルダーがビルダーであることを指定します。ビルダーをインストールできるのは、実行中のスレッドにセキュリティ・マネージャがインストールを許可した場合に限ります。 一度インストールすると、ビルダーを置き換えることはできません。
- パラメータ:
builder- インストールする初期コンテキスト・ファクトリ・ビルダー。 nullの場合、ビルダーが設定されていない。- 例外:
SecurityException- セキュリティ上の理由から、ビルダーをインストールできない場合。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
- 関連項目:
-