org.acegisecurity.ConfigAttributeDefinition Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of acegi-security
There is a newer version: 1.0.7
/* Copyright 2004 Acegi Technology Pty Limited
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.acegisecurity;

import java.io.Serializable;

import java.util.Iterator;
import java.util.List;
import java.util.Vector;


/**
 * Holds a group of {@link ConfigAttribute}s that are associated with a given
 * secure object target.
 * 
 * 
 * All the ConfigAttributeDefinitions associated with a given
 * {@link org.acegisecurity.intercept.AbstractSecurityInterceptor} are
 * stored in an {@link org.acegisecurity.intercept.ObjectDefinitionSource}.
 * 
 *
 * @author Ben Alex
 * @version $Id: ConfigAttributeDefinition.java,v 1.7 2005/11/17 00:55:49 benalex Exp $
 */
public class ConfigAttributeDefinition implements Serializable {
    //~ Instance fields ========================================================

    private List configAttributes = new Vector();

    //~ Constructors ===========================================================

    public ConfigAttributeDefinition() {
        super();
    }

    //~ Methods ================================================================

    /**
     * Returns an Iterator over all the
     * ConfigAttributes defined by this
     * ConfigAttributeDefinition.
     * 
     * 
     * Allows AccessDecisionManagers and other classes to loop
     * through every configuration attribute associated with a target secure
     * object.
     * 
     *
     * @return all the configuration attributes stored by the instance, or
     *         null if an Iterator is unavailable
     */
    public Iterator getConfigAttributes() {
        return this.configAttributes.iterator();
    }

    /**
     * Adds a ConfigAttribute that is related to the secure object
     * method.
     *
     * @param newConfigAttribute the new configuration attribute to add
     */
    public void addConfigAttribute(ConfigAttribute newConfigAttribute) {
        this.configAttributes.add(newConfigAttribute);
    }

    /**
     * Indicates whether the specified ConfigAttribute is
     * contained within this ConfigAttributeDefinition.
     *
     * @param configAttribute the attribute to locate
     *
     * @return true if the specified ConfigAttribute
     *         is contained, false otherwise
     */
    public boolean contains(ConfigAttribute configAttribute) {
        return configAttributes.contains(configAttribute);
    }

    public boolean equals(Object obj) {
        if (obj instanceof ConfigAttributeDefinition) {
            ConfigAttributeDefinition test = (ConfigAttributeDefinition) obj;

            List testAttrs = new Vector();
            Iterator iter = test.getConfigAttributes();

            while (iter.hasNext()) {
                ConfigAttribute attr = (ConfigAttribute) iter.next();
                testAttrs.add(attr);
            }

            if (this.configAttributes.size() != testAttrs.size()) {
                return false;
            }

            for (int i = 0; i < this.configAttributes.size(); i++) {
                if (!this.configAttributes.get(i).equals(testAttrs.get(i))) {
                    return false;
                }
            }

            return true;
        }

        return false;
    }

    /**
     * Returns the number of ConfigAttributes defined by this
     * ConfigAttributeDefinition.
     *
     * @return the number of ConfigAttributes contained
     */
    public int size() {
        return configAttributes.size();
    }

    public String toString() {
        return this.configAttributes.toString();
    }
}