dirobjectfactory.html

API資料大全

</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->


<!-- ============ 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="getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)"><!-- --></A><H3>
getObjectInstance</H3>
<PRE>
public <A HREF="../../../java/lang/Object.html">Object</A> <B>getObjectInstance</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="../../../java/lang/Exception.html">Exception</A></PRE>
<DL>
<DD>Creates an object using the location or reference information, and attributes
 specified.  
 <p>
 Special requirements of this object are supplied
 using <code>environment</code>.
 An example of such an environment property is user identity
 information. 
<p>
 <tt>DirectoryManager.getObjectInstance()</tt>
 successively loads in object factories. If it encounters a <tt>DirObjectFactory</tt>,
 it will invoke <tt>DirObjectFactory.getObjectInstance()</tt>; 
 otherwise, it invokes
 <tt>ObjectFactory.getObjectInstance()</tt>. It does this until a factory
 produces a non-null answer.  
 <p> When an exception
 is thrown by an object factory, the exception is passed on to the caller
 of <tt>DirectoryManager.getObjectInstance()</tt>. The search for other factories
 that may produce a non-null answer is halted. 
 An object factory should only throw an exception if it is sure that
 it is the only intended factory and that no other object factories
 should be tried.
 If this factory cannot create an object using the arguments supplied,
 it should return null. 
<p>Since <tt>DirObjectFactory</tt> extends <tt>ObjectFactory</tt>, it effectly
 has two <tt>getObjectInstance()</tt> methods, where one differs from the other by
 the attributes argument. Given a factory that implements <tt>DirObjectFactory</tt>,
 <tt>DirectoryManager.getObjectInstance()</tt> will only
 use the method that accepts the attributes argument, while 
 <tt>NamingManager.getObjectInstance()</tt> will only use the one that does not accept
 the attributes argument.
<p>
 See <tt>ObjectFactory</tt> for a description URL context factories and other
 properties of object factories that apply equally to <tt>DirObjectFactory</tt>.
<p>
 The <tt>name</tt>, <tt>attrs</tt>, and <tt>environment</tt> parameters
 are owned by the caller.
 The implementation will not modify these objects or keep references
 to them, although it may keep references to clones or copies.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>obj</CODE> - The possibly null object containing location or reference 
 		information that can be used in creating an object.<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 that is used in
 		creating the object.<DD><CODE>attrs</CODE> - The possibly null attributes containing some of <tt>obj</tt>'s
 attributes. <tt>attrs</tt> might not necessarily have all of <tt>obj</tt>'s
 attributes. If the object factory requires more attributes, it needs
 to get it, either using <tt>obj</tt>, or <tt>name</tt> and <tt>nameCtx</tt>.
 	The factory must not modify attrs.<DT><B>Returns:</B><DD>The object created; null if an object cannot be created.<DT><B>Throws:</B><DD><CODE><A HREF="../../../java/lang/Exception.html">Exception</A></CODE> - If this object factory encountered an exception
 while attempting to create an object, and no other object factories are
 to be tried.<DT><B>See Also: </B><DD><A HREF="../../../javax/naming/spi/DirectoryManager.html#getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes)"><CODE>DirectoryManager.getObjectInstance(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#getURLContext(java.lang.String, java.util.Hashtable)"><CODE>NamingManager.getURLContext(java.lang.String, 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/DirObjectFactory.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.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="DirObjectFactory.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;FIELD&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>