directorymanager.html

API資料大全

<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="getContinuationDirContext(javax.naming.CannotProceedException)"><!-- --></A><H3>
getContinuationDirContext</H3>
<PRE>
public static <A HREF="../../../javax/naming/directory/DirContext.html">DirContext</A> <B>getContinuationDirContext</B>(<A HREF="../../../javax/naming/CannotProceedException.html">CannotProceedException</A>&nbsp;cpe)
                                            throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD>Creates a context in which to continue a <tt>DirContext</tt> operation.
 Operates just like <tt>NamingManager.getContinuationContext()</tt>,
 only the continuation context returned is a <tt>DirContext</tt>.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>cpe</CODE> - The non-null exception that triggered this continuation.<DT><B>Returns:</B><DD>A non-null <tt>DirContext</tt> object for continuing the operation.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - If a naming exception occurred.<DT><B>See Also: </B><DD><A HREF="../../../javax/naming/spi/NamingManager.html#getContinuationContext(javax.naming.CannotProceedException)"><CODE>NamingManager.getContinuationContext(CannotProceedException)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)"><!-- --></A><H3>
getObjectInstance</H3>
<PRE>
public static <A HREF="../../../java/lang/Object.html">Object</A> <B>getObjectInstance</B>(<A HREF="../../../java/lang/Object.html">Object</A>&nbsp;refInfo,
                                       <A HREF="../../../javax/naming/Name.html">Name</A>&nbsp;name,
                                       <A HREF="../../../javax/naming/Context.html">Context</A>&nbsp;nameCtx,
                                       <A HREF="../../../java/util/Hashtable.html">Hashtable</A>&nbsp;environment,
                                       <A HREF="../../../javax/naming/directory/Attributes.html">Attributes</A>&nbsp;attrs)
                                throws <A HREF="../../../java/lang/Exception.html">Exception</A></PRE>
<DL>
<DD>Creates an instance of an object for the specified object,
 attributes, and environment.
 <p>
 This method is the same as <tt>NamingManager.getObjectInstance</tt>
 except for the following differences:
<ul>
<li>
 It accepts an <tt>Attributes</tt> parameter that contains attributes
 associated with the object. The <tt>DirObjectFactory</tt> might use these
 attributes to save having to look them up from the directory.
<li>
 The object factories tried must implement either
 <tt>ObjectFactory</tt> or <tt>DirObjectFactory</tt>.
 If it implements <tt>DirObjectFactory</tt>, 
 <tt>DirObjectFactory.getObjectInstance()</tt> is used, otherwise,
 <tt>ObjectFactory.getObjectInstance()</tt> is used.
</ul>
 Service providers that implement the <tt>DirContext</tt> interface
 should use this method, not <tt>NamingManager.getObjectInstance()</tt>.
<p><DD><DL>
<DT><B>Parameters:</B><DD><CODE>refInfo</CODE> - The possibly null object for which to create an object.<DD><CODE>name</CODE> - The name of this object relative to <code>nameCtx</code>.
		Specifying a name is optional; if it is
		omitted, <code>name</code> should be null.<DD><CODE>nameCtx</CODE> - The context relative to which the <code>name</code>
		parameter is specified.  If null, <code>name</code> is
		relative to the default initial context.<DD><CODE>environment</CODE> - The possibly null environment to 
		be used in the creation of the object factory and the object.<DD><CODE>attrs</CODE> - The possibly null attributes associated with refInfo.
 	This might not be the complete set of attributes for refInfo;
		you might be able to read more attributes from the directory.<DT><B>Returns:</B><DD>An object created using <code>refInfo</code> and <tt>attrs</tt>; or
		<code>refInfo</code> if an object cannot be created by
		a factory.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - If a naming exception was encountered
 	while attempting to get a URL context, or if one of the
		factories accessed throws a NamingException.<DD><CODE><A HREF="../../../java/lang/Exception.html">Exception</A></CODE> - If one of the factories accessed throws an
		exception, or if an error was encountered while loading
	        and instantiating the factory and object classes.
		A factory should only throw an exception if it does not want
		other factories to be used in an attempt to create an object.
 	See <tt>DirObjectFactory.getObjectInstance()</tt>.<DT><B>Since: </B><DD>1.3</DD>
