SimpleTag (EE Java 6)

Простые Обработчики Тега отличаются от Классических Обработчиков Тега в этом вместо поддержки doStartTag() и doEndTag(), SimpleTag интерфейс обеспечивает простое doTag() метод, однажды который вызывают и только однажды для любого данного вызова тега. Вся логика тега, итерация, оценки тела, и т.д. должна быть выполнена в этом единственном методе. Таким образом у простых обработчиков тега есть эквивалентное питание BodyTag, но с намного более простым жизненным циклом и интерфейсом.

Поддерживать контент тела, setJspBody() метод обеспечивается. Контейнер вызывает setJspBody() метод с a JspFragment объект, инкапсулирующий тело тега. Реализация обработчика тега может вызвать invoke() на том фрагменте, чтобы оценить тело так много раз, как это нуждается.

У обработчика SimpleTag не должно быть общественности никакой-args конструктор. Большинство обработчиков SimpleTag должно расширить SimpleTagSupport.

Жизненный цикл

Следующее является ненормативным, кратким обзором жизненного цикла SimpleTag. Обратитесь к Спецификации JSP для деталей.

Новый экземпляр обработчика тега создается каждый раз контейнером, вызывая предоставленного нулевого-args конструктора. В отличие от классических обработчиков тега, простые обработчики тега никогда не кэшируются и снова используются контейнером JSP.
setJspContext() и setParent() методы вызывает контейнер. setParent() метод только вызывают, если элемент вкладывается в пределах другого вызова тега.
Методы set для каждого атрибута, определенного для этого тега, вызывает контейнер.
Если тело существует, setJspBody() метод вызывает контейнер, чтобы установить тело этого тега, как a JspFragment. Если элемент действия пуст в странице, этот метод не вызывают вообще.
doTag() метод вызывает контейнер. Вся логика тега, итерация, оценки тела, и т.д. происходит в этом методе.
doTag() возвраты метода и все переменные синхронизируются.

С тех пор:: JSP 2.0
См. Также:: SimpleTagSupport

Сводка метода
`void`	`doTag()` Вызванный контейнером, чтобы вызвать этот тег.
`JspTag`	`getParent()` Возвращает родителя этого тега, в целях сотрудничества.
`void`	`setJspBody(JspFragment jspBody)` Обеспечивает тело этого тега, поскольку JspFragment возражает, способный быть вызванным нуль или больше раз обработчиком тега.
`void`	`setJspContext(JspContext pc)` Вызванный контейнером, чтобы предоставить этому обработчику тега `JspContext` для этого вызова.
`void`	`setParent(JspTag parent)` Устанавливает родителя этого тега, в целях сотрудничества.

Деталь метода

doTag

void doTag()
           throws JspException,
                  java.io.IOException

Вызванный контейнером, чтобы вызвать этот тег. Реализация этого метода обеспечивается разработчиком библиотеки тега, и обрабатывает всю обработку тега, итерацию тела, и т.д.

Контейнер JSP ресинхронизирует любой AT_BEGIN и переменные AT_END (определенный связанным файлом тега, TagExtraInfo, или TLD) после вызова doTag ().

Броски:: JspException - Если ошибка произошла, обрабатывая этот тег.; SkipPageException - Если страница, которая (любой прямо или косвенно) вызвала этот тег, должна прекратить оценку. Простой Обработчик Тега, сгенерированный от файла тега, должен выдать это исключение, если вызванный Классический Обработчик Тега возвращенный SKIP_PAGE или если вызванный Простой Обработчик Тега бросил SkipPageException или если вызванный Фрагмент Jsp бросил SkipPageException.; java.io.IOException - Если была ошибка, пишущий в поток вывода.