org.sitemesh.tagprocessor
Class CustomTag

java.lang.Object
  org.sitemesh.tagprocessor.CustomTag

All Implemented Interfaces:

Tag

public class CustomTag
extends Object
implements Tag

A CustomTag provides a mechanism to manipulate the contents of a Tag. The standard Tag implementations are immutable, however CustomTag allows a copy to be taken of an immutable Tag that can then be manipulated.

Author:

Joe Walnes

See Also:

Tag

Nested Class Summary

Nested classes/interfaces inherited from interface org.sitemesh.tagprocessor.Tag

Tag.Type

Constructor Summary

CustomTag(String name, Tag.Type type)
Create new tag.

CustomTag(Tag tag)
Create a CustomTag based on an existing Tag - this takes a copy of the Tag.

Method Summary

int	addAttribute(String name, String value) Add a new attribute.
boolean	equals(Object o)
int	getAttributeCount() Number of attributes in tag.
int	getAttributeIndex(String name, boolean caseSensitive) Determine which attribute has the specified name.
String	getAttributeName(int index) Get name of attribute.
String	getAttributeValue(int index) Get value of an attribute.
String	getAttributeValue(String name, boolean caseSensitive) Get value of an attribute.
String	getName() Name of tag (ie.
Tag.Type	getType() Type of tag.
boolean	hasAttribute(String name, boolean caseSensitive) Determine if an attribute is present.
int	hashCode()
void	removeAttribute(int attributeIndex) Remove an attribute.
void	removeAttribute(String name, boolean caseSensitive) Change the value of an attribute, or add an attribute if it does not already exist.
void	setAttributeName(int attributeIndex, String name) Change the name of an existing attribute.
void	setAttributeValue(int attributeIndex, String value) Change the value of an existing attribute.
void	setAttributeValue(String name, boolean caseSensitive, String value) Change the value of an attribute, or add an attribute if it does not already exist.
void	setName(String name) Change the name of the attribute.
void	setType(Tag.Type type) Change the type of the tag.
String	toString() Get the complete tag in its original form, preserving original formatting.
void	writeTo(Appendable out) Write out the complete tag in its original form, preserving original formatting.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CustomTag

public CustomTag(String name,
                 Tag.Type type)

Create new tag.

CustomTag

public CustomTag(Tag tag)

Create a CustomTag based on an existing Tag - this takes a copy of the Tag.

Method Detail

writeTo

public void writeTo(Appendable out)
             throws IOException

Description copied from interface: Tag

Write out the complete tag in its original form, preserving original formatting.

Specified by:

writeTo in interface Tag

Throws:

IOException

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Description copied from interface: Tag

Get the complete tag in its original form, preserving original formatting.

This has a slight overhead in that it needs to construct a String. For improved performance, use writeTo() instead.

Specified by:

toString in interface Tag

Overrides:

toString in class Object

See Also:

Tag.writeTo(Appendable)

getAttributeCount

public int getAttributeCount()

Description copied from interface: Tag

Number of attributes in tag.

Specified by:

getAttributeCount in interface Tag

getAttributeIndex

public int getAttributeIndex(String name,
                             boolean caseSensitive)

Description copied from interface: Tag

Determine which attribute has the specified name.

Specified by:

getAttributeIndex in interface Tag

getAttributeName

public String getAttributeName(int index)

Description copied from interface: Tag

Get name of attribute.

Specified by:

getAttributeName in interface Tag

getAttributeValue

public String getAttributeValue(int index)

Description copied from interface: Tag

Get value of an attribute. If this is an empty attribute (i.e. just a name, without a value), null is returned.

Specified by:

getAttributeValue in interface Tag

getAttributeValue

public String getAttributeValue(String name,
                                boolean caseSensitive)

Description copied from interface: Tag

Get value of an attribute. If this is an empty attribute (i.e. just a name, without a value), null is returned.

Specified by:

getAttributeValue in interface Tag

hasAttribute

public boolean hasAttribute(String name,
                            boolean caseSensitive)

Description copied from interface: Tag

Determine if an attribute is present.

Specified by:

hasAttribute in interface Tag

getName

public String getName()

Description copied from interface: Tag

Name of tag (ie. element name).

Specified by:

getName in interface Tag

getType

public Tag.Type getType()

Type of tag.

Specified by:

getType in interface Tag

See Also:

Tag.Type

setName

public void setName(String name)

Change the name of the attribute.

setType

public void setType(Tag.Type type)

Change the type of the tag.

addAttribute

public int addAttribute(String name,
                        String value)

Add a new attribute. This does not check for the existence of an attribute with the same name, thus allowing duplicate attributes.

Parameters:

name - Name of attribute to change.

value - New value of attribute or null for an HTML style empty attribute.

Returns:

Index of new attribute.

setAttributeValue

public void setAttributeValue(String name,
                              boolean caseSensitive,
                              String value)

Change the value of an attribute, or add an attribute if it does not already exist.

Parameters:

name - Name of attribute to change.

caseSensitive - Whether the name should be treated as case sensitive when searching for an existing value.

value - New value of attribute or null for an HTML style empty attribute.

setAttributeName

public void setAttributeName(int attributeIndex,
                             String name)

Change the name of an existing attribute.

setAttributeValue

public void setAttributeValue(int attributeIndex,
                              String value)

Change the value of an existing attribute. The value may be null for an HTML style empty attribute.

removeAttribute

public void removeAttribute(int attributeIndex)

Remove an attribute.

removeAttribute

public void removeAttribute(String name,
                            boolean caseSensitive)

Change the value of an attribute, or add an attribute if it does not already exist.

Parameters:

name - Name of attribute to remove.

caseSensitive - Whether the name should be treated as case sensitive.