|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object javax.naming.InitialContext javax.naming.directory.InitialDirContext javax.naming.ldap.InitialLdapContext
public class InitialLdapContext
このクラスは、LDAPv3 スタイルの拡張操作および拡張コントロールを実行するための開始コンテキストです。
同期に関する詳細、初期コンテキストの作成方針については、javax.naming.InitialContext および javax.naming.InitialDirContext を参照してください。
初期コンテキストコンストラクタに指定された要求コントロールは、検索およびルックアップなどの後続のコンテキスト操作のコンテキスト要求コントロールとしては使用されません。コンテキスト要求コントロールは、setRequestControls() を使って設定および変更されます。
したがって、コンテキストに関連した要求コントロールには、接続要求コントロールとコンテキスト要求コントロールの 2 種類のセットを持つことがあります。このことは、コンテキスト操作と暗黙的な LDAP バインド操作の両方に適用できるクリティカルなコントロールを送る必要のあるアプリケーションには必要です。一般ユーザーのプログラムは次のように処理されます。
まず、初期コンテキストを作成するために、クリティカルなコントロール (critConnCtls) を指定します。 次に、コンテキスト操作のためのコンテキストの要求コントロール (critModCtls) を設定します。何らかの理由のため lctx が再度サーバーに接続する必要がある場合は、critConnCtls を使用します。要求コントロールの詳細は LdapContext インタフェースを参照してください。InitialLdapContext lctx = new InitialLdapContext(env, critConnCtls); lctx.setRequestControls(critModCtls); lctx.modifyAttributes(name, mods); Controls[] respCtls = lctx.getResponseControls();
実装の詳細については、実装側であるサービスプロバイダは、LdapContext クラスの「サービスプロバイダ」セクションを熟読してください。
LdapContext
,
InitialContext
,
InitialDirContext
,
NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder)
フィールドの概要 |
---|
クラス javax.naming.InitialContext から継承されたフィールド |
---|
defaultInitCtx, gotDefault, myProps |
インタフェース javax.naming.ldap.LdapContext から継承されたフィールド |
---|
CONTROL_FACTORIES |
インタフェース javax.naming.directory.DirContext から継承されたフィールド |
---|
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE |
インタフェース 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 |
コンストラクタの概要 | |
---|---|
InitialLdapContext()
環境プロパティーまたは接続要求コントロールを使用しないで、初期コンテキストを構築します。 |
|
InitialLdapContext(Hashtable<?,?> environment,
Control[] connCtls)
環境プロパティーおよび接続要求コントロールを使用して、初期コンテキストを構築します。 |
メソッドの概要 | |
---|---|
ExtendedResponse |
extendedOperation(ExtendedRequest request)
拡張操作を実行します。 |
Control[] |
getConnectControls()
このコンテキストに有効な接続要求コントロールを取得します。 |
Control[] |
getRequestControls()
このコンテキストに有効な要求コントロールを取得します。 |
Control[] |
getResponseControls()
このコンテキストで最後に呼び出されたメソッドの結果として生成された応答コントロールを取得します。 |
LdapContext |
newInstance(Control[] reqCtls)
このコンテキストの新しいインスタンスを要求コントロールを使って生成します。 |
void |
reconnect(Control[] connCtls)
指定されたコントロールとこのコンテキスト環境を使って LDAP サーバーに再接続します。 |
void |
setRequestControls(Control[] requestControls)
このコンテキストで引き続き呼び出されるメソッドに要求コントロールを設定します。 |
クラス javax.naming.directory.InitialDirContext から継承されたメソッド |
---|
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.InitialContext から継承されたメソッド |
---|
addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, doLookup, doLookup, getDefaultInitCtx, getEnvironment, getNameInNamespace, getNameParser, getNameParser, getURLOrDefaultInitCtx, getURLOrDefaultInitCtx, init, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
インタフェース 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.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 |
コンストラクタの詳細 |
---|
public InitialLdapContext() throws NamingException
NamingException
- ネーミング例外が発生した場合public InitialLdapContext(Hashtable<?,?> environment, Control[] connCtls) throws NamingException
このコンストラクタでは、パラメータの変更または参照の保存は行われませんが、複製またはコピーが保存されます。
connCtls は、基となるコンテキストインスタンスの接続要求コントロールとして使用されます。詳細については、クラスについての記述を参照してください。
environment
- 初期 DirContext の作成に使用される環境。
null は空の環境を示すconnCtls
- 初期コンテキストの接続要求コントロール。
null の場合、接続要求コントロールは使用されない
NamingException
- ネーミング例外が発生した場合reconnect(javax.naming.ldap.Control[])
,
LdapContext.reconnect(javax.naming.ldap.Control[])
メソッドの詳細 |
---|
public ExtendedResponse extendedOperation(ExtendedRequest request) throws NamingException
LdapContext
の記述:
LdapContext
内の extendedOperation
request
- 実行する null 以外の要求
NamingException
- 拡張操作の実行中にエラーが発生した場合public LdapContext newInstance(Control[] reqCtls) throws NamingException
LdapContext
の記述:新規コンテキストには、このコンテキストと同じ環境プロパティー、接続要求コントロールがあります。詳細については、クラスについての記述を参照してください。このコンテキストと新規コンテキストの間で、同じネットワーク接続またはその他のリソースを共有することもできます。 ただし、各コンテキストの間で競合が発生する場合は、共有できません。
LdapContext
内の newInstance
reqCtls
- 新しいコンテキストに使用する null の可能性が
ある要求コントロール
null の場合は、要求コントロールを使用しないで初期化される
NamingException
- 新しいインスタンスの作成中にエラーが
発生した場合InitialLdapContext
public void reconnect(Control[] connCtls) throws NamingException
LdapContext
の記述:このメソッドは、LDAP のバインド操作を明示的に初期化する方法です。このメソッドを使って、LDAP バインド操作に要求コントロールを設定したり、またはその操作によって返される応答コントロールを取得するために明示的にサーバーに接続できます。
このメソッドでは、このコンテキストの connCtls を新規接続要求コントロールとなるように設定します。このコンテキストのコンテキスト要求コントロールは影響を受けません。このメソッドが呼び出されると、そのあとに続く暗黙的な再接続が connCtls を使用して実行されます。 connCtls はまた、接続要求コントロールとして、このコンテキストから派生した新規コンテキストインスタンスにも使用されます。これらの接続要求コントロールは、setRequestControls() の影響を受けません。
実装の詳細については、実装側であるサービスプロバイダは、クラスの「サービスプロバイダ」セクションをよく読んでください。
LdapContext
内の reconnect
connCtls
- null の可能性がある使用するためのコントロール。null の場合、
コントロールが使用されない
NamingException
- 再接続中にエラーが発生した場合LdapContext.getConnectControls()
,
LdapContext.newInstance(javax.naming.ldap.Control[])
public Control[] getConnectControls() throws NamingException
LdapContext
の記述:
LdapContext
内の getConnectControls
NamingException
- 要求コントロールの取得中に、エラーが発生した場合public void setRequestControls(Control[] requestControls) throws NamingException
LdapContext
の記述:以前の要求コントロールをすべて削除し、引き続きこのコンテキストで呼び出されるメソッドが使用するためにrequestControls を追加します。
requestControls は、次に setRequestControls() を呼び出すまで有効です。これ以上コンテキストメソッドに影響を与えたくない場合は、コントロールを解除するために、null または空の配列を持つ setRequestControls() を明示的に呼び出す必要があります。このコンテキストに効果的な要求コントロールを確認するには、getRequestControls() を使用します。
LdapContext
内の setRequestControls
requestControls
- null の可能性がある使用するためのコントロール。null の場合、
コントロールが使用されない
NamingException
- 要求コントロールの設定中にエラーが発生した場合LdapContext.getRequestControls()
public Control[] getRequestControls() throws NamingException
LdapContext
の記述:
LdapContext
内の getRequestControls
NamingException
- 要求コントロールの取得中に、エラーが発生した場合LdapContext.setRequestControls(javax.naming.ldap.Control[])
public Control[] getResponseControls() throws NamingException
LdapContext
の記述:これらの応答コントロールには、正常に終了した操作または失敗した操作によって生成されたものがあります。
応答コントロールを返すことができるコンテキストメソッドが呼び出されると、以前のメソッド呼び出しからの応答コントロールはすべて解除されます。 getResponseControls() は、LDAP サーバーから受け取った順序で、コンテキストメソッドが操作した LDAP によって生成されるすべての応答コントロールを返します。getResponseControls() を呼び出すと、以前の応答コントロールは解除されません。コントロールを返すことができる次のコンテキストメソッドが呼び出されるまで何度でも呼び出したり、同じコントロールを戻したりすることが可能です。
LdapContext
内の getResponseControls
NamingException
- 応答コントロールの取得中に、エラーが発生した場合
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。