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


javax.servlet.jsp.jstl.core
Класс LoopTagSupport

java.lang.Object
  расширенный javax.servlet.jsp.tagext.TagSupport
      расширенный javax.servlet.jsp.jstl.core.LoopTagSupport
Все Реализованные Интерфейсы:
java.io. Сериализуемый, LoopTag, IterationTag, JspTag, Тег, TryCatchFinally

public abstract class LoopTagSupport
расширяет TagSupport
реализации LoopTag, IterationTag, TryCatchFinally

Основная поддержка class, чтобы облегчить реализацию итеративных тегов.

Так как большинство итеративных тегов будет вести себя тождественно относительно фактического итеративного поведения, JSTL оказывает эту основную поддержку class, чтобы облегчить реализацию. Много итеративных тегов расширят это и просто реализуют методы hasNext() И next(), чтобы обеспечить содержание для обработчика, чтобы выполнить итерации.

В частности этот основной class оказывает поддержку для:

В оказывании поддержки для этих задач LoopTagSupport содержит определенные контрольные переменные, которые действуют, чтобы изменить итерацию. Средства доступа обеспечиваются для этих контрольных переменных, когда переменные представляют информацию, необходимую или требуемую во время преобразования (например, var, varStatus). Для других переменных средства доступа не могут быть обеспечены здесь, так как подклассы могут разойтись в своих реализациях того, как те средства доступа получаются. Например, один подкласс мог бы принять String и преобразовать его в объект определенного типа при использовании средства анализа выражения; другие могли бы принять объекты непосредственно. Все еще другие не могли бы хотеть представлять такую информацию внешнему управлению.

Автор:
Шон Бейерн
См. Также:
Сериализированная Форма

Полевая Сводка
protected  int начать
          Начальное значение индекса ('начинают' атрибут),
protected  boolean beginSpecified
          Булев флаг, указывающий, начинаются ли, был определен.
protected  ValueExpression deferredExpression
          Задержанное выражение, если любой
protected  int конец
          Окончание индексирует итерации (атрибут 'конца').
protected  boolean endSpecified
          Булев флаг, указывающий, был ли 'конец' определен.
protected  java.lang.String itemId
          Представляющее атрибут управление
protected  java.lang.String statusId
          Представляющее атрибут управление
protected  int шаг
          Итеративный шаг ('ступают' атрибут),
protected  boolean stepSpecified
          Булев флаг, указывающий, был ли 'шаг' определен.
 
Поля, наследованные от class javax.servlet.jsp.tagext. TagSupport
id, pageContext
 
Поля, наследованные от интерфейса javax.servlet.jsp.tagext. IterationTag
EVAL_BODY_AGAIN
 
Поля, наследованные от интерфейса javax.servlet.jsp.tagext. Тег
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
 
Сводка конструктора
LoopTagSupport()
          Создает новый LoopTagSupport.
 
Сводка метода
 int doAfterBody()
          Продолжает итерацию, когда соответствующий - то есть, если у нас (a) есть больше элементов и (b), не работают на основе нашего 'конца' (данный наш 'шаг').
 void doCatch(java.lang.Throwable t)
          Повторно бросает данный Throwable.
 void doFinally()
          Удаляет любые атрибуты что этот набор LoopTagSupport.
 int doStartTag()
          Начинает выполнять итерации, обрабатывая первый элемент.
 java.lang.Object getCurrent()
          Получает текущий элемент в итерации.
protected  java.lang.String getDelims()
           
 LoopTagStatus getLoopStatus()
          Получает объект 'состояния' предоставить информацию о текущем раунде итерации.
protected abstract  boolean hasNext()
          Информация о возвратах относительно доступности большего количества элементов, по которым можно выполнить итерации.
protected abstract  java.lang.Object next()
          Возвращает следующий объект, по которому тег должен выполнить итерации.
