0N/A/*
2362N/A * Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/A
0N/Apackage javax.naming.spi;
0N/A
0N/Aimport javax.naming.Context;
0N/Aimport javax.naming.Name;
0N/Aimport javax.naming.NamingException;
0N/A
0N/A/**
0N/A * This interface represents an "intermediate context" for name resolution.
0N/A *<p>
0N/A * The Resolver interface contains methods that are implemented by contexts
0N/A * that do not support subtypes of Context, but which can act as
0N/A * intermediate contexts for resolution purposes.
0N/A *<p>
0N/A * A <tt>Name</tt> parameter passed to any method is owned
0N/A * by the caller. The service provider will not modify the object
0N/A * or keep a reference to it.
0N/A * A <tt>ResolveResult</tt> object returned by any
0N/A * method is owned by the caller. The caller may subsequently modify it;
0N/A * the service provider may not.
0N/A *
0N/A * @author Rosanna Lee
0N/A * @author Scott Seligman
0N/A * @since 1.3
0N/A */
0N/A
0N/Apublic interface Resolver {
0N/A
0N/A /**
0N/A * Partially resolves a name. Stops at the first
0N/A * context that is an instance of a given subtype of
0N/A * <code>Context</code>.
0N/A *
0N/A * @param name
0N/A * the name to resolve
0N/A * @param contextType
0N/A * the type of object to resolve. This should
0N/A * be a subtype of <code>Context</code>.
0N/A * @return the object that was found, along with the unresolved
0N/A * suffix of <code>name</code>. Cannot be null.
0N/A *
0N/A * @throws javax.naming.NotContextException
0N/A * if no context of the appropriate type is found
0N/A * @throws NamingException if a naming exception was encountered
0N/A *
0N/A * @see #resolveToClass(String, Class)
0N/A */
0N/A public ResolveResult resolveToClass(Name name,
0N/A Class<? extends Context> contextType)
0N/A throws NamingException;
0N/A
0N/A /**
0N/A * Partially resolves a name.
0N/A * See {@link #resolveToClass(Name, Class)} for details.
0N/A *
0N/A * @param name
0N/A * the name to resolve
0N/A * @param contextType
0N/A * the type of object to resolve. This should
0N/A * be a subtype of <code>Context</code>.
0N/A * @return the object that was found, along with the unresolved
0N/A * suffix of <code>name</code>. Cannot be null.
0N/A *
0N/A * @throws javax.naming.NotContextException
0N/A * if no context of the appropriate type is found
0N/A * @throws NamingException if a naming exception was encountered
0N/A */
0N/A public ResolveResult resolveToClass(String name,
0N/A Class<? extends Context> contextType)
0N/A throws NamingException;
0N/A};