Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
public interface SimpleTag
Интерфейс для того, чтобы определить Простые Обработчики Тега.
Простые Обработчики Тега отличаются от Классических Обработчиков Тега в этом вместо поддержки doStartTag()
и doEndTag()
, SimpleTag
интерфейс обеспечивает простое doTag()
метод, однажды который вызывают и только однажды для любого данного вызова тега. Вся логика тега, итерация, оценки тела, и т.д. должна быть выполнена в этом единственном методе. Таким образом у простых обработчиков тега есть эквивалентное питание BodyTag
, но с намного более простым жизненным циклом и интерфейсом.
Поддерживать контент тела, setJspBody()
метод обеспечивается. Контейнер вызывает setJspBody()
метод с a JspFragment
объект, инкапсулирующий тело тега. Реализация обработчика тега может вызвать invoke()
на том фрагменте, чтобы оценить тело так много раз, как это нуждается.
У обработчика SimpleTag не должно быть общественности никакой-args конструктор. Большинство обработчиков SimpleTag должно расширить SimpleTagSupport.
Жизненный цикл
Следующее является ненормативным, кратким обзором жизненного цикла SimpleTag. Обратитесь к Спецификации JSP для деталей.
setJspContext()
и setParent()
методы вызывает контейнер. setParent()
метод только вызывают, если элемент вкладывается в пределах другого вызова тега.setJspBody()
метод вызывает контейнер, чтобы установить тело этого тега, как a JspFragment
. Если элемент действия пуст в странице, этот метод не вызывают вообще.doTag()
метод вызывает контейнер. Вся логика тега, итерация, оценки тела, и т.д. происходит в этом методе.doTag()
возвраты метода и все переменные синхронизируются.
SimpleTagSupport
Сводка метода | |
---|---|
void |
doTag()
Вызванный контейнером, чтобы вызвать этот тег. |
JspTag |
getParent()
Возвращает родителя этого тега, в целях сотрудничества. |
void |
setJspBody(JspFragment jspBody)
Обеспечивает тело этого тега, поскольку JspFragment возражает, способный быть вызванным нуль или больше раз обработчиком тега. |
void |
setJspContext(JspContext pc)
Вызванный контейнером, чтобы предоставить этому обработчику тега JspContext для этого вызова. |
void |
setParent(JspTag parent)
Устанавливает родителя этого тега, в целях сотрудничества. |
Деталь метода |
---|
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
- Если была ошибка, пишущий в поток вывода.void setParent(JspTag parent)
Контейнер вызывает этот метод, только если этот вызов тега вкладывается в пределах другого вызова тега.
parent
- тег, который включает этот тегJspTag getParent()
void setJspContext(JspContext pc)
JspContext
для этого вызова. Реализация должна сохранить это значение.
pc
- контекст страницы для этого вызоваTag#setPageContext
void setJspBody(JspFragment jspBody)
Этот метод вызывается объектом реализации страницы JSP до doTag()
. Если элемент действия пуст в странице, этот метод не вызывают вообще.
jspBody
- Фрагмент, инкапсулирующий тело этого тега.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41