Class TagInfo

public TagInfo(String tagName,
               String tagClassName,
               String bodycontent,
               String infoString,
               TagLibraryInfo taglib,
               TagExtraInfo tagExtraInfo,
               TagAttributeInfo[] attributeInfo)

Constructor for TagInfo from data in the JSP 1.1 format for TLD. This class is to be instantiated only from the TagLibrary code under request from some JSP code that is parsing a TLD (Tag Library Descriptor). Note that, since TagLibibraryInfo reflects both TLD information and taglib directive information, a TagInfo instance is dependent on a taglib directive. This is probably a design error, which may be fixed in the future.

Parameters:

tagName - The name of this tag

tagClassName - The name of the tag handler class

bodycontent - Information on the body content of these tags

infoString - The (optional) string information for this tag

taglib - The instance of the tag library that contains us.

tagExtraInfo - The instance providing extra Tag info. May be null

attributeInfo - An array of AttributeInfo data from descriptor. May be null;

public TagInfo(String tagName,
               String tagClassName,
               String bodycontent,
               String infoString,
               TagLibraryInfo taglib,
               TagExtraInfo tagExtraInfo,
               TagAttributeInfo[] attributeInfo,
               String displayName,
               String smallIcon,
               String largeIcon,
               TagVariableInfo[] tvi)

Constructor for TagInfo from data in the JSP 1.2 format for TLD. This class is to be instantiated only from the TagLibrary code under request from some JSP code that is parsing a TLD (Tag Library Descriptor). Note that, since TagLibibraryInfo reflects both TLD information and taglib directive information, a TagInfo instance is dependent on a taglib directive. This is probably a design error, which may be fixed in the future.

Parameters:

tagName - The name of this tag

tagClassName - The name of the tag handler class

bodycontent - Information on the body content of these tags

infoString - The (optional) string information for this tag

taglib - The instance of the tag library that contains us.

tagExtraInfo - The instance providing extra Tag info. May be null

attributeInfo - An array of AttributeInfo data from descriptor. May be null;

displayName - A short name to be displayed by tools

smallIcon - Path to a small icon to be displayed by tools

largeIcon - Path to a large icon to be displayed by tools

tvi - An array of a TagVariableInfo (or null)

public TagInfo(String tagName,
               String tagClassName,
               String bodycontent,
               String infoString,
               TagLibraryInfo taglib,
               TagExtraInfo tagExtraInfo,
               TagAttributeInfo[] attributeInfo,
               String displayName,
               String smallIcon,
               String largeIcon,
               TagVariableInfo[] tvi,
               boolean dynamicAttributes)

Constructor for TagInfo from data in the JSP 2.0 format for TLD. This class is to be instantiated only from the TagLibrary code under request from some JSP code that is parsing a TLD (Tag Library Descriptor). Note that, since TagLibibraryInfo reflects both TLD information and taglib directive information, a TagInfo instance is dependent on a taglib directive. This is probably a design error, which may be fixed in the future.

Parameters:

tagName - The name of this tag

tagClassName - The name of the tag handler class

bodycontent - Information on the body content of these tags

infoString - The (optional) string information for this tag

taglib - The instance of the tag library that contains us.

tagExtraInfo - The instance providing extra Tag info. May be null

attributeInfo - An array of AttributeInfo data from descriptor. May be null;

displayName - A short name to be displayed by tools

smallIcon - Path to a small icon to be displayed by tools

largeIcon - Path to a large icon to be displayed by tools

tvi - An array of a TagVariableInfo (or null)

dynamicAttributes - True if supports dynamic attributes

Since:

2.0

public TagAttributeInfo[] getAttributes()

Attribute information (in the TLD) on this tag. The return is an array describing the attributes of this tag, as indicated in the TLD.

Returns:

The array of TagAttributeInfo for this tag, or a zero-length array if the tag has no attributes.

public TagExtraInfo getTagExtraInfo()

The instance (if any) for extra tag information.

Returns:

The TagExtraInfo instance, if any.

public TagLibraryInfo getTagLibrary()

The instance of TabLibraryInfo we belong to.

Returns:

the tag library instance we belong to

public TagVariableInfo[] getTagVariableInfos()

Get TagVariableInfo objects associated with this TagInfo.

Returns:

Array of TagVariableInfo objects corresponding to variables declared by this tag, or a zero length array if no variables have been declared

public VariableInfo[] getVariableInfo(TagData data)

Information on the scripting objects created by this tag at runtime. This is a convenience method on the associated TagExtraInfo class.

Parameters:

data - TagData describing this action.

Returns:

if a TagExtraInfo object is associated with this TagInfo, the result of getTagExtraInfo().getVariableInfo( data ), otherwise null.

public boolean isValid(TagData data)

Translation-time validation of the attributes. This is a convenience method on the associated TagExtraInfo class.

Parameters:

data - The translation-time TagData instance.

Returns:

Whether the data is valid.

public void setTagExtraInfo(TagExtraInfo tei)

Set the instance for extra tag information.

Parameters:

tei - the TagExtraInfo instance

public void setTagLibrary(TagLibraryInfo tl)

Set the TagLibraryInfo property. Note that a TagLibraryInfo element is dependent not just on the TLD information but also on the specific taglib instance used. This means that a fair amount of work needs to be done to construct and initialize TagLib objects. If used carefully, this setter can be used to avoid having to create new TagInfo elements for each taglib directive.

Parameters:

tl - the TagLibraryInfo to assign

public ValidationMessage[] validate(TagData data)

Translation-time validation of the attributes. This is a convenience method on the associated TagExtraInfo class.

Parameters:

data - The translation-time TagData instance.

Returns:

A null object, or zero length array if no errors, an array of ValidationMessages otherwise.

Since:

2.0