Java EE 5 SDK

javax.servlet.jsp.tagext
Class TagLibraryInfo

java.lang.Object
  extended by javax.servlet.jsp.tagext.TagLibraryInfo

public abstract class TagLibraryInfo
extends Object

Translation-time information associated with a taglib directive, and its underlying TLD file. Most of the information is directly from the TLD, except for the prefix and the uri values used in the taglib directive


Field Summary
protected  FunctionInfo[] functions
          An array describing the functions that are defined in this tag library.
protected  String info
          Information (documentation) for this TLD.
protected  String jspversion
          The version of the JSP specification this tag library is written to.
protected  String prefix
          The prefix assigned to this taglib from the taglib directive.
protected  String shortname
          The preferred short name (prefix) as indicated in the TLD.
protected  TagFileInfo[] tagFiles
          An array describing the tag files that are defined in this tag library.
protected  TagInfo[] tags
          An array describing the tags that are defined in this tag library.
protected  String tlibversion
          The version of the tag library.
protected  String uri
          The value of the uri attribute from the taglib directive for this library.
protected  String urn
          The "reliable" URN indicated in the TLD.
 
Constructor Summary
protected TagLibraryInfo(String prefix, String uri)
          Constructor.
 
Method Summary
 FunctionInfo getFunction(String name)
          Get the FunctionInfo for a given function name, looking through all the functions in this tag library.
 FunctionInfo[] getFunctions()
          An array describing the functions that are defined in this tag library.
 String getInfoString()
          Information (documentation) for this TLD.
 String getPrefixString()
          The prefix assigned to this taglib from the taglib directive
 String getReliableURN()
          The "reliable" URN indicated in the TLD (the uri element).
 String getRequiredVersion()
          A string describing the required version of the JSP container.
 String getShortName()
          The preferred short name (prefix) as indicated in the TLD.
 TagInfo getTag(String shortname)
          Get the TagInfo for a given tag name, looking through all the tags in this tag library.
 TagFileInfo getTagFile(String shortname)
          Get the TagFileInfo for a given tag name, looking through all the tag files in this tag library.
 TagFileInfo[] getTagFiles()
          An array describing the tag files that are defined in this tag library.
abstract  TagLibraryInfo[] getTagLibraryInfos()
          Returns an array of TagLibraryInfo objects representing the entire set of tag libraries (including this TagLibraryInfo) imported by taglib directives in the translation unit that references this TagLibraryInfo.
 TagInfo[] getTags()
          An array describing the tags that are defined in this tag library.
 String getURI()
          The value of the uri attribute from the taglib directive for this library.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

prefix

protected String prefix
The prefix assigned to this taglib from the taglib directive.


uri

protected String uri
The value of the uri attribute from the taglib directive for this library.


tags

protected TagInfo[] tags
An array describing the tags that are defined in this tag library.


tagFiles

protected TagFileInfo[] tagFiles
An array describing the tag files that are defined in this tag library.

Since:
JSP 2.0

functions

protected FunctionInfo[] functions
An array describing the functions that are defined in this tag library.

Since:
JSP 2.0

tlibversion

protected String tlibversion
The version of the tag library.


jspversion

protected String jspversion
The version of the JSP specification this tag library is written to.


shortname

protected String shortname
The preferred short name (prefix) as indicated in the TLD.


urn

protected String urn
The "reliable" URN indicated in the TLD.


info

protected String info
Information (documentation) for this TLD.

Constructor Detail

TagLibraryInfo

protected TagLibraryInfo(String prefix,
                         String uri)
Constructor.

Parameters:
prefix - the prefix actually used by the taglib directive
uri - the URI actually used by the taglib directive
Method Detail

getURI

public String getURI()
The value of the uri attribute from the taglib directive for this library.

Returns:
the value of the uri attribute

getPrefixString

public String getPrefixString()
The prefix assigned to this taglib from the taglib directive

Returns:
the prefix assigned to this taglib from the taglib directive

getShortName

public String getShortName()
The preferred short name (prefix) as indicated in the TLD. This may be used by authoring tools as the preferred prefix to use when creating an taglib directive for this library.

Returns:
the preferred short name for the library

getReliableURN

public String getReliableURN()
The "reliable" URN indicated in the TLD (the uri element). This may be used by authoring tools as a global identifier to use when creating a taglib directive for this library.

Returns:
a reliable URN to a TLD like this

getInfoString

public String getInfoString()
Information (documentation) for this TLD.

Returns:
the info string for this tag lib

getRequiredVersion

public String getRequiredVersion()
A string describing the required version of the JSP container.

Returns:
the (minimal) required version of the JSP container.
See Also:
JspEngineInfo

getTags

public TagInfo[] getTags()
An array describing the tags that are defined in this tag library.

Returns:
the TagInfo objects corresponding to the tags defined by this tag library, or a zero length array if this tag library defines no tags

getTagFiles

public TagFileInfo[] getTagFiles()
An array describing the tag files that are defined in this tag library.

Returns:
the TagFileInfo objects corresponding to the tag files defined by this tag library, or a zero length array if this tag library defines no tags files
Since:
JSP 2.0

getTag

public TagInfo getTag(String shortname)
Get the TagInfo for a given tag name, looking through all the tags in this tag library.

Parameters:
shortname - The short name (no prefix) of the tag
Returns:
the TagInfo for the tag with the specified short name, or null if no such tag is found

getTagFile

public TagFileInfo getTagFile(String shortname)
Get the TagFileInfo for a given tag name, looking through all the tag files in this tag library.

Parameters:
shortname - The short name (no prefix) of the tag
Returns:
the TagFileInfo for the specified Tag file, or null if no Tag file is found
Since:
JSP 2.0

getFunctions

public FunctionInfo[] getFunctions()
An array describing the functions that are defined in this tag library.

Returns:
the functions defined in this tag library, or a zero length array if the tag library defines no functions.
Since:
JSP 2.0

getFunction

public FunctionInfo getFunction(String name)
Get the FunctionInfo for a given function name, looking through all the functions in this tag library.

Parameters:
name - The name (no prefix) of the function
Returns:
the FunctionInfo for the function with the given name, or null if no such function exists
Since:
JSP 2.0

getTagLibraryInfos

public abstract TagLibraryInfo[] getTagLibraryInfos()
Returns an array of TagLibraryInfo objects representing the entire set of tag libraries (including this TagLibraryInfo) imported by taglib directives in the translation unit that references this TagLibraryInfo. If a tag library is imported more than once and bound to different prefices, only the TagLibraryInfo bound to the first prefix must be included in the returned array.

Returns:
Array of TagLibraryInfo objects representing the entire set of tag libraries (including this TagLibraryInfo) imported by taglib directives in the translation unit that references this TagLibraryInfo.
Since:
JSP 2.1

Java EE 5 SDK

Submit a bug or feature

Copyright 2006 Sun Microsystems, Inc. All rights reserved.