Class CustomTag
java.lang.Object
com.opensymphony.module.sitemesh.html.CustomTag
- All Implemented Interfaces:
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.
- See Also:
-
Field Summary
Fields inherited from interface com.opensymphony.module.sitemesh.html.Tag
CLOSE, CLOSE_MAGIC_COMMENT, EMPTY, OPEN, OPEN_MAGIC_COMMENT -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionintaddAttribute(String name, String value) Add a new attribute.booleanintNumber of attributes in tag.intgetAttributeIndex(String name, boolean caseSensitive) Determine which attribute has the specified name.getAttributeName(int index) Get name of attribute.getAttributeValue(int index) Get value of an attribute.getAttributeValue(String name, boolean caseSensitive) Get value of an attribute.Get the complete tag in its original form, preserving original formatting.getName()Name of tag (ie.intgetType()Type of tag:
<blah> - Tag.OPEN
</blah> - Tag.CLOSE
<blah/> - Tag.EMPTYbooleanhasAttribute(String name, boolean caseSensitive) Determine if an attribute is present.inthashCode()voidremoveAttribute(int attributeIndex) Remove an attribute.voidremoveAttribute(String name, boolean caseSensitive) Change the value of an attribute, or add an attribute if it does not already exist.voidsetAttributeName(int attributeIndex, String name) Change the name of an existing attribute.voidsetAttributeValue(int attributeIndex, String value) Change the value of an existing attribute.voidsetAttributeValue(String name, boolean caseSensitive, String value) Change the value of an attribute, or add an attribute if it does not already exist.voidChange the name of the attribute.voidsetType(int type) Change the type of the tag.toString()voidWrite out the complete tag in its original form, preserving original formatting.
-
Constructor Details
-
CustomTag
Type of tag:
<blah> - Tag.OPEN
</blah> - Tag.CLOSE
<blah/> - Tag.EMPTY -
CustomTag
Create a CustomTag based on an existing Tag - this takes a copy of the Tag.
-
-
Method Details
-
getContents
Description copied from interface:TagGet 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:
getContentsin interfaceTag- See Also:
-
writeTo
Description copied from interface:TagWrite out the complete tag in its original form, preserving original formatting. -
equals
-
hashCode
public int hashCode() -
toString
-
getAttributeCount
public int getAttributeCount()Description copied from interface:TagNumber of attributes in tag.- Specified by:
getAttributeCountin interfaceTag
-
getAttributeIndex
Description copied from interface:TagDetermine which attribute has the specified name.- Specified by:
getAttributeIndexin interfaceTag
-
getAttributeName
Description copied from interface:TagGet name of attribute.- Specified by:
getAttributeNamein interfaceTag
-
getAttributeValue
Description copied from interface:TagGet value of an attribute. If this is an empty attribute (i.e. just a name, without a value), null is returned.- Specified by:
getAttributeValuein interfaceTag
-
getAttributeValue
Description copied from interface:TagGet value of an attribute. If this is an empty attribute (i.e. just a name, without a value), null is returned.- Specified by:
getAttributeValuein interfaceTag
-
hasAttribute
Description copied from interface:TagDetermine if an attribute is present.- Specified by:
hasAttributein interfaceTag
-
getName
Description copied from interface:TagName of tag (ie. element name). -
getType
public int getType()Type of tag:
<blah> - Tag.OPEN
</blah> - Tag.CLOSE
<blah/> - Tag.EMPTY -
setName
Change the name of the attribute. -
setType
public void setType(int type) Change the type of the tag. Type of tag:
<blah> - Tag.OPEN
</blah> - Tag.CLOSE
<blah/> - Tag.EMPTY -
addAttribute
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
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
Change the name of an existing attribute. -
setAttributeValue
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
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.
-