132 * to them, although it may keep references to clones or copies.
133 *
134 * <p>
135 * <b>Name and Context Parameters.</b>
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>
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)
|