TagLibraryInfo (JSP 4.0 API Documentation - Apache Tomcat 11.0.22)
Description: declaration: package: jakarta.servlet.jsp.tagext, class: TagLibraryInfo

# Class TagLibraryInfo

java.lang.Object
jakarta.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

  Fields
  Modifier and Type
  Field
  Description
  `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

  Constructors
  Modifier
  Constructor
  Description
  `protected`
  `TagLibraryInfo(String prefix, String uri)`
  Constructor.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `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 Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Field Details

  - ### 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 Details

  - ### TagLibraryInfo

    protected TagLibraryInfo(String prefix, String uri)
    Constructor. This will invoke the constructors for TagInfo, and TagAttributeInfo after parsing the TLD file.
    Parameters:
      `prefix` - the prefix actually used by the taglib directive
      `uri` - the URI actually used by the taglib directive

- ## Method Details

  - ### 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 prefixes, 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