initialldapcontext.html

API資料大全

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="InitialLdapContext()"><!-- --></A><H3>
InitialLdapContext</H3>
<PRE>
public <B>InitialLdapContext</B>()
                   throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD>Constructs an initial context using no environment properties or 
 connection request controls.
 Equivalent to <tt>new InitialLdapContext(null, null)</tt>.<DD><DL>
<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - if a naming exception is encountered</DL>
</DD>
</DL>
<HR>

<A NAME="InitialLdapContext(java.util.Hashtable, javax.naming.ldap.Control[])"><!-- --></A><H3>
InitialLdapContext</H3>
<PRE>
public <B>InitialLdapContext</B>(<A HREF="../../../java/util/Hashtable.html">Hashtable</A>&nbsp;environment,
                          <A HREF="../../../javax/naming/ldap/Control.html">Control</A>[]&nbsp;connCtls)
                   throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD>Constructs an initial context
 using environment properties and connection request controls.
 See <tt>javax.naming.InitialContext</tt> for a discussion of
 environment properties.

 <p> This constructor will not modify its parameters or
 save references to them, but may save a clone or copy.

 <p> <tt>connCtls</tt> is used as the underlying context instance's
 connection request controls.  See the class description
 for details.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>environment</CODE> - environment used to create the initial DirContext.
		Null indicates an empty environment.<DD><CODE>connCtls</CODE> - connection request controls for the initial context.
		If null, no connection request controls are used.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - if a naming exception is encountered<DT><B>See Also: </B><DD><A HREF="../../../javax/naming/ldap/InitialLdapContext.html#reconnect(javax.naming.ldap.Control[])"><CODE>reconnect(javax.naming.ldap.Control[])</CODE></A>, 
<A HREF="../../../javax/naming/ldap/LdapContext.html#reconnect(javax.naming.ldap.Control[])"><CODE>LdapContext.reconnect(javax.naming.ldap.Control[])</CODE></A></DL>
</DD>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="extendedOperation(javax.naming.ldap.ExtendedRequest)"><!-- --></A><H3>
extendedOperation</H3>
<PRE>
public <A HREF="../../../javax/naming/ldap/ExtendedResponse.html">ExtendedResponse</A> <B>extendedOperation</B>(<A HREF="../../../javax/naming/ldap/ExtendedRequest.html">ExtendedRequest</A>&nbsp;request)
                                   throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../javax/naming/ldap/LdapContext.html">LdapContext</A></CODE></B></DD>
<DD>Performs an extended operation.

 This method is used to support LDAPv3 extended operations.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../javax/naming/ldap/LdapContext.html#extendedOperation(javax.naming.ldap.ExtendedRequest)">extendedOperation</A></CODE> in interface <CODE><A HREF="../../../javax/naming/ldap/LdapContext.html">LdapContext</A></CODE></DL>
</DD>
<DD>Following copied from interface: <CODE>javax.naming.ldap.LdapContext</CODE></DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>request</CODE> - The non-null request to be performed.<DT><B>Returns:</B><DD>The possibly null response of the operation. null means
 the operation did not generate any response.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - If an error occurred while performing the
 extended operation.</DL>
</DD>
</DL>
<HR>

<A NAME="newInstance(javax.naming.ldap.Control[])"><!-- --></A><H3>
newInstance</H3>
<PRE>
public <A HREF="../../../javax/naming/ldap/LdapContext.html">LdapContext</A> <B>newInstance</B>(<A HREF="../../../javax/naming/ldap/Control.html">Control</A>[]&nbsp;reqCtls)
                        throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../javax/naming/ldap/LdapContext.html">LdapContext</A></CODE></B></DD>
<DD>Creates a new instance of this context initialized using request controls.

 This method is a convenience method for creating a new instance
 of this context for the purposes of multithreaded access.
 For example, if multiple threads want to use different context
 request controls,
 each thread may use this method to get its own copy of this context
 and set/get context request controls without having to synchronize with other 
 threads.
<p>
 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.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../javax/naming/ldap/LdapContext.html#newInstance(javax.naming.ldap.Control[])">newInstance</A></CODE> in interface <CODE><A HREF="../../../javax/naming/ldap/LdapContext.html">LdapContext</A></CODE></DL>
</DD>
<DD>Following copied from interface: <CODE>javax.naming.ldap.LdapContext</CODE></DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>requestControls</CODE> - The possibly null request controls 
 to use for the new context.
 If null, the context is initialized with no request controls.<DT><B>Returns:</B><DD>A non-null <tt>LdapContext</tt> instance.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - If an error occurred while creating
 the new instance.<DT><B>See Also: </B><DD><A HREF="../../../javax/naming/ldap/InitialLdapContext.html"><CODE>InitialLdapContext</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="reconnect(javax.naming.ldap.Control[])"><!-- --></A><H3>
reconnect</H3>
<PRE>
public void <B>reconnect</B>(<A HREF="../../../javax/naming/ldap/Control.html">Control</A>[]&nbsp;connCtls)
               throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../javax/naming/ldap/LdapContext.html">LdapContext</A></CODE></B></DD>
<DD>Reconnects to the LDAP server using the supplied controls and 
 this context's environment.
<p>
 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.
<p>
 This method sets this context's <tt>connCtls</tt>
 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 <tt>connCtls</tt>.
 <tt>connCtls</tt> are also used as
 connection request controls for new context instances derived from this
 context.
 These connection request controls are not
 affected by <tt>setRequestControls()</tt>.
<p>
 Service provider implementors should read the "Service Provider" section
 in the class description for implementation details.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A HREF="../../../javax/naming/ldap/LdapContext.html#reconnect(javax.naming.ldap.Control[])">reconnect</A></CODE> in interface <CODE><A HREF="../../../javax/naming/ldap/LdapContext.html">LdapContext</A></CODE></DL>
</DD>
<DD>Following copied from interface: <CODE>javax.naming.ldap.LdapContext</CODE></DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>connCtls</CODE> - The possibly null controls to use. If null, no
 controls are used.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - If an error occurred while reconnecting.<DT><B>See Also: </B><DD><A HREF="../../../javax/naming/ldap/LdapContext.html#getConnectControls()"><CODE>LdapContext.getConnectControls()</CODE></A>, 
<A HREF="../../../javax/naming/ldap/LdapContext.html#newInstance(javax.naming.ldap.Control[])"><CODE>LdapContext.newInstance(javax.naming.ldap.Control[])</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getConnectControls()"><!-- --></A><H3>
getConnectControls</H3>
<PRE>
public <A HREF="../../../javax/naming/ldap/Control.html">Control</A>[] <B>getConnectControls</B>()
                             throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../javax/naming/ldap/LdapContext.html">LdapContext</A></CODE></B></DD>