<DT><B>See Also: </B><DD><A HREF="../../../javax/naming/spi/NamingManager.html#getURLContext(java.lang.String, java.util.Hashtable)"><CODE>NamingManager.getURLContext(java.lang.String, java.util.Hashtable)</CODE></A>, 
<A HREF="../../../javax/naming/spi/DirObjectFactory.html"><CODE>DirObjectFactory</CODE></A>, 
<A HREF="../../../javax/naming/spi/DirObjectFactory.html#getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)"><CODE>DirObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)"><!-- --></A><H3>
getStateToBind</H3>
<PRE>
public static <A HREF="../../../javax/naming/spi/DirStateFactory.Result.html">DirStateFactory.Result</A> <B>getStateToBind</B>(<A HREF="../../../java/lang/Object.html">Object</A>&nbsp;obj,
                                                    <A HREF="../../../javax/naming/Name.html">Name</A>&nbsp;name,
                                                    <A HREF="../../../javax/naming/Context.html">Context</A>&nbsp;nameCtx,
                                                    <A HREF="../../../java/util/Hashtable.html">Hashtable</A>&nbsp;environment,
                                                    <A HREF="../../../javax/naming/directory/Attributes.html">Attributes</A>&nbsp;attrs)
                                             throws <A HREF="../../../javax/naming/NamingException.html">NamingException</A></PRE>
<DL>
<DD>Retrieves the state of an object for binding when given the original
 object and its attributes.
 <p>
 This method is like <tt>NamingManager.getStateToBind</tt> except
 for the following differences:
<ul>
<li>It accepts an <tt>Attributes</tt> parameter containing attributes
    that were passed to the <tt>DirContext.bind()</tt> method.
<li>It returns a non-null <tt>DirStateFactory.Result</tt> instance
    containing the object to be bound, and the attributes to
	   accompany the binding. Either the object or the attributes may be null.
<li>
 The state factories tried must each implement either 
 <tt>StateFactory</tt> or <tt>DirStateFactory</tt>.
 If it implements <tt>DirStateFactory</tt>, then
 <tt>DirStateFactory.getStateToBind()</tt> is called; otherwise,
 <tt>StateFactory.getStateToBind()</tt> is called.
</ul>

 Service providers that implement the <tt>DirContext</tt> interface
 should use this method, not <tt>NamingManager.getStateToBind()</tt>.
<p>
 See NamingManager.getStateToBind() for a description of how
 the list of state factories to be tried is determined.
<p>
 The object returned by this method is owned by the caller.
 The implementation will not subsequently modify it.
 It will contain either a new <tt>Attributes</tt> object that is
 likewise owned by the caller, or a reference to the original
 <tt>attrs</tt> parameter.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>obj</CODE> - The non-null object for which to get state to bind.<DD><CODE>name</CODE> - The name of this object relative to <code>nameCtx</code>,
		or null if no name is specified.<DD><CODE>nameCtx</CODE> - The context relative to which the <code>name</code>
		parameter is specified, or null if <code>name</code> is
		relative to the default initial context.<DD><CODE>environment</CODE> - The possibly null environment to 
		be used in the creation of the state factory and 
 	the object's state.<DD><CODE>attrs</CODE> - The possibly null Attributes that is to be bound with the
 	object.<DT><B>Returns:</B><DD>A non-null DirStateFactory.Result containing
  the object and attributes to be bound.
  If no state factory returns a non-null answer, the result will contain
  the object (<tt>obj</tt>) itself with the original attributes.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/naming/NamingException.html">NamingException</A></CODE> - If a naming exception was encountered
		while using the factories.
		A factory should only throw an exception if it does not want
		other factories to be used in an attempt to create an object.
 	See <tt>DirStateFactory.getStateToBind()</tt>.<DT><B>Since: </B><DD>1.3</DD>
<DT><B>See Also: </B><DD><A HREF="../../../javax/naming/spi/DirStateFactory.html"><CODE>DirStateFactory</CODE></A>, 
<A HREF="../../../javax/naming/spi/DirStateFactory.html#getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)"><CODE>DirStateFactory.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)</CODE></A>, 
<A HREF="../../../javax/naming/spi/NamingManager.html#getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)"><CODE>NamingManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable)</CODE></A></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/DirectoryManager.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;PREV CLASS&nbsp;
&nbsp;<A HREF="../../../javax/naming/spi/DirStateFactory.Result.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="DirectoryManager.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="#fields_inherited_from_class_javax.naming.spi.NamingManager">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;FIELD&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>