Спецификация Java Server Pages 1.2

       

JSP.10.1.4 TagSupport



Синтаксис

public class TagSupport implements IterationTag, java.io.Serializable

Прямые Известные Подклассы: BodyTagSupport


Все Реализованные Интерфейсы: IterationTag, java.io.Serializable, Tag


Описание

Базовый класс для определения новых обработчиков тэгов, реализующих Tag.

Класс TagSupport является служебным классом, предназначенным для использования в качестве базового класса для новых обработчиков тэгов. Класс TagSupport реализует интерфейсы Tag и IterationTag и добавляет дополнительные удобные методы, включая getter-методы для свойств в Tag. TagSupport имеет один static-метод, который включён для облегчения координации между кооперирующимися тэгами.


Многие обработчики тэгов будут расширять TagSupport и переопределять только некоторые методы.

JSP.10.1.4.6 Поля
 

protected java.lang.String id

protected PageContext pageContext

JSP.10.1.4.7 Конструкторы

public TagSupport()

Конструктор по умолчанию, все классы должны определять только public-конструктор с той же подписью и вызывать конструктор суперкласса. Этот конструктор вызывается кодом, генерируемым JSP-транслятором.

JSP.10.1.4.8 Методы
 

public int doAfterBody()



Процессинг по умолчанию для тела/body.


Возвращает: SKIP_BODY


Вызывает: JspException


См. также: public int doAfterBody()

public int doEndTag()


Процессинг по умолчанию конечного тэга, возвращающий EVAL_PAGE.

Вызывает: JspException


См. также: public int doEndTag()

public int doStartTag()

Процессинг по умолчанию начального тэга, возвращающий SKIP_BODY.

Вызывает:JspException


См. также: public int doStartTag()

public static final Tag findAncestorWithClass(Tag from, java.lang.Class klass)


Находит экземпляр типа данного класса, который ближе всего к данному экземпляру. Этот метод использует метод getParent из интерфейса Tag. Этот метод используется для координации между кооперирующимися тэгами.

Текущая версия спецификации предоставляет только один формальный способ указания на рассматриваемый тип обработчика тэга: его класс реализации обработчика тэга, описанный в субэлементе tag-class элемента tag. Здесь выполняется неформальное расширение, позволяющее автору библиотеки тэгов указывать в субэлементе description рассматриваемый тип. Тип должен быть подтипом класса реализации обработчика тэга или void. Это дополнительное ограничение может быть выполнено специализированным контейнером, который знает об этой специфической библиотеке тэгов, как в случае со стандартной библиотекой тэгов JSP.


Если автор библиотеки тэгов предоставляет информацию о рассматриваемом типе обработчика тэга, клиентский программный код должен быть приспособлен к этому ограничению. Точнее, Class, переданный в findAncestorWithClass, должен иметь подтип рассматриваемого типа.

Параметры:

from - Экземпляр, с которого начинать просмотр.

klass - Совпадающий подкласс Tag'а или интерфейс.

public java.lang.String getId() - Значение атрибута id этого тэга; или null.

public Tag getParent() - Ближайший экземпляр Tag'а, заключающий в себе данный экземпляр тэга.

См. также: public Tag getParent()

public java.lang.Object getValue(java.lang.String k)

Получает значение, ассоциированное с ключом/key.

Параметры:

k - Строка-ключ.

public java.util.Enumeration getValues()

Перечисляет значения, хранимые в этом обработчике тэга.

public void release()

Освобождает статус.

См. также: public void release()

public void removeValue(java.lang.String k)

Удаляет значение, ассоциированное с ключом.

Параметры:

k - строка-ключ.

public void setId(java.lang.String id)

Устанавливает атрибут id для данного тэга.

Параметры:

id - String для id.

public void setPageContext(PageContext pageContext)

Устанавливает контекст страницы.

Параметры:

pageContenxt- PageContext.

См. также: public void setPageContext(PageContext pc)

public void setParent(Tag t)

Устанавливает вкладывающий тэг для данного тэга.

Параметры:

t - родительский Tag.

См. также: public void setParent(Tag t)

public void setValue(java.lang.String k, java.lang.Object o)

Ассоциирует значение со String-ключом.

Параметры:

k - String-ключ.

o - Ассоциируемое значение.


Содержание раздела