javax.servlet.jsp.tagext
Интерфейс SimpleTag

Все Суперинтерфейсы:
JspTag
Все Известные Классы с реализацией:
SimpleTagSupport

public interface SimpleTag
расширяет JspTag

Интерфейс для того, чтобы определить Простые Обработчики Тега.

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

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

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

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

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

  1. Новый экземпляр обработчика тега создается каждый раз контейнером, вызывая предоставленного нулевого-args конструктора. В отличие от классических обработчиков тега, простые обработчики тега никогда не кэшируются и снова используются контейнером JSP.
  2. setJspContext() и setParent() методы вызывает контейнер. setParent() метод только вызывают, если элемент вкладывается в пределах другого вызова тега.
  3. Методы set для каждого атрибута, определенного для этого тега, вызывает контейнер.
  4. Если тело существует, setJspBody() метод вызывает контейнер, чтобы установить тело этого тега, как a JspFragment. Если элемент действия пуст в странице, этот метод не вызывают вообще.
  5. doTag() метод вызывает контейнер. Вся логика тега, итерация, оценки тела, и т.д. происходит в этом методе.
  6. 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 - Если была ошибка, пишущий в поток вывода.

setParent

void setParent(JspTag parent)
Устанавливает родителя этого тега, в целях сотрудничества.

Контейнер вызывает этот метод, только если этот вызов тега вкладывается в пределах другого вызова тега.

Параметры:
parent - тег, который включает этот тег

getParent

JspTag getParent()
Возвращает родителя этого тега, в целях сотрудничества.

Возвраты:
родитель этого тега

setJspContext

void setJspContext(JspContext pc)
Вызванный контейнером, чтобы предоставить этому обработчику тега JspContext для этого вызова. Реализация должна сохранить это значение.

Параметры:
pc - контекст страницы для этого вызова
См. Также:
Tag#setPageContext

setJspBody

void setJspBody(JspFragment jspBody)
Обеспечивает тело этого тега, поскольку JspFragment возражает, способный быть вызванным нуль или больше раз обработчиком тега.

Этот метод вызывается объектом реализации страницы JSP до doTag(). Если элемент действия пуст в странице, этот метод не вызывают вообще.

Параметры:
jspBody - Фрагмент, инкапсулирующий тело этого тега.


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter