📄 referralexception.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc on Thu Apr 27 23:37:30 PDT 2000 --><TITLE>Java 2 Platform SE v1.3: Class ReferralException</TITLE><LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style"></HEAD><BODY BGCOLOR="white"><!-- ========== START OF NAVBAR ========== --><A NAME="navbar_top"><!-- --></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0"><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_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> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ReferralException.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Std. Ed. v1.3</b></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../javax/naming/PartialResultException.html"><B>PREV CLASS</B></A> <A HREF="../../javax/naming/ServiceUnavailableException.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> <A HREF="ReferralException.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: INNER | <A HREF="#fields_inherited_from_class_javax.naming.NamingException">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD></TR></TABLE><!-- =========== END OF NAVBAR =========== --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">javax.naming</FONT><BR>Class ReferralException</H2><PRE><A HREF="../../java/lang/Object.html">java.lang.Object</A> | +--<A HREF="../../java/lang/Throwable.html">java.lang.Throwable</A> | +--<A HREF="../../java/lang/Exception.html">java.lang.Exception</A> | +--<A HREF="../../javax/naming/NamingException.html">javax.naming.NamingException</A> | +--<B>javax.naming.ReferralException</B></PRE><DL><DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../java/io/Serializable.html">Serializable</A></DD></DL><DL><DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../javax/naming/ldap/LdapReferralException.html">LdapReferralException</A></DD></DL><HR><DL><DT>public abstract class <B>ReferralException</B><DT>extends <A HREF="../../javax/naming/NamingException.html">NamingException</A></DL><P>This abstract class is used to represent a referral exception, which is generated in response to a <em>referral</em> such as that returned by LDAP v3 servers. <p> A service provider provides a subclass of <tt>ReferralException</tt> by providing implementations for <tt>getReferralInfo()</tt> and <tt>getReferralContext()</tt> (and appropriate constructors and/or corresponding "set" methods). <p> The following code sample shows how <tt>ReferralException</tt> can be used. <p><blockquote><pre> while (true) { try { bindings = ctx.listBindings(name); while (bindings.hasMore()) { b = bindings.next(); ... } break; } catch (ReferralException e) { ctx = e.getReferralContext(); } } </pre></blockquote></p><p> <tt>ReferralException</tt> is an abstract class. Concrete implementations determine its synchronization and serialization properties.<p> An environment parameter passed to the <tt>getReferralContext()</tt> method is owned by the caller. The service provider will not modify the object or keep a reference to it, but may keep a reference to a clone of it.<P><DL><DT><B>Since: </B><DD>1.3</DD><DT><B>See Also: </B><DD><A HREF="../../serialized-form.html#javax.naming.ReferralException">Serialized Form</A></DL><HR><P><!-- ======== INNER CLASS SUMMARY ======== --><!-- =========== FIELD SUMMARY =========== --><A NAME="fields_inherited_from_class_javax.naming.NamingException"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TD><B>Fields inherited from class javax.naming.<A HREF="../../javax/naming/NamingException.html">NamingException</A></B></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../../javax/naming/NamingException.html#remainingName">remainingName</A>, <A HREF="../../javax/naming/NamingException.html#resolvedName">resolvedName</A>, <A HREF="../../javax/naming/NamingException.html#resolvedObj">resolvedObj</A>, <A HREF="../../javax/naming/NamingException.html#rootException">rootException</A></CODE></TD></TR></TABLE> <!-- ======== CONSTRUCTOR SUMMARY ======== --><A NAME="constructor_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Constructor Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>protected </CODE></FONT></TD><TD><CODE><B><A HREF="../../javax/naming/ReferralException.html#ReferralException()">ReferralException</A></B>()</CODE><BR> Constructs a new instance of ReferralException.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>protected </CODE></FONT></TD><TD><CODE><B><A HREF="../../javax/naming/ReferralException.html#ReferralException(java.lang.String)">ReferralException</A></B>(<A HREF="../../java/lang/String.html">String</A> explanation)</CODE><BR> Constructs a new instance of ReferralException using the explanation supplied.</TD></TR></TABLE> <!-- ========== METHOD SUMMARY =========== --><A NAME="method_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Method Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>abstract <A HREF="../../javax/naming/Context.html">Context</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../javax/naming/ReferralException.html#getReferralContext()">getReferralContext</A></B>()</CODE><BR> Retrieves the context at which to continue the method.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>abstract <A HREF="../../javax/naming/Context.html">Context</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../javax/naming/ReferralException.html#getReferralContext(java.util.Hashtable)">getReferralContext</A></B>(<A HREF="../../java/util/Hashtable.html">Hashtable</A> env)</CODE><BR> Retrieves the context at which to continue the method using environment properties.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>abstract <A HREF="../../java/lang/Object.html">Object</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../javax/naming/ReferralException.html#getReferralInfo()">getReferralInfo</A></B>()</CODE><BR> Retrieves information (such as URLs) related to this referral.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>abstract void</CODE></FONT></TD><TD><CODE><B><A HREF="../../javax/naming/ReferralException.html#retryReferral()">retryReferral</A></B>()</CODE><BR> Retries the referral currently being processed.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>abstract boolean</CODE></FONT></TD><TD><CODE><B><A HREF="../../javax/naming/ReferralException.html#skipReferral()">skipReferral</A></B>()</CODE><BR> Discards the referral about to be processed.</TD></TR></TABLE> <A NAME="methods_inherited_from_class_javax.naming.NamingException"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TD><B>Methods inherited from class javax.naming.<A HREF="../../javax/naming/NamingException.html">NamingException</A></B></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../../javax/naming/NamingException.html#appendRemainingComponent(java.lang.String)">appendRemainingComponent</A>, <A HREF="../../javax/naming/NamingException.html#appendRemainingName(javax.naming.Name)">appendRemainingName</A>, <A HREF="../../javax/naming/NamingException.html#getExplanation()">getExplanation</A>, <A HREF="../../javax/naming/NamingException.html#getRemainingName()">getRemainingName</A>, <A HREF="../../javax/naming/NamingException.html#getResolvedName()">getResolvedName</A>, <A HREF="../../javax/naming/NamingException.html#getResolvedObj()">getResolvedObj</A>, <A HREF="../../javax/naming/NamingException.html#getRootCause()">getRootCause</A>, <A HREF="../../javax/naming/NamingException.html#printStackTrace()">printStackTrace</A>, <A HREF="../../javax/naming/NamingException.html#printStackTrace(java.io.PrintStream)">printStackTrace</A>, <A HREF="../../javax/naming/NamingException.html#printStackTrace(java.io.PrintWriter)">printStackTrace</A>, <A HREF="../../javax/naming/NamingException.html#setRemainingName(javax.naming.Name)">setRemainingName</A>, <A HREF="../../javax/naming/NamingException.html#setResolvedName(javax.naming.Name)">setResolvedName</A>, <A HREF="../../javax/naming/NamingException.html#setResolvedObj(java.lang.Object)">setResolvedObj</A>, <A HREF="../../javax/naming/NamingException.html#setRootCause(java.lang.Throwable)">setRootCause</A>, <A HREF="../../javax/naming/NamingException.html#toString()">toString</A>, <A HREF="../../javax/naming/NamingException.html#toString(boolean)">toString</A></CODE></TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.lang.Throwable"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TD><B>Methods inherited from class java.lang.<A HREF="../../java/lang/Throwable.html">Throwable</A></B></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor">⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -