|
Préférences
Moteurs de recherche
|
|||||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
javax.naming.ldap
|
Field Summary |
---|
Fields inherited from class javax.naming.InitialContext |
---|
defaultInitCtx, gotDefault, myProps |
Fields inherited from interface javax.naming.ldap.LdapContext |
---|
CONTROL_FACTORIES |
Fields inherited from interface javax.naming.directory.DirContext |
---|
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE |
Fields inherited from interface 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 |
Constructor Summary | |
---|---|
InitialLdapContext()
Constructs an initial context using no environment properties or connection request controls. |
|
InitialLdapContext(Hashtable<?,?> environment,
Control[] connCtls)
Constructs an initial context using environment properties and connection request controls. |
Method Summary | |
---|---|
ExtendedResponse |
extendedOperation(ExtendedRequest request)
Performs an extended operation. |
Control[] |
getConnectControls()
Retrieves the connection request controls in effect for this context. |
Control[] |
getRequestControls()
Retrieves the request controls in effect for this context. |
Control[] |
getResponseControls()
Retrieves the response controls produced as a result of the last method invoked on this context. |
LdapContext |
newInstance(Control[] reqCtls)
Creates a new instance of this context initialized using request controls. |
void |
reconnect(Control[] connCtls)
Reconnects to the LDAP server using the supplied controls and this context's environment. |
void |
setRequestControls(Control[] requestControls)
Sets the request controls for methods subsequently invoked on this context. |
Methods inherited from class 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 |
Methods inherited from class 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 |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface 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 |
Methods inherited from interface 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 |
Constructor Detail |
---|
public InitialLdapContext() throws NamingException
NamingException
- if a naming exception is encounteredpublic InitialLdapContext(Hashtable<?,?> environment, Control[] connCtls) throws NamingException
This constructor will not modify its parameters or save references to them, but may save a clone or copy.
connCtls is used as the underlying context instance's connection request controls. See the class description for details.
environment
- environment used to create the initial DirContext.
Null indicates an empty environment.connCtls
- connection request controls for the initial context.
If null, no connection request controls are used.
NamingException
- if a naming exception is encounteredreconnect(javax.naming.ldap.Control[])
,
LdapContext.reconnect(javax.naming.ldap.Control[])
Method Detail |
---|
public ExtendedResponse extendedOperation(ExtendedRequest request) throws NamingException
LdapContext
extendedOperation
in interface LdapContext
request
- The non-null request to be performed.
NamingException
- If an error occurred while performing the
extended operation.public LdapContext newInstance(Control[] reqCtls) throws NamingException
LdapContext
The new context has the same environment properties and connection request controls as this context. See the class description for details. Implementations might also allow this context and the new context to share the same network connection or other resources if doing so does not impede the independence of either context.
newInstance
in interface LdapContext
reqCtls
- The possibly null request controls
to use for the new context.
If null, the context is initialized with no request controls.
NamingException
- If an error occurred while creating
the new instance.InitialLdapContext
public void reconnect(Control[] connCtls) throws NamingException
LdapContext
This method is a way to explicitly initiate an LDAP "bind" operation. For example, you can use this method to set request controls for the LDAP "bind" operation, or to explicitly connect to the server to get response controls returned by the LDAP "bind" operation.
This method sets this context's connCtls to be its new connection request controls. This context's context request controls are not affected. After this method has been invoked, any subsequent implicit reconnections will be done using connCtls. connCtls are also used as connection request controls for new context instances derived from this context. These connection request controls are not affected by setRequestControls().
Service provider implementors should read the "Service Provider" section in the class description for implementation details.
reconnect
in interface LdapContext
connCtls
- The possibly null controls to use. If null, no
controls are used.
NamingException
- If an error occurred while reconnecting.LdapContext.getConnectControls()
,
LdapContext.newInstance(javax.naming.ldap.Control[])
public Control[] getConnectControls() throws NamingException
LdapContext
getConnectControls
in interface LdapContext
NamingException
- If an error occurred while getting the request
controls.public void setRequestControls(Control[] requestControls) throws NamingException
LdapContext
This removes any previous request controls and adds requestControls for use by subsequent methods invoked on this context. This method does not affect this context's connection request controls.
Note that requestControls will be in effect until the next invocation of setRequestControls(). You need to explicitly invoke setRequestControls() with null or an empty array to clear the controls if you don't want them to affect the context methods any more. To check what request controls are in effect for this context, use getRequestControls().
setRequestControls
in interface LdapContext
requestControls
- The possibly null controls to use. If null, no
controls are used.
NamingException
- If an error occurred while setting the
request controls.LdapContext.getRequestControls()
public Control[] getRequestControls() throws NamingException
LdapContext
getRequestControls
in interface LdapContext
NamingException
- If an error occurred while getting the request
controls.LdapContext.setRequestControls(javax.naming.ldap.Control[])
public Control[] getResponseControls() throws NamingException
LdapContext
These response controls might have been generated by a successful or failed operation.
When a context method that may return response controls is invoked, response controls from the previous method invocation are cleared. getResponseControls() returns all of the response controls generated by LDAP operations used by the context method in the order received from the LDAP server. Invoking getResponseControls() does not clear the response controls. You can call it many times (and get back the same controls) until the next context method that may return controls is invoked.
getResponseControls
in interface LdapContext
NamingException
- If an error occurred while getting the response
controls.