/**
 * 
 */
package org.eclipse.jst.pagedesigner.itemcreation.customizer;

import org.eclipse.jst.jsf.common.dom.TagIdentifier;


/**
 * Represents a writable customization data object.
 * 
 * @see ICustomizationData 
 * 
 * @author Debajit Adhikary
 *
 */
public interface IWritableCustomizationData extends ICustomizationData
{
    //------------------------------------------------------------
    // Methods to set the tag identifier information  
    //------------------------------------------------------------

    
    /**
     * Sets the tag identifier associated with a customization data object
     * 
     * @param tagId
     *            The tag identifier to set it to
     *            
     */
    public void setTagIdentifier(TagIdentifier tagId);
    
    
    //------------------------------------------------------------
    // Methods to set attribute data
    //------------------------------------------------------------

    
    /**
     * Sets the attribute data for an existing customization data object
     * 
     * @param attrs
     *            The AttributeData object to set it to
     *            
     */
    public void setAttributes(AttributeData attrs);

    
    /**
     * Adds one attribute to an existing customization data object.
     * 
     * @param attributeName
     *            The name of the attribute
     * @param attributeValue
     *            The value of this attribute
     * 
     */
    public void addAttribute(String attributeName, String attributeValue);

    
    //------------------------------------------------------------
    // Methods to set child data 
    //------------------------------------------------------------
    

    /**
     * Sets the child tag(s) customization information for an existing customization
     * data object
     * 
     * @param data
     *            The ChildrenData object to set it to
     * 
     */
    public void setChildrenData(ChildrenData data);
    
    
    /**
     * Adds a child to an existing tag. (Adds the child's customization data to
     * the existing tag's customization data)
     * 
     * @param childrenData
     *            Customization Data for a child
     * 
     */
    public void addChildData (ICustomizationData childrenData);

    
    //------------------------------------------------------------
    // Methods to set parent customization data
    //------------------------------------------------------------
    
    /**
     * Sets parent customization information for an existing tag's customization
     * data
     * 
     * @param parentData
     *            The parent data to set it to
     * 
     */
    public void setParentData(ParentData parentData);

    
    /**
     * Attaches a parent to a tag (The customization data for a parent is added
     * to the tag's customization data). The oldest parent (outermost container
     * tag) should be attached (added) first.
     * 
     * @param parentData
     *            Parent customization data
     */
    public void addParentData (ICustomizationData parentData);
    
}