protected abstract  void prepare()
          Готовится к единственному вызову тега.
 void release()
          Высвобождает любые средства, которые этот LoopTagSupport может иметь (или наследовать).
 void setVar(java.lang.String id)
          Устанавливает атрибут 'var'.
 void setVarStatus(java.lang.String statusId)
          Устанавливает атрибут 'varStatus'.
protected  void validateBegin()
          Гарантирует, что "начать" свойство разумно, выдавая исключение, которое, как ожидают, распространит, если это не
protected  void validateEnd()
          Гарантирует, что свойство "конца" разумно, выдавая исключение, которое, как ожидают, распространит, если это не
protected  void validateStep()
          Гарантирует, что свойство "шага" разумно, выдавая исключение, которое, как ожидают, распространит, если это не
 
Методы, наследованные от class javax.servlet.jsp.tagext. TagSupport
doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
 
Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Методы, наследованные от интерфейса javax.servlet.jsp.tagext. Тег
doEndTag, getParent, setPageContext, setParent
 

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

начать

protected int begin
Начальное значение индекса ('начинают' атрибут),


конец

protected int end
Окончание индексирует итерации (атрибут 'конца'). Значение-1 внутренне не указывает 'ни на какой конец, определенный', хотя средства доступа для базовых тегов JSTL не позволяют этому значению быть предоставленным непосредственно пользователем.


шаг

protected int step
Итеративный шаг ('ступают' атрибут),


beginSpecified

protected boolean beginSpecified
Булев флаг, указывающий, начинаются ли, был определен.


endSpecified

protected boolean endSpecified
Булев флаг, указывающий, был ли 'конец' определен.


stepSpecified

protected boolean stepSpecified
Булев флаг, указывающий, был ли 'шаг' определен.


itemId

protected java.lang.String itemId
Представляющее атрибут управление


statusId

protected java.lang.String statusId
Представляющее атрибут управление


deferredExpression

protected ValueExpression deferredExpression
Задержанное выражение, если любой

Деталь конструктора

LoopTagSupport

public LoopTagSupport()
Создает новый LoopTagSupport. Как с TagSupport, подклассы не должны реализовать конструкторов с параметрами, и конструкторы без параметров, реализованные подклассами, должны вызвать конструктора суперкласса.

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

затем

protected abstract java.lang.Object next()
                                  throws JspTagException

Возвращает следующий объект, по которому тег должен выполнить итерации. Этот метод должен быть обеспечен конкретными подклассами LoopTagSupport, чтобы сообщить основной логике о том, каких объектов это должно выполнить итерации.

Ожидается, что этот метод будет обычно поддержан Iterator, но это будет не всегда иметь место. В частности если получение следующего объекта повышает возможность выданного исключения, этот метод позволяет тому исключению распространять назад к контейнеру JSP как JspTagException; автономный Iterator не был бы в состоянии сделать это. (Это объясняет, почему LoopTagSupport просто не призывает Iterator от своих подтегов.)

Возвраты:
java.lang. Объект использовать в следующем раунде итерации
Броски:
java.util.NoSuchElementException - если затем () вызывается, но никакие новые элементы не доступны
JspTagException - для другого, неожиданных исключений

hasNext

protected abstract boolean hasNext()
                            throws JspTagException

Информация о возвратах относительно доступности большего количества элементов, по которым можно выполнить итерации. Этот метод должен быть обеспечен конкретными подклассами LoopTagSupport, чтобы помочь, итеративная логика, обеспеченная поддержкой, базируют class.

См. затем для получения дополнительной информации о цели и ожиданиях позади этого тега.

Возвраты:
true, если есть, по крайней мере, еще один элемент, чтобы выполнить итерации, false иначе
Броски:
JspTagException
См. Также:
next()

подготовиться

protected abstract void prepare()
                         throws JspTagException

Готовится к единственному вызову тега. Определенно, позволяет подклассам готовиться к звонкам hasNext () и затем (). Подклассы могут предположить, что готовятся (), однажды вызовут для каждого вызова doStartTag () в суперклассе.

