20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 
  27 package javax.naming.spi;
  28 
  29 import javax.naming.Context;
  30 import javax.naming.Name;
  31 import javax.naming.NamingException;
  32 
  33 /**
  34   * This interface represents an "intermediate context" for name resolution.
  35   *<p>
  36   * The Resolver interface contains methods that are implemented by contexts
  37   * that do not support subtypes of Context, but which can act as
  38   * intermediate contexts for resolution purposes.
  39   *<p>
  40   * A <tt>Name</tt> parameter passed to any method is owned
  41   * by the caller.  The service provider will not modify the object
  42   * or keep a reference to it.
  43   * A <tt>ResolveResult</tt> object returned by any
  44   * method is owned by the caller.  The caller may subsequently modify it;
  45   * the service provider may not.
  46   *
  47   * @author Rosanna Lee
  48   * @author Scott Seligman
  49   * @since 1.3
  50   */
  51 
  52 public interface Resolver {
  53 
  54     /**
  55      * Partially resolves a name.  Stops at the first
  56      * context that is an instance of a given subtype of
  57      * <code>Context</code>.
  58      *
  59      * @param name
  60      *          the name to resolve
  61      * @param contextType
  62      *          the type of object to resolve.  This should
  63      *          be a subtype of <code>Context</code>.

  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 
  27 package javax.naming.spi;
  28 
  29 import javax.naming.Context;
  30 import javax.naming.Name;
  31 import javax.naming.NamingException;
  32 
  33 /**
  34   * This interface represents an "intermediate context" for name resolution.
  35   *<p>
  36   * The Resolver interface contains methods that are implemented by contexts
  37   * that do not support subtypes of Context, but which can act as
  38   * intermediate contexts for resolution purposes.
  39   *<p>
  40   * A {@code Name} parameter passed to any method is owned
  41   * by the caller.  The service provider will not modify the object
  42   * or keep a reference to it.
  43   * A {@code ResolveResult} object returned by any
  44   * method is owned by the caller.  The caller may subsequently modify it;
  45   * the service provider may not.
  46   *
  47   * @author Rosanna Lee
  48   * @author Scott Seligman
  49   * @since 1.3
  50   */
  51 
  52 public interface Resolver {
  53 
  54     /**
  55      * Partially resolves a name.  Stops at the first
  56      * context that is an instance of a given subtype of
  57      * <code>Context</code>.
  58      *
  59      * @param name
  60      *          the name to resolve
  61      * @param contextType
  62      *          the type of object to resolve.  This should
  63      *          be a subtype of <code>Context</code>.