/*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package com.sun.jndi.toolkit.url;
import javax.naming.*;
import javax.naming.directory.*;
import javax.naming.spi.ResolveResult;
import javax.naming.spi.DirectoryManager;
import java.util.Hashtable;
/**
* This abstract class is a generic URL DirContext that accepts as the
* name argument either a string URL or a Name whose first component
* is a URL. It resolves the URL to a target context and then continues
* the operation using the remaining name in the target context as if
* the first component names a junction.
*
* A subclass must define getRootURLContext()
* to process the URL into head/tail pieces. If it wants to control how
* URL strings are parsed and compared for the rename() operation, then
* it should override getNonRootURLSuffixes() and urlEquals().
*
* @author Scott Seligman
* @author Rosanna Lee
*/
abstract public class GenericURLDirContext extends GenericURLContext
implements DirContext {
protected GenericURLDirContext(Hashtable env) {
super(env);
}
/**
* Gets the context in which to continue the operation. This method
* is called when this context is asked to process a multicomponent
* Name in which the first component is a URL.
* Treat the first component like a junction: resolve it and then use
* DirectoryManager.getContinuationDirContext() to get the target context in
* which to operate on the remainder of the name (n.getSuffix(1)).
* Do this in case intermediate contexts are not DirContext.
*/
protected DirContext getContinuationDirContext(Name n) throws NamingException {
Object obj = lookup(n.get(0));
CannotProceedException cpe = new CannotProceedException();
cpe.setResolvedObj(obj);
cpe.setEnvironment(myEnv);
return DirectoryManager.getContinuationDirContext(cpe);
}
public Attributes getAttributes(String name) throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
return ctx.getAttributes(res.getRemainingName());
} finally {
ctx.close();
}
}
public Attributes getAttributes(Name name) throws NamingException {
if (name.size() == 1) {
return getAttributes(name.get(0));
} else {
DirContext ctx = getContinuationDirContext(name);
try {
return ctx.getAttributes(name.getSuffix(1));
} finally {
ctx.close();
}
}
}
public Attributes getAttributes(String name, String[] attrIds)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
return ctx.getAttributes(res.getRemainingName(), attrIds);
} finally {
ctx.close();
}
}
public Attributes getAttributes(Name name, String[] attrIds)
throws NamingException {
if (name.size() == 1) {
return getAttributes(name.get(0), attrIds);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
return ctx.getAttributes(name.getSuffix(1), attrIds);
} finally {
ctx.close();
}
}
}
public void modifyAttributes(String name, int mod_op, Attributes attrs)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
ctx.modifyAttributes(res.getRemainingName(), mod_op, attrs);
} finally {
ctx.close();
}
}
public void modifyAttributes(Name name, int mod_op, Attributes attrs)
throws NamingException {
if (name.size() == 1) {
modifyAttributes(name.get(0), mod_op, attrs);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
ctx.modifyAttributes(name.getSuffix(1), mod_op, attrs);
} finally {
ctx.close();
}
}
}
public void modifyAttributes(String name, ModificationItem[] mods)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
ctx.modifyAttributes(res.getRemainingName(), mods);
} finally {
ctx.close();
}
}
public void modifyAttributes(Name name, ModificationItem[] mods)
throws NamingException {
if (name.size() == 1) {
modifyAttributes(name.get(0), mods);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
ctx.modifyAttributes(name.getSuffix(1), mods);
} finally {
ctx.close();
}
}
}
public void bind(String name, Object obj, Attributes attrs)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
ctx.bind(res.getRemainingName(), obj, attrs);
} finally {
ctx.close();
}
}
public void bind(Name name, Object obj, Attributes attrs)
throws NamingException {
if (name.size() == 1) {
bind(name.get(0), obj, attrs);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
ctx.bind(name.getSuffix(1), obj, attrs);
} finally {
ctx.close();
}
}
}
public void rebind(String name, Object obj, Attributes attrs)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
ctx.rebind(res.getRemainingName(), obj, attrs);
} finally {
ctx.close();
}
}
public void rebind(Name name, Object obj, Attributes attrs)
throws NamingException {
if (name.size() == 1) {
rebind(name.get(0), obj, attrs);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
ctx.rebind(name.getSuffix(1), obj, attrs);
} finally {
ctx.close();
}
}
}
public DirContext createSubcontext(String name, Attributes attrs)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
return ctx.createSubcontext(res.getRemainingName(), attrs);
} finally {
ctx.close();
}
}
public DirContext createSubcontext(Name name, Attributes attrs)
throws NamingException {
if (name.size() == 1) {
return createSubcontext(name.get(0), attrs);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
return ctx.createSubcontext(name.getSuffix(1), attrs);
} finally {
ctx.close();
}
}
}
public DirContext getSchema(String name) throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
return ctx.getSchema(res.getRemainingName());
}
public DirContext getSchema(Name name) throws NamingException {
if (name.size() == 1) {
return getSchema(name.get(0));
} else {
DirContext ctx = getContinuationDirContext(name);
try {
return ctx.getSchema(name.getSuffix(1));
} finally {
ctx.close();
}
}
}
public DirContext getSchemaClassDefinition(String name)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
return ctx.getSchemaClassDefinition(res.getRemainingName());
} finally {
ctx.close();
}
}
public DirContext getSchemaClassDefinition(Name name)
throws NamingException {
if (name.size() == 1) {
return getSchemaClassDefinition(name.get(0));
} else {
DirContext ctx = getContinuationDirContext(name);
try {
return ctx.getSchemaClassDefinition(name.getSuffix(1));
} finally {
ctx.close();
}
}
}
public NamingEnumeration<SearchResult> search(String name,
Attributes matchingAttributes)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
return ctx.search(res.getRemainingName(), matchingAttributes);
} finally {
ctx.close();
}
}
public NamingEnumeration<SearchResult> search(Name name,
Attributes matchingAttributes)
throws NamingException {
if (name.size() == 1) {
return search(name.get(0), matchingAttributes);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
return ctx.search(name.getSuffix(1), matchingAttributes);
} finally {
ctx.close();
}
}
}
public NamingEnumeration<SearchResult> search(String name,
Attributes matchingAttributes,
String[] attributesToReturn)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
return ctx.search(res.getRemainingName(),
matchingAttributes, attributesToReturn);
} finally {
ctx.close();
}
}
public NamingEnumeration<SearchResult> search(Name name,
Attributes matchingAttributes,
String[] attributesToReturn)
throws NamingException {
if (name.size() == 1) {
return search(name.get(0), matchingAttributes,
attributesToReturn);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
return ctx.search(name.getSuffix(1),
matchingAttributes, attributesToReturn);
} finally {
ctx.close();
}
}
}
public NamingEnumeration<SearchResult> search(String name,
String filter,
SearchControls cons)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
return ctx.search(res.getRemainingName(), filter, cons);
} finally {
ctx.close();
}
}
public NamingEnumeration<SearchResult> search(Name name,
String filter,
SearchControls cons)
throws NamingException {
if (name.size() == 1) {
return search(name.get(0), filter, cons);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
return ctx.search(name.getSuffix(1), filter, cons);
} finally {
ctx.close();
}
}
}
public NamingEnumeration<SearchResult> search(String name,
String filterExpr,
Object[] filterArgs,
SearchControls cons)
throws NamingException {
ResolveResult res = getRootURLContext(name, myEnv);
DirContext ctx = (DirContext)res.getResolvedObj();
try {
return
ctx.search(res.getRemainingName(), filterExpr, filterArgs, cons);
} finally {
ctx.close();
}
}
public NamingEnumeration<SearchResult> search(Name name,
String filterExpr,
Object[] filterArgs,
SearchControls cons)
throws NamingException {
if (name.size() == 1) {
return search(name.get(0), filterExpr, filterArgs, cons);
} else {
DirContext ctx = getContinuationDirContext(name);
try {
return ctx.search(name.getSuffix(1), filterExpr, filterArgs, cons);
} finally {
ctx.close();
}
}
}
}