Броски:
JspTagException

выпуск

public void release()
Высвобождает любые средства, которые этот LoopTagSupport может иметь (или наследовать).

Определенный:
release в интерфейсе Tag
Переопределения:
release в class TagSupport
См. Также:
Tag#release()

doStartTag

public int doStartTag()
               throws JspException
Начинает выполнять итерации, обрабатывая первый элемент.

Определенный:
doStartTag в интерфейсе Tag
Переопределения:
doStartTag в class TagSupport
Возвраты:
SKIP_BODY
Броски:
JspException - если ошибка происходит, обрабатывая этот тег
См. Также:
Tag#doStartTag()

doAfterBody

public int doAfterBody()
                throws JspException
Продолжает итерацию, когда соответствующий - то есть, если у нас (a) есть больше элементов и (b), не работают на основе нашего 'конца' (данный наш 'шаг').

Определенный:
doAfterBody в интерфейсе IterationTag
Переопределения:
doAfterBody в class TagSupport
Возвраты:
SKIP_BODY
Броски:
JspException - если ошибка происходит, обрабатывая этот тег
См. Также:
IterationTag#doAfterBody()

doFinally

public void doFinally()
Удаляет любые атрибуты что этот набор LoopTagSupport.

Эти атрибуты предназначаются, чтобы поддерживать переменные сценариев с ВЛОЖЕННЫМ контекстом, таким образом, мы не хотим загрязнять пространство атрибута, оставляя их лежащий вокруг.

Определенный:
doFinally в интерфейсе TryCatchFinally

doCatch

public void doCatch(java.lang.Throwable t)
             throws java.lang.Throwable
Повторно бросает данный Throwable.

Определенный:
doCatch в интерфейсе TryCatchFinally
Параметры:
t - throwable навигация исключения через этот тег.
Броски:
java.lang.Throwable - если исключение должно быть повторно брошено далее цепочка вложенного множества.

getCurrent

public java.lang.Object getCurrent()
Описание скопировало с интерфейса: LoopTag
Получает текущий элемент в итерации. Ведет себя идемпотентным образом; вызов getCurrent () неоднократно должен возвращать тот же самый Объект, пока итерация не совершенствуется. (Определенно, вызывая getCurrent () не совершенствует итерацию.)

Определенный:
getCurrent в интерфейсе LoopTag
Возвраты:
текущий элемент как объект

getLoopStatus

public LoopTagStatus getLoopStatus()
Описание скопировало с интерфейса: LoopTag
Получает объект 'состояния' предоставить информацию о текущем раунде итерации.

Определенный:
getLoopStatus в интерфейсе LoopTag
Возвраты:
LoopTagStatus для текущего LoopTag.

getDelims

protected java.lang.String getDelims()

setVar

public void setVar(java.lang.String id)
Устанавливает атрибут 'var'.

Параметры:
id - Имя экспортируемой определяющей контекст переменной, хранящей текущий элемент итерации.

setVarStatus

public void setVarStatus(java.lang.String statusId)
Устанавливает атрибут 'varStatus'.

Параметры:
statusId - Имя экспортируемой определяющей контекст переменной, хранящей состояние итерации.

validateBegin

protected void validateBegin()
                      throws JspTagException
Гарантирует, что "начать" свойство разумно, выдавая исключение, которое, как ожидают, распространит, если это не

Броски:
JspTagException

validateEnd

protected void validateEnd()
                    throws JspTagException
Гарантирует, что свойство "конца" разумно, выдавая исключение, которое, как ожидают, распространит, если это не

Броски:
JspTagException

validateStep

protected void validateStep()
                     throws JspTagException
Гарантирует, что свойство "шага" разумно, выдавая исключение, которое, как ожидают, распространит, если это не

Броски:
JspTagException


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

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

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

free hit counter