モジュール java.naming
パッケージ javax.naming.directory

クラスInitialDirContext

java.lang.Object
javax.naming.InitialContext
javax.naming.directory.InitialDirContext
すべての実装されたインタフェース:
Context, DirContext
直系の既知のサブクラス:
InitialLdapContext
public class InitialDirContext
extends InitialContext
implements DirContext
このクラスは、ディレクトリ操作を実行するための開始コンテキストです。 InitialContextのクラスについての記述(同期コンテキストを含む)が適用されます。
導入されたバージョン:
1.3
関連項目:
InitialContext

  • コンストラクタの詳細

    • InitialDirContext

      protected InitialDirContext​(boolean lazy) throws NamingException
      初期化しないというオプションを持つ初期DirContextを構築します。 これは、InitialDirContextコンストラクタが呼び出されたときに環境パラメータの値が不明な場合に、サブクラスのコンストラクタにより使用されます。 サブクラスのコンストラクタは、このコンストラクタを呼び出し、環境の値を計算してから、値を返す前にinit()を呼び出します。
      パラメータ:
      lazy - trueは、初期DirContextが初期化されないことを示す。falseはnew InitialDirContext()を呼び出すのと同じ
      例外:
      NamingException - ネーミング例外が発生した場合
      導入されたバージョン:
      1.3
      関連項目:
      InitialContext.init(Hashtable)

    • InitialDirContext

      public InitialDirContext() throws NamingException
      初期DirContextを構築します。 環境プロパティは指定されません。 new InitialDirContext(null)と同じです。
      例外:
      NamingException - ネーミング例外が発生した場合
      関連項目:
      InitialDirContext(Hashtable)

    • InitialDirContext

      public InitialDirContext​(Hashtable<?,​?> environment) throws NamingException
      指定した環境を使用して初期DirContextを構築します。 環境プロパティについては、javax.naming.InitialContextクラスの記述の中で説明されています。

      指定された環境のjava.naming.provider.urlプロパティがLDAPプロトコルを使用してURL (またはUrlのリスト)で構成されている場合、結果のLdapContextは構成されたLdapDnsProvidersによって解決されたLDAPサーバーを使用します:

      1. Ldapプロトコルを使用してjava.naming.provider.urlで作成された最初のInitialDirContextである場合、ServiceLoaderメカニズムを使用して、システム・クラス・ローダーを使用してLdapDnsProvider実装を検索します。 プロバイダが配置される順序は実装に固有で、実装は位置しているプロバイダを自由にキャッシュできます。
      2. 各プロバイダのlookupEndpointsメソッドがインスタンス化されている場合は、java.naming.provider.urlプロパティ内の各urlと、プロバイダが空でないプロバイダまたはすべてのプロバイダを使い切るまでの環境の組合せで1回起動されます。 LdapDnsProvidersのいずれにも空でないresultが戻されない場合は、エンドポイントの判別がベスト・エフォートに試みられます。 LdapDnsProviderのロード時または呼出し時にServiceConfigurationError、ErrorまたはRuntimeExceptionがスローされた場合、呼出し側のスレッドに伝播されます。

      このコンストラクタはenvironmentを変更したり、その参照を保存したりはしませんが、複製を保存する可能性があります。 呼出し元は、environmentがコンストラクタに渡されたあと、そこに含まれている可変のキーや値を変更してはいけません。

      パラメータ:
      environment - 初期のDirContextを作成するために使用される環境。 nullは空の環境を示す。
      例外:
      NamingException - ネーミング例外が発生した場合