JSP.10.5.2 TagInfo
Синтаксис
public class TagInfo
Описание
Информация Tag для тэга в Библиотеке Тэгов; этот класс инстанциируется из файла TLD/Дескриптора Библиотеки Тэгов и доступна только во время трансляции.
JSP.10.5.2.19 Поля
public static final java.lang.String BODY_CONTENT_EMPTY
static-константа для getBodyContent(), если он пустой.
public static final java.lang.String BODY_CONTENT_JSP
static-константа для getBodyContent(), если это JSP.
public static final java.lang.String BODY_CONTENT_TAG_DEPENDENT
static-константа для getBodyContent(), если это зависит от Tag.
JSP.10.5.2.20 Конструкторы
public TagInfo(java.lang.String tagName, java.lang.String tagClassName, java.lang.String bodycontent, java.lang.String infoString, TagLibraryInfo taglib, TagExtraInfo tagExtraInfo, TagAttributeInfo[] attributeInfo)
Конструктор для TagInfo из данных в формате JSP 1.1 для TLD. Этот класс инстанциируется только из кода TagLibrary по запросу из некоторого кода JSP, разбирающего TLD (Tag Library Descriptor). Заметьте, что, поскольку TagLibibraryInfo отражает информацию TLD и директивы taglib, экземпляр TagInfo зависит от директивы taglib. Возможно это ошибка дизайна, которая может быть зафиксирована в будущем.
Параметры:
tagName - имя того тэга.
tagClassName - имя класса обработчика тэга.
bodycontent - информация о теле содержимого этих тэгов.
infoString - строковая информация (optional) для данного тэга.
taglib - экземпляр библиотеки тэгов, содержащей их.
tagExtraInfo - экземпляр, предоставляющий дополнительную информацию о тэге. Может быть null.
attributeInfo - массив данных AttributeInfo из дескриптора. Может быть null.
public TagInfo(java.lang.String tagName, java.lang.String tagClassName, java.lang.String bodycontent, java.lang.String infoString, TagLibraryInfo taglib, TagExtraInfo tagExtraInfo, TagAttributeInfo[] attributeInfo, java.lang.String displayName, java.lang.String smallIcon, java.lang.String largeIcon, TagVariableInfo[] tvi)
Конструктор для TagInfo из данных в формате JSP 1.2 для TLD. Этот класс инстанциируется только из кода TagLibrary по запросу из некоторого кода JSP, разбирающего TLD. Заметьте, что, поскольку TagLibibraryInfo отражает информацию TLD и директивы taglib, экземпляр TagInfo зависит от директивы taglib. Возможно это ошибка дизайна, которая может быть зафиксирована в будущем.
Параметры:
tagName - имя того тэга.
tagClassName - имя класса обработчика тэга.
bodycontent - информация о теле содержимого этих тэгов.
infoString - строковая информация (optional) для данного тэга.
taglib - экземпляр библиотеки тэгов, содержащей их.
tagExtraInfo - экземпляр, предоставляющий дополнительную информацию о тэге. Может быть null.
attributeInfo - массив данных AttributeInfo из дескриптора. Может быть null.
displayName - краткое имя для отображения утилитами.
smallIcon - путь к маленькой иконке, отображаемой утилитами.
largeIcon - путь к большой иконке, отображаемой утилитами.
tagVariableInfo - массив TagVariableInfo (или null).
JSP.10.5.2.21 Методы
public TagAttributeInfo[] getAttributes()
Информация атрибута (в TLD) в этом тэге. Возвращается массив, описывающий атрибуты данного тэга, как указано в TLD. Возврат null означает отсутствие атрибутов.
Возвращает: массив TagAttributeInfo для данного тэга.
public java.lang.String getBodyContent()
Информация bodycontent для данного тэга.
Возвращает: строку содержимого тела.
public java.lang.String getDisplayName()
Получает displayName.
Возвращает: Краткое имя для вывода утилитами.
public java.lang.String getInfoString()
Информационная строка для тэга.
Возвращает: информационную строку.
public java.lang.String getLargeIcon()
Получает путь к большой иконке.
Возвращает: путь к большой иконке, отображаемой утилитами.
public java.lang.String getSmallIcon()
Получает путь к маленькой иконке.
Возвращает: путь к маленькой иконке, отображаемой утилитами.
public java.lang.String getTagClassName()
Имя класса, предоставляющего обработчик для данного тэга.
Возвращает: имя класса обработчика тэга.
public TagExtraInfo getTagExtraInfo()
Экземпляр (если имеется) для дополнительной информации тэга.
Возвращает: экземпляр TagExtraInfo, если имеется.
public TagLibraryInfo getTagLibrary()
Экземпляр TagLibraryInfo, к которому мы принадлежим.
Возвращает: экземпляр библиотеки тэгов, к которому мы принадлежим.
public java.lang.String getTagName()
Имя тэга.
Возвращает: (краткое) имя тэга.
public TagVariableInfo[] getTagVariableInfos()
Получает объекты TagVariableInfo, ассоциированные с этим TagInfo.
Возвращает: объект TagVariableInfo, ассоциированный с этим объектом.
public VariableInfo[] getVariableInfo(TagData data)
Информация об объектах скриптинга, созданных этим тэгом на этапе прогона/runtime. Это удобный метод в ассоциированном классе TagExtraInfo. По умолчанию null, если тэг не имеет атрибута “id”, иначе - {“id”, Object}
Параметры:
data - TagData, описывающие данную акцию.
Возвращает: массив элементов VariableInfo.
public booleanisValid(TagData data)
Проверка атрибутов на этапе трансляции. Это удобный метод в ассоциированном классе TagExtraInfo.
Параметры:
data - экземпляр TagData времени трансляции.
Возвращает: верны ли данные.
public void setTagExtraInfo(TagExtraInfo tei)
Набор экземпляров для дополнительной информации тэга.
Параметры:
tei - экземпляр TagExtraInfo.
public void setTagLibrary(TagLibraryInfo tl)
Устанавливает свойство TagLibraryInfo. Заметьте, что элемент TagLibraryInfo зависит не просто от информации TLD, но также и от специфики используемого экземпляра taglib. Это означает, что некоторая работа должна быть проделана для конструирования и инициализации объектов TagLib. Если использовать аккуратно, этот setter поможет исключить необходимость создания новых элементов TagInfo для каждой директивы taglib.
Параметры:
tl - назначаемый TagLibraryInfo.
public java.lang.String toString()
Строго для целей отладки ...
Переопределяет: java.lang.Object.toString() в классе java.lang.Object
