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

Print this page




 132  * to them, although it may keep references to clones or copies.
 133  *
 134  * <p>
 135  * <b>Name and Context Parameters.</b> &nbsp;&nbsp;&nbsp;
 136  * <a name=NAMECTX></a>
 137  *
 138  * The <code>name</code> and <code>nameCtx</code> parameters may
 139  * optionally be used to specify the name of the object being created.
 140  * <code>name</code> is the name of the object, relative to context
 141  * <code>nameCtx</code>.
 142  * If there are several possible contexts from which the object
 143  * could be named -- as will often be the case -- it is up to
 144  * the caller to select one.  A good rule of thumb is to select the
 145  * "deepest" context available.
 146  * If <code>nameCtx</code> is null, <code>name</code> is relative
 147  * to the default initial context.  If no name is being specified, the
 148  * <code>name</code> parameter should be null.
 149  * If a factory uses <code>nameCtx</code> it should synchronize its use
 150  * against concurrent access, since context implementations are not
 151  * guaranteed to be thread-safe.
 152  * <p>
 153  *
 154  * @param obj The possibly null object containing location or reference
 155  *              information that can be used in creating an object.
 156  * @param name The name of this object relative to <code>nameCtx</code>,
 157  *              or null if no name is specified.
 158  * @param nameCtx The context relative to which the <code>name</code>
 159  *              parameter is specified, or null if <code>name</code> is
 160  *              relative to the default initial context.
 161  * @param environment The possibly null environment that is used in
 162  *              creating the object.
 163  * @return The object created; null if an object cannot be created.
 164  * @exception Exception if this object factory encountered an exception
 165  * while attempting to create an object, and no other object factories are
 166  * to be tried.
 167  *
 168  * @see NamingManager#getObjectInstance
 169  * @see NamingManager#getURLContext
 170  */
 171     public Object getObjectInstance(Object obj, Name name, Context nameCtx,
 172                                     Hashtable<?,?> environment)


 132  * to them, although it may keep references to clones or copies.
 133  *
 134  * <p>
 135  * <b>Name and Context Parameters.</b> &nbsp;&nbsp;&nbsp;
 136  * <a name=NAMECTX></a>
 137  *
 138  * The <code>name</code> and <code>nameCtx</code> parameters may
 139  * optionally be used to specify the name of the object being created.
 140  * <code>name</code> is the name of the object, relative to context
 141  * <code>nameCtx</code>.
 142  * If there are several possible contexts from which the object
 143  * could be named -- as will often be the case -- it is up to
 144  * the caller to select one.  A good rule of thumb is to select the
 145  * "deepest" context available.
 146  * If <code>nameCtx</code> is null, <code>name</code> is relative
 147  * to the default initial context.  If no name is being specified, the
 148  * <code>name</code> parameter should be null.
 149  * If a factory uses <code>nameCtx</code> it should synchronize its use
 150  * against concurrent access, since context implementations are not
 151  * guaranteed to be thread-safe.

 152  *
 153  * @param obj The possibly null object containing location or reference
 154  *              information that can be used in creating an object.
 155  * @param name The name of this object relative to <code>nameCtx</code>,
 156  *              or null if no name is specified.
 157  * @param nameCtx The context relative to which the <code>name</code>
 158  *              parameter is specified, or null if <code>name</code> is
 159  *              relative to the default initial context.
 160  * @param environment The possibly null environment that is used in
 161  *              creating the object.
 162  * @return The object created; null if an object cannot be created.
 163  * @exception Exception if this object factory encountered an exception
 164  * while attempting to create an object, and no other object factories are
 165  * to be tried.
 166  *
 167  * @see NamingManager#getObjectInstance
 168  * @see NamingManager#getURLContext
 169  */
 170     public Object getObjectInstance(Object obj, Name name, Context nameCtx,
 171                                     Hashtable<?,?> environment)