src/share/classes/javax/naming/spi/DirectoryManager.java

Print this page




 103     /**
 104       * Creates an instance of an object for the specified object,
 105       * attributes, and environment.
 106       * <p>
 107       * This method is the same as <tt>NamingManager.getObjectInstance</tt>
 108       * except for the following differences:
 109       *<ul>
 110       *<li>
 111       * It accepts an <tt>Attributes</tt> parameter that contains attributes
 112       * associated with the object. The <tt>DirObjectFactory</tt> might use these
 113       * attributes to save having to look them up from the directory.
 114       *<li>
 115       * The object factories tried must implement either
 116       * <tt>ObjectFactory</tt> or <tt>DirObjectFactory</tt>.
 117       * If it implements <tt>DirObjectFactory</tt>,
 118       * <tt>DirObjectFactory.getObjectInstance()</tt> is used, otherwise,
 119       * <tt>ObjectFactory.getObjectInstance()</tt> is used.
 120       *</ul>
 121       * Service providers that implement the <tt>DirContext</tt> interface
 122       * should use this method, not <tt>NamingManager.getObjectInstance()</tt>.
 123       *<p>
 124       *
 125       * @param refInfo The possibly null object for which to create an object.
 126       * @param name The name of this object relative to <code>nameCtx</code>.
 127       *         Specifying a name is optional; if it is
 128       *         omitted, <code>name</code> should be null.
 129       * @param nameCtx The context relative to which the <code>name</code>
 130       *         parameter is specified.  If null, <code>name</code> is
 131       *         relative to the default initial context.
 132       * @param environment The possibly null environment to
 133       *         be used in the creation of the object factory and the object.
 134       * @param attrs The possibly null attributes associated with refInfo.
 135       *         This might not be the complete set of attributes for refInfo;
 136       *         you might be able to read more attributes from the directory.
 137       * @return An object created using <code>refInfo</code> and <tt>attrs</tt>; or
 138       *         <code>refInfo</code> if an object cannot be created by
 139       *         a factory.
 140       * @exception NamingException If a naming exception was encountered
 141       *         while attempting to get a URL context, or if one of the
 142       *         factories accessed throws a NamingException.
 143       * @exception Exception If one of the factories accessed throws an




 103     /**
 104       * Creates an instance of an object for the specified object,
 105       * attributes, and environment.
 106       * <p>
 107       * This method is the same as <tt>NamingManager.getObjectInstance</tt>
 108       * except for the following differences:
 109       *<ul>
 110       *<li>
 111       * It accepts an <tt>Attributes</tt> parameter that contains attributes
 112       * associated with the object. The <tt>DirObjectFactory</tt> might use these
 113       * attributes to save having to look them up from the directory.
 114       *<li>
 115       * The object factories tried must implement either
 116       * <tt>ObjectFactory</tt> or <tt>DirObjectFactory</tt>.
 117       * If it implements <tt>DirObjectFactory</tt>,
 118       * <tt>DirObjectFactory.getObjectInstance()</tt> is used, otherwise,
 119       * <tt>ObjectFactory.getObjectInstance()</tt> is used.
 120       *</ul>
 121       * Service providers that implement the <tt>DirContext</tt> interface
 122       * should use this method, not <tt>NamingManager.getObjectInstance()</tt>.

 123       *
 124       * @param refInfo The possibly null object for which to create an object.
 125       * @param name The name of this object relative to <code>nameCtx</code>.
 126       *         Specifying a name is optional; if it is
 127       *         omitted, <code>name</code> should be null.
 128       * @param nameCtx The context relative to which the <code>name</code>
 129       *         parameter is specified.  If null, <code>name</code> is
 130       *         relative to the default initial context.
 131       * @param environment The possibly null environment to
 132       *         be used in the creation of the object factory and the object.
 133       * @param attrs The possibly null attributes associated with refInfo.
 134       *         This might not be the complete set of attributes for refInfo;
 135       *         you might be able to read more attributes from the directory.
 136       * @return An object created using <code>refInfo</code> and <tt>attrs</tt>; or
 137       *         <code>refInfo</code> if an object cannot be created by
 138       *         a factory.
 139       * @exception NamingException If a naming exception was encountered
 140       *         while attempting to get a URL context, or if one of the
 141       *         factories accessed throws a NamingException.
 142       * @exception Exception If one of the factories accessed throws an