javax.servlet.jsp.tagext
Класс TagSupport

java.lang.Object
  |
  +--javax.servlet.jsp.tagext.TagSupport
Прямые Известные Подклассы:
BodyTagSupport
public class TagSupport
extends java.lang.Object
implements IterationTag, java.io.Serializable

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

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

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

См. также:
Сериализованная Форма

Поле. Резюме.
protected  java.lang.String id
           
protected  PageContext pageContext
           
 
Конструктор. Резюме.
TagSupport()
          Конструктор по умолчанию, все подклассы должны лишь определить public-конструктор с той же подписью м вызывать конструктор суперкласса.
 
Метод. Резюме.
 int doAfterBody()
          Обработка по умолчанию тела.
 int doEndTag()
          Обработка по умолчанию конечного тэга, возвращающего EVAL_PAGE.
 int doStartTag()
          Обработка по умолчанию начального тэга, возвращающего SKIP_BODY.
static Tag findAncestorWithClass(Tag from, java.lang.Class klass)
          Находит экземпляр данного типа класса - ближайший к данному экземпляру.
 java.lang.String getId()
          Значение атрибута id данного тэга; или null.
 Tag getParent()
          Экземпляр Tag'а, ближайший содержащий данный экземпляр тэга.
 java.lang.Object getValue(java.lang.String k)
          Получает значение, ассоциированное с ключом.
 java.util.Enumeration getValues()
          Перечисляет значения, хранимые данным обработчиком тэга.
 void release()
          Освободить статус.
 void removeValue(java.lang.String k)
          Удалить значение, ассоциированное с ключом.
 void setId(java.lang.String id)
          Устанавливает атрибут id данного тэга.
 void setPageContext(PageContext pageContext)
          Устанавливает контекст страницы.
 void setParent(Tag t)
          Устанавливает содержащий/nesting тэг данного тэга.
 void setValue(java.lang.String k, java.lang.Object o)
          Ассоциирует значение со String-ключом.
 
Методы, унаследованные из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Поле. Детали.

id

protected java.lang.String id

pageContext

protected PageContext pageContext
Конструктор. Детали.

TagSupport

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

findAncestorWithClass

public static final Tag findAncestorWithClass(Tag from,
                                              java.lang.Class klass)
Находит экземпляр данного типа класса - ближайший к данному экземпляру. Этот метод использует метод getParent из интерфейса Tag.
Этот метод используется для координации кооперирующихся тэгов.

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

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

Параметры:
from - экземпляр, с которого начинать просмотр.
klass - подкласс Tag'а или др. соответствующего интерфейса.

doStartTag

public int doStartTag()
               throws JspException
Обработка по умолчанию начального тэга, возвращающего SKIP_BODY.
См. также:
Tag.doStartTag()

doEndTag

public int doEndTag()
             throws JspException
Обработка по умолчанию конечного тэга, возвращающего EVAL_PAGE.
См. также:
Tag.doEndTag()

doAfterBody

public int doAfterBody()
                throws JspException
Процессинг по умолчанию тела.
Кем специфицирован:
doAfterBody в интерфейсе IterationTag.
Возвращает:
SKIP_BODY
См. также:
IterationTag.doAfterBody()

release

public void release()
Освобождает статус.
См. также:
Tag.release()

setParent

public void setParent(Tag t)
Устанавливает содержащий тэг данного тэга.
Параметры:
t - родительский Tag.
См. также:
Tag.setParent(Tag)

getParent

public Tag getParent()
Экземпляр Tag'а, ближайший содержащий данный экземпляр тэга.
См. также:
Tag.getParent()

setId

public void setId(java.lang.String id)
Устанавливает атрибут id для данного тэга.
Параметры:
id - String для id.

getId

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

setPageContext

public void setPageContext(PageContext pageContext)
Устанавливает контекст страницы.
Параметры:
pageContenxt - PageContext.
См. также:
Tag.setPageContext(javax.servlet.jsp.PageContext)

setValue

public void setValue(java.lang.String k,
                     java.lang.Object o)
Ассоциирует значение со String-ключом.
Параметры:
k - String-ключ.
o - ассоциируемое значение.

getValue

public java.lang.Object getValue(java.lang.String k)
Получает значение, ассоциированное с ключом.
Параметры:
k - строка-ключ.

removeValue

public void removeValue(java.lang.String k)
Удаляет значение, ассоциированное с ключом.
Параметры:
k - строка-ключ.

getValues

public java.util.Enumeration getValues()
Перечисляет значения, хранимые данным обработчиком тэга.