ldapcontext.html

API資料大全

 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>
</DL>
</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>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>
</DL>
</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>getConnectControls()</CODE></A>, 
<A HREF="../../../javax/naming/ldap/LdapContext.html#newInstance(javax.naming.ldap.Control[])"><CODE>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>Retrieves the connection request controls in effect for this context.
 The controls are owned by the JNDI implementation and are
 immutable. Neither the array nor the controls may be modified by the
 caller.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>A possibly-null array of controls. null means no connect controls
 have been set for this context.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - If an error occurred while getting the request
 controls.</DL>
</DD>
</DL>
<HR>

<A NAME="setRequestControls(javax.naming.ldap.Control[])"><!-- --></A><H3>
setRequestControls</H3>
<PRE>
public void <B>setRequestControls</B>(<A HREF="../../../javax/naming/ldap/Control.html">Control</A>[]&nbsp;requestControls)
                        throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD>Sets the request controls for methods subsequently 
 invoked on this context.
 The request controls are owned by the JNDI implementation and are
 immutable. Neither the array nor the controls may be modified by the
 caller.
 <p>
 This removes any previous request controls and adds
 <tt>requestControls</tt> 
 for use by subsequent methods invoked on this context.
 This method does not affect this context's connection request controls.
<p>
 Note that <tt>requestControls</tt> will be in effect until the next
 invocation of <tt>setRequestControls()</tt>. You need to explicitly
 invoke <tt>setRequestControls()</tt> with <tt>null</tt> 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
 <tt>getRequestControls()</tt>.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>requestControls</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 setting the
 request controls.<DT><B>See Also: </B><DD><A HREF="../../../javax/naming/ldap/LdapContext.html#getRequestControls()"><CODE>getRequestControls()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getRequestControls()"><!-- --></A><H3>
getRequestControls</H3>
<PRE>
public <A HREF="../../../javax/naming/ldap/Control.html">Control</A>[] <B>getRequestControls</B>()
                             throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD>Retrieves the request controls in effect for this context.
 The request controls are owned by the JNDI implementation and are
 immutable. Neither the array nor the controls may be modified by the
 caller.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>A possibly-null array of controls. null means no request controls
 have been set for this context.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - If an error occurred while getting the request
 controls.<DT><B>See Also: </B><DD><A HREF="../../../javax/naming/ldap/LdapContext.html#setRequestControls(javax.naming.ldap.Control[])"><CODE>setRequestControls(javax.naming.ldap.Control[])</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getResponseControls()"><!-- --></A><H3>
getResponseControls</H3>
<PRE>
public <A HREF="../../../javax/naming/ldap/Control.html">Control</A>[] <B>getResponseControls</B>()
                              throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD>Retrieves the response controls produced as a result of the last
 method invoked on this context.
 The response controls are owned by the JNDI implementation and are
 immutable. Neither the array nor the controls may be modified by the
 caller.
<p>
 These response controls might have been generated by a successful or
 failed operation.
<p>
 When a context method that may return response controls is invoked,
 response controls from the previous method invocation are cleared.
 <tt>getResponseControls()</tt> returns all of the response controls
 generated by LDAP operations used by the context method in the order
 received from the LDAP server.
 Invoking <tt>getResponseControls()</tt> 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.
<p><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>A possibly null array of controls. If null, the previous
 method invoked on this context did not produce any controls.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - If an error occurred while getting the response
 controls.</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/LdapContext.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Std.&nbsp;Ed. v1.3</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/naming/ldap/HasControls.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/naming/ldap/UnsolicitedNotification.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="LdapContext.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<font size="-1"><a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a><br>For further API reference and developer documentation, see <a href="http://java.sun.com/products/jdk/1.3/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation  contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. <p>Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road<br>Palo Alto, California, 94303, U.S.A.  All Rights Reserved.</font>
</BODY>
</HTML>