- java.lang.Object
-
- javax.naming.InitialContext
-
- javax.naming.directory.InitialDirContext
-
- javax.naming.ldap.InitialLdapContext
-
- すべての実装されたインタフェース:
Context
,DirContext
,LdapContext
public class InitialLdapContext extends InitialDirContext implements LdapContext
このクラスは、LDAPv3スタイルの拡張操作および拡張コントロールを実行するための開始コンテキストです。同期に関する詳細、初期コンテキストの作成方針については、
javax.naming.InitialContext
およびjavax.naming.InitialDirContext
を参照してください。RequestControls
InitialLdapContext
である初期コンテキストを作成するときは、要求コントロールのリストを指定できます。 リスト内のコントロールは、コンテキスト、またはコンテキストから派生したコンテキストによって実行された暗黙的なLDAPバインド操作のための要求コントロールとして使用されます。 これらのコントロールを接続要求コントロールといいます。 コンテキストの接続要求コントロールを取得するには、getConnectControls()
を使用します。初期コンテキスト・コンストラクタに指定された要求コントロールは、検索およびルックアップなどの後続のコンテキスト操作のコンテキスト要求コントロールとしては使用されません。 コンテキスト要求コントロールは、
setRequestControls()
を使って設定および変更されます。したがって、コンテキストに関連した要求コントロールには、接続要求コントロールとコンテキスト要求コントロールの2種類のセットを持つことがあります。 このことは、コンテキスト操作と暗黙的なLDAPバインド操作の両方に適用できない可能性のあるクリティカルなコントロールを送る必要のあるアプリケーションには必要です。 一般ユーザーのプログラムは次のように処理されます。
まず、初期コンテキストを作成するために、クリティカルなコントロール(InitialLdapContext lctx = new InitialLdapContext(env, critConnCtls); lctx.setRequestControls(critModCtls); lctx.modifyAttributes(name, mods); Controls[] respCtls = lctx.getResponseControls();
critConnCtls
)を指定します。次に、コンテキスト操作のためのコンテキストの要求コントロール(critModCtls
)を設定します。 なんらかの理由のためlctx
が再度サーバーに接続する必要がある場合は、critConnCtls
を使用します。 要求コントロールの詳細はLdapContext
インタフェースを参照してください。サービス・プロバイダの実装者は、実装の詳細について、
LdapContext
のクラスの説明にあるサービス・プロバイダのセクションを参照するようにしてください。
-
-
フィールドのサマリー
-
クラス javax.naming.InitialContextで宣言されたフィールド
defaultInitCtx, gotDefault, myProps
-
インタフェース javax.naming.Contextで宣言されたフィールド
APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES
-
インタフェース javax.naming.directory.DirContextで宣言されたフィールド
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE
-
インタフェース javax.naming.ldap.LdapContextで宣言されたフィールド
CONTROL_FACTORIES
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 InitialLdapContext()
環境プロパティまたは接続要求コントロールを使用しないで、初期コンテキストを構築します。InitialLdapContext(Hashtable<?,?> environment, Control[] connCtls)
環境プロパティおよび接続要求コントロールを使用して、初期コンテキストを構築します。
-
メソッドのサマリー
-
クラス javax.naming.InitialContextで宣言されたメソッド
composeName, composeName, doLookup, doLookup, getDefaultInitCtx, getURLOrDefaultInitCtx, getURLOrDefaultInitCtx, init
-
クラス java.lang.Objectで宣言されたメソッド
clone、equals、finalize、getClass、hashCode、notify、notifyAll、toString、wait、wait、wait
-
インタフェース javax.naming.Contextで宣言されたメソッド
addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind
-
インタフェース javax.naming.directory.DirContextで宣言されたメソッド
bind, bind, createSubcontext, createSubcontext, getAttributes, getAttributes, getAttributes, getAttributes, getSchema, getSchema, getSchemaClassDefinition, getSchemaClassDefinition, modifyAttributes, modifyAttributes, modifyAttributes, modifyAttributes, rebind, rebind, search, search, search, search, search, search, search, search
-
インタフェース javax.naming.ldap.LdapContextで宣言されたメソッド
extendedOperation, getConnectControls, getRequestControls, getResponseControls, newInstance, reconnect, setRequestControls
-
-
-
-
コンストラクタの詳細
-
InitialLdapContext
public InitialLdapContext() throws NamingException
環境プロパティまたは接続要求コントロールを使用しないで、初期コンテキストを構築します。new InitialLdapContext(null, null)
と同等です。- 例外:
NamingException
- ネーミング例外が発生した場合
-
InitialLdapContext
public InitialLdapContext(Hashtable<?,?> environment, Control[] connCtls) throws NamingException
環境プロパティおよび接続要求コントロールを使用して、初期コンテキストを構築します。 環境プロパティについては、javax.naming.InitialContext
を参照してください。このコンストラクタでは、パラメータの変更または参照の保存は行われませんが、複製またはコピーが保存されます。 呼出し元は、
environment
がコンストラクタに渡されたあと、そこに含まれている可変のキーや値を変更してはいけません。connCtls
は、基となるコンテキスト・インスタンスの接続要求コントロールとして使用されます。 詳細については、クラスの説明を参照してください。- パラメータ:
environment
- 初期のDirContextを作成するために使用される環境。 nullは空の環境を示す。connCtls
- 初期コンテキストの接続要求コントロール。 nullの場合、接続要求コントロールは使用されない。- 例外:
NamingException
- ネーミング例外が発生した場合- 関連項目:
LdapContext.reconnect(javax.naming.ldap.Control[])
,LdapContext.reconnect(javax.naming.ldap.Control[])
-
-