basedircontext.java

Tomcat 4.1与WebServer集成组件的源代码包.

/*
 * ====================================================================
 *
 * The Apache Software License, Version 1.1
 *
 * Copyright (c) 1999 The Apache Software Foundation.  All rights
 * reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * 3. The end-user documentation included with the redistribution, if
 *    any, must include the following acknowlegement:
 *       "This product includes software developed by the
 *        Apache Software Foundation (http://www.apache.org/)."
 *    Alternately, this acknowlegement may appear in the software itself,
 *    if and wherever such third-party acknowlegements normally appear.
 *
 * 4. The names "The Jakarta Project", "Tomcat", and "Apache Software
 *    Foundation" must not be used to endorse or promote products derived
 *    from this software without prior written permission. For written
 *    permission, please contact [e-mail].
 *
 * 5. Products derived from this software may not be called "Apache"
 *    nor may "Apache" appear in their names without prior written
 *    permission of the Apache Group.
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of the Apache Software Foundation.  For more
 * information on the Apache Software Foundation, please see
 * <http://www.apache.org/>.
 *
 * [Additional notices, if required by prior licensing conditions]
 *
 */


package org.apache.naming.core;

import java.util.*;
import javax.naming.*;
import javax.naming.directory.DirContext;
import javax.naming.directory.Attributes;
import javax.naming.directory.Attribute;
import javax.naming.directory.ModificationItem;
import javax.naming.directory.SearchControls;

import org.apache.tomcat.util.res.StringManager;

//import org.apache.naming.NameParserImpl;

// Based on a merge of various catalina naming contexts
// Name is used - it provide better oportunities for reuse and optimizations

/**
 * Base Directory Context implementation. All j-t-c/naming contexts should
 * extend it.
 *
 * Implements all JNDI methods - if you just extend it you'll get UnsuportedOperation.
 * XXX Should it also act as introspector proxy or should we use a separate context ?
 * The intention is to allow use 'introspection magic' and bean-like DirContexts.
 *
 * IMPORTANT: all contexts should use setters/getters for configuration, instead
 * of the Hashtable. The default constructor will use introspection to configure
 * and may provide ( via a hook ? ) JMX management on all contexts.
 *
 * You must extend and override few methods. Of course, you can also override any other
 * method and provide a more optimal implementation, but in most cases you only
 * need the minimal set.
 *
 * All methods use Name variant. They should expect an arbitrary implementation, but
 * it's recommended to check if ServerName is used - and take advantage of the
 * specific features ( MessageBytes, etc ).
 *
 * <ul>
 *   <li>
 * </ul>
 *
 * @author Remy Maucherat
 * @author Costin Manolache
 */
public class BaseDirContext extends BaseContext implements DirContext {

    public BaseDirContext()
    {
        super();
    }

    public BaseDirContext(Hashtable env)
    {
        super(env);
    }


    // ----------------------------------------------------- DirContext Methods

    /**
     * Retrieves all of the attributes associated with a named object.
     *
     * @return the set of attributes associated with name.
     * Returns an empty attribute set if name has no attributes; never null.
     * @param name the name of the object from which to retrieve attributes
     * @exception NamingException if a naming exception is encountered
     */
    public Attributes getAttributes(Name name)
            throws NamingException
    {
        return getAttributes(name, null);
    }


    /**
     * Retrieves all of the attributes associated with a named object.
     *
     * @return the set of attributes associated with name
     * @param name the name of the object from which to retrieve attributes
     * @exception NamingException if a naming exception is encountered
     */
    public Attributes getAttributes(String name)
            throws NamingException
    {
        return getAttributes(string2Name(name));
    }

    /**
     * Retrieves selected attributes associated with a named object.
     * See the class description regarding attribute models, attribute type
     * names, and operational attributes.
     *
     * @return the requested attributes; never null
     * @param name the name of the object from which to retrieve attributes
     * @param attrIds the identifiers of the attributes to retrieve. null
     * indicates that all attributes should be retrieved; an empty array
     * indicates that none should be retrieved
     * @exception NamingException if a naming exception is encountered
     */
    public Attributes getAttributes(String name, String[] attrIds)
            throws NamingException
    {
        return getAttributes(string2Name(name), attrIds);
    }

    public Attributes getAttributes(Name name, String[] attrIds)
            throws NamingException
    {
        if( attrIds==null ) {
            attrIds= super.getAttributeNames(name);
        }
        Attributes res=new ServerAttributes();
        if( attrIds==null ) return res;

        for( int i=0; i<attrIds.length; i++ ) {
            Object val=super.getAttribute(name, attrIds[i]);
            res.put( attrIds[i], val );
        }
        return res;
    }


    /**
     * Modifies the attributes associated with a named object. The order of
     * the modifications is not specified. Where possible, the modifications
     * are performed atomically.
     *
     * @param name the name of the object whose attributes will be updated
     * @param mod_op the modification operation, one of: ADD_ATTRIBUTE,
     * REPLACE_ATTRIBUTE, REMOVE_ATTRIBUTE
     * @param attrs the attributes to be used for the modification; may not
     * be null
     * @exception AttributeModificationException if the modification cannot be
     * completed successfully
     * @exception NamingException if a naming exception is encountered
     */
    public void modifyAttributes(Name name, int mod_op, Attributes attrs)
            throws NamingException
    {
        NamingEnumeration enum=attrs.getAll();
        while( enum.hasMoreElements() ) {
            Attribute att=(Attribute)enum.nextElement();
            switch( mod_op ) {
            case ADD_ATTRIBUTE:
            case REPLACE_ATTRIBUTE:
                for( int i=0; i< att.size(); i++ ) {
                    super.setAttribute(name, att.getID(), att.get(i));
                }
                break;
            case REMOVE_ATTRIBUTE:
                break;
            }
        }
    }

    public void modifyAttributes(String name, int mod_op, Attributes attrs)
            throws NamingException
    {
        modifyAttributes(string2Name(name), mod_op, attrs);
    }


    /**
     * Modifies the attributes associated with a named object using an an
     * ordered list of modifications. The modifications are performed in the
     * order specified. Each modification specifies a modification operation
     * code and an attribute on which to operate. Where possible, the
     * modifications are performed atomically.
     *
     * @param name the name of the object whose attributes will be updated
     * @param mods an ordered sequence of modifications to be performed; may
     * not be null
     * @exception AttributeModificationException if the modification cannot be
     * completed successfully
     * @exception NamingException if a naming exception is encountered
     */
    public void modifyAttributes(Name name, ModificationItem[] mods)
            throws NamingException
    {
        if (mods==null) return;
        for (int i=0; i<mods.length; i++) {

            switch( mods[i].getModificationOp() ) {
            case ADD_ATTRIBUTE:
            case REPLACE_ATTRIBUTE:
            case REMOVE_ATTRIBUTE:
            };
        }
    }


    public void modifyAttributes(String name, ModificationItem[] mods)
            throws NamingException
    {
        modifyAttributes(string2Name(name), mods);
    }


    /**
     * Binds a name to an object, along with associated attributes. If attrs
     * is null, the resulting binding will have the attributes associated
     * with obj if obj is a DirContext, and no attributes otherwise. If attrs
     * is non-null, the resulting binding will have attrs as its attributes;
     * any attributes associated with obj are ignored.
     *
     * @param name the name to bind; may not be empty
     * @param obj the object to bind; possibly null
     * @param attrs the attributes to associate with the binding
     * @exception NameAlreadyBoundException if name is already bound
     * @exception InvalidAttributesException if some "mandatory" attributes
     * of the binding are not supplied
     * @exception NamingException if a naming exception is encountered
     */
    public void bind(Name name, Object obj, Attributes attrs)
            throws NamingException
    {
        super.bind( name, obj );

        NamingEnumeration enum=attrs.getAll();
        while( enum.hasMoreElements() ) {
            Attribute att=(Attribute)enum.nextElement();

            Object val=getAttribute(name, att.getID() );
            if( val != null ) {
                throw new NameAlreadyBoundException(name.toString() + " : " +
                        att.getID());
            }

            int size=att.size();
            for( int i=0; i<size; i++ ) {
                // probably need some addAttribute
                setAttribute( name, att.getID(), att.get(i));
            }
        }
    }

    public void bind( String name, Object obj, Attributes attrs )
            throws NamingException
    {
        bind(string2Name(name), obj, attrs);
    }


    /**
     * Binds a name to an object, along with associated attributes,
     * overwriting any existing binding. If attrs is null and obj is a
     * DirContext, the attributes from obj are used. If attrs is null and obj
     * is not a DirContext, any existing attributes associated with the object
     * already bound in the directory remain unchanged. If attrs is non-null,
     * any existing attributes associated with the object already bound in
     * the directory are removed and attrs is associated with the named
     * object. If obj is a DirContext and attrs is non-null, the attributes
     * of obj are ignored.
     *
     * @param name the name to bind; may not be empty
     * @param obj the object to bind; possibly null
     * @param attrs the attributes to associate with the binding
     * @exception InvalidAttributesException if some "mandatory" attributes
     * of the binding are not supplied
     * @exception NamingException if a naming exception is encountered