org.apache.struts.tiles.xmlDefinition.XmlAttribute Maven / Gradle / Ivy

Go to download
/*
 * $Id: XmlAttribute.java 471754 2006-11-06 14:55:09Z husted $
 *
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you 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.apache.struts.tiles.xmlDefinition;

import org.apache.struts.tiles.DefinitionNameAttribute;
import org.apache.struts.tiles.DirectStringAttribute;
import org.apache.struts.tiles.PathAttribute;
import org.apache.struts.tiles.UntypedAttribute;

/**
 * A property key-value pair.  This class is used to read configuration files.
 */
public class XmlAttribute {

    /**
     * Attribute name or key.
     */
    private String name = null;

    /**
     * Attribute value.
     * Value read from description file.
     */
    private Object value = null;

    /**
     * Attribute value.
     */
    private String direct = null;

    /**
     * Attribute value.
     */
    private String valueType = null;

    /**
     * Attribute value.
     */
    private String role = null;

    /**
     * Real attribute value.
     * Real value is the value after processing of valueType.
     * I.e. if a type is defined, realValue contains wrapper for this type.
     */
    private Object realValue = null;

    /**
     * Constructor.
     */
    public XmlAttribute() {
        super();
    }

    /**
     * Constructor.
     */
    public XmlAttribute(String name, Object value) {
        this.name = name;
        this.value = value;
    }

    /**
     * Access method for the name property.
     *
     * @return The current value of the name property.
     */
    public String getName() {
        return name;
    }

    /**
     * Sets the value of the name property.
     *
     * @param role the new value of the name property
     */
    public void setRole(String role) {
        this.role = role;
    }

    /**
     * Access method for the name property.
     *
     * @return The current value of the name property.
     */
    public String getRole() {
        return role;
    }

    /**
     * Sets the value of the name property.
     *
     * @param aName the new value of the name property.
     */
    public void setName(String aName) {
        name = aName;
    }

    /**
     * Another access method for the name property.
     *
     * @return   the current value of the name property
     */
    public String getAttribute() {
        return name;
    }

    /**
     * Sets the value of the name property.
     *
     * @param aName the new value of the name property
     */
    public void setAttribute(String aName) {
        name = aName;
    }

    /**
     * Access method for the value property. Return the value or a
     * QualifiedAttribute containing the value if 'direct' is set.
     *
     * @return The current value of the value property.
     */
    public Object getValue() {
        // Compatibility with JSP Template
        if (this.realValue == null) {
            this.realValue = this.computeRealValue();
        }

        return this.realValue;
    }

    /**
     * Sets the value of the value property.
     *
     * @param aValue the new value of the value property
     */
    public void setValue(Object aValue) {
        realValue = null;
        value = aValue;
    }

    /**
     * Sets the value of the value property.
     *
     * @param aValue the new value of the value property
     */
    public void setContent(Object aValue) {
        setValue(aValue);
    }

    /**
     * Sets the value of the value property.
     *
     * @param body the new value of the value property
     */
    public void setBody(String body) {
        if (body.length() == 0) {
            return;
        }

        setValue(body);
    }

    /**
     * Sets the value of the value property.
     *
     * @param value the new value of the value property
     */
    public void setDirect(String value) {
        this.direct = value;
    }

    /**
     * Sets the value of the value property.
     *
     * @param value the new value of the value property
     */
    public void setType(String value) {
        this.valueType = value;
    }

    /**
     * Compute  real value from attributes setting.
     */
    protected Object computeRealValue() {
        Object realValue = value;
        // Is there a type set ?
        // First check direct attribute, and translate it to a valueType.
        // Then, evaluate valueType, and create requested typed attribute.
        if (direct != null) {
            this.valueType =
                Boolean.valueOf(direct).booleanValue() ? "string" : "path";
        }

        if (value != null && valueType != null) {
            String strValue = value.toString();

            if (valueType.equalsIgnoreCase("string")) {
                realValue = new DirectStringAttribute(strValue);

            } else if (valueType.equalsIgnoreCase("page")) {
                realValue = new PathAttribute(strValue);

            } else if (valueType.equalsIgnoreCase("template")) {
                realValue = new PathAttribute(strValue);

            } else if (valueType.equalsIgnoreCase("instance")) {
                realValue = new DefinitionNameAttribute(strValue);
            }

            // Set realValue's role value if needed
            if (role != null) {
                ((UntypedAttribute) realValue).setRole(role);
            }
        }

        // Create attribute wrapper to hold role if role is set and no type
        // specified
        if (role != null && value != null && valueType == null) {
            realValue = new UntypedAttribute(value.toString(), role);
        }

        return realValue;
    }
}