Spec-Zone .ru
спецификации, руководства, описания, API


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

Все Суперинтерфейсы:
JspTag, Тег
Все Известные Подынтерфейсы:
BodyTag
Все Известные Классы с реализацией:
AttributeTag, BodyTagSupport, ConditionalTagSupport, ConverterELTag, ConverterTag, FacetTag, LoopTagSupport, TagSupport, UIComponentBodyTag, UIComponentClassicTagBase, UIComponentELTag, UIComponentTag, ValidatorELTag, ValidatorTag

public interface IterationTag
расширяет Тег

Интерфейс IterationTag расширяет Тег, определяя один дополнительный метод, который управляет переоценкой его тела.

Обработчик тега, который реализует IterationTag, обрабатывается как тот, который реализует Тег относительно doStartTag () и doEndTag () методы. IterationTag обеспечивает новый метод: doAfterBody().

doAfterBody () метод вызывается после каждой оценки тела, чтобы управлять, будет ли тело переоценено или нет. Если doAfterBody () возвращает IterationTag. EVAL_BODY_AGAIN, тогда тело будет переоценено. Если doAfterBody () возвращает Тег. SKIP_BODY, тогда тело будет пропущено, и doEndTag () будет оценен вместо этого.

Свойства Там не являются никакими новыми свойствами в дополнение к тем в Теге.

Методы Там являются новыми методами: doAfterBody ().

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

Детали жизненного цикла описываются схемой перехода ниже. Исключения, которые выдаются во время вычисления doStartTag (), ТЕЛО и doAfterBody () прерывают последовательность выполнения и распространяются стек, если обработчик тега не реализует интерфейс TryCatchFinally; см. тот интерфейс для деталей.

Жизненный цикл Детализирует Схему Перехода для IterationTag

Пустое и Непустое Действие

Если файл TagLibraryDescriptor указывает, что у действия должно всегда быть пустое тело элемента, <контент тела> запись "пустых", то doStartTag () метод должен возвратить SKIP_BODY.

Отметьте, что, какие методы вызываются после того, как doStartTag () зависит и от возвращаемого значения и от того, если элемент пользовательского действия пуст или не в странице JSP, не на том, как это объявляется в TLD.

Если SKIP_BODY возвращается, тело не оценивается, и затем doEndTag () вызывается.

Если EVAL_BODY_INCLUDE возвращается, и элемент пользовательского действия не пуст, тело оценивается и "проходится" к току, то doAfterBody () вызывается и, после того, как нуль или больше итераций, doEndTag () вызываются.


Полевая Сводка
static int EVAL_BODY_AGAIN
          Запросите переоценку некоторого тела.
 
Поля, наследованные от интерфейса javax.servlet.jsp.tagext. Тег
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
 
Сводка метода
 int doAfterBody()
          Тело процесса (ре) оценка.
 
Методы, наследованные от интерфейса javax.servlet.jsp.tagext. Тег
doEndTag, doStartTag, getParent, release, setPageContext, setParent
 

Полевая Деталь

EVAL_BODY_AGAIN

static final int EVAL_BODY_AGAIN
Запросите переоценку некоторого тела. Возвращенный из doAfterBody. Для совместимости с JSP 1.1, значение тщательно выбирается, чтобы быть тем же самым как, теперь осуждается, BodyTag. EVAL_BODY_TAG,

См. Также:
Постоянные Значения полей
Деталь метода

doAfterBody

int doAfterBody()
                throws JspException
Тело процесса (ре) оценка. Этот метод вызывается объектом реализации Страницы JSP после каждой оценки тела в объект BodyEvaluation. Метод не вызывается, если нет никакой оценки тела.

Если doAfterBody возвратит EVAL_BODY_AGAIN, то новая оценка тела произойдет (сопровождаемый другим вызовом doAfterBody). Если doAfterBody возвратит SKIP_BODY, то больше оценок тела не произойдет, и doEndTag метод будет вызван.

Если этот обработчик тега реализует BodyTag, и doAfterBody возвращает SKIP_BODY, то значение будет восстановлено, используя popBody метод в pageContext до вызова doEndTag.

Перевызовы метода могут быть, приводят к различным действиям, потому что, возможно, были некоторые изменения к общему состоянию, или из-за внешнего вычисления.

Контейнер JSP ресинхронизирует значения любого AT_BEGIN и ВЛОЖЕННЫХ переменных (определенный связанным TagExtraInfo или TLD) после вызова doAfterBody ().

Возвраты:
требуются ли дополнительные оценки тела
Броски:
JspException - если ошибка произошла, обрабатывая этот тег


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

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

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

free hit counter