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

javax.servlet.jsp.tagext
Класс VariableInfo

java.lang.Object
  javax.servlet.jsp.tagext.VariableInfo

public class VariableInfo
расширяет java.lang. Объект

Информация о переменных сценариев, которые создаются/изменяются тегом (во времени выполнения). Эта информация предоставляется классами TagExtraInfo, и она используется фазой преобразования JSP.

У сценариев переменных, сгенерированных пользовательским действием, есть связанный контекст или AT_BEGIN, ВЛОЖЕННОГО, или AT_END.

Имя class (VariableInfo.getClassName) в возвращенных объектах используется, чтобы определить типы переменных сценариев. Отметьте что, потому что пишущие сценарий переменные присваиваются их значения от определяющих контекст атрибутов, которые не могут иметь типов примитивов, "упакованные" типы такой как java.lang.Integer должен использоваться вместо примитивов.

Имя class может быть Полностью определенным Именем класса, или коротким именем class.

Если Полностью определенное Имя класса обеспечивается, оно должно обратиться к class, который должен быть в ПУТИ К КЛАССУ для Веб-приложения (см. Сервлет 2.4 спецификации - по существу это - WEB-INF/lib и WEB-INF/classes). Отказ быть так приведет к разовой преобразованием ошибке.

Если короткое имя class дается в объектах VariableInfo, то имя class должно быть именем общедоступного class в контексте директив импорта страницы, где пользовательское действие появляется. class должен также быть в ПУТИ К КЛАССУ для Веб-приложения (см. Сервлет 2.4 спецификации - по существу это - WEB-INF/lib и WEB-INF/classes). Отказ быть так приведет к разовой преобразованием ошибке.

Комментарии использования

Часто полностью определенное имя class обратится к class, который известен библиотеке тега и таким образом, поставляется в том же самом файле JAR как обработчики тега. В большинстве других остающихся случаев это обратится к class, который находится в платформе, на которой процессор JSP создается (как EE Java). Используя полностью определенные имена class этим способом делает использование относительно стойким к ошибкам конфигурации.

Краткое название обычно сгенерировано библиотекой тега, основанной на некоторых атрибутах, через которые проходят от пользователя пользовательского действия (автор), и это таким образом менее устойчиво: например недостающий импорт, направляющий в обращении страница JSP, приведет к недопустимому краткому названию class и ошибка преобразования.

Протокол синхронизации

Результатом вызова на getVariableInfo является массив объектов VariableInfo. Каждый такой объект описывает переменную сценариев, обеспечивая ее имя, ее тип, нова ли переменная или нет, и каков ее контекст. Контекст лучше всего описывается через изображение:

JSP 2.0 спецификации определяет интерпретацию 3 значений:

• ВЛОЖЕННЫЙ, если переменная сценариев доступна между тегом запуска и конечным тэгом действия, которое определяет это.
• AT_BEGIN, если переменная сценариев доступна от тега запуска действия, которое определяет это до конца контекста.
• AT_END, если переменная сценариев доступна после конечного тэга действия, которое определяет это до конца контекста.

Значение контекста для переменной подразумевает, какие методы могут влиять на ее значение и таким образом где синхронизация необходима как иллюстрировано таблицей ниже. Отметьте: синхронизация переменной (ых) произойдет после того, как соответствующий метод вызвали.

Переменные Точки синхронизации
	doStartTag ()	doInitBody ()	doAfterBody ()	doEndTag ()	doTag ()
Тег	AT_BEGIN, ВЛОЖЕННЫЙ			AT_BEGIN, AT_END
IterationTag	AT_BEGIN, ВЛОЖЕННЫЙ		AT_BEGIN, ВЛОЖЕННЫЙ	AT_BEGIN, AT_END
BodyTag	AT_BEGIN, NESTED1	AT_BEGIN, NESTED1	AT_BEGIN, ВЛОЖЕННЫЙ	AT_BEGIN, AT_END
SimpleTag					AT_BEGIN, AT_END

¹ Вызванный после doStartTag() если EVAL_BODY_INCLUDE возвращается, или после doInitBody() иначе.

Переменная информация в TLD

Сценарии переменной информации могут также быть закодированы непосредственно для большинства случаев в Дескриптор Библиотеки Тега, используя <переменный> подэлемент <тег> элемент. См. спецификацию JSP.

Полевая Сводка

static int	AT_BEGIN Информация о контексте, что сценарии переменной видимы после, запускает тег.
static int	AT_END Информация о контексте, что сценарии переменной видимы после конечного тэга.
static int	ВЛОЖЕННЫЙ Информация о контексте, что сценарии переменной видимы только в пределах запуска/конечных тэгов.

Сводка конструктора

VariableInfo(java.lang.String varName, java.lang.String className, boolean declare, int scope)
Конструктор Эти объекты может быть создан (во время преобразования) экземплярами TagExtraInfo.

Сводка метода

java.lang.String	getClassName() Возвращает тип этой переменной.
boolean	getDeclare() Возвраты, является ли это новой переменной.
int	getScope() Возвращает лексический контекст переменной.
java.lang.String	getVarName() Возвращает имя переменной сценариев.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

ВЛОЖЕННЫЙ

public static final int NESTED

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

См. Также:

Постоянные Значения полей

AT_BEGIN

public static final int AT_BEGIN

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

См. Также:

Постоянные Значения полей

AT_END

public static final int AT_END

Информация о контексте, что сценарии переменной видимы после конечного тэга.

См. Также:

Постоянные Значения полей

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

VariableInfo

public VariableInfo(java.lang.String varName,
                    java.lang.String className,
                    boolean declare,
                    int scope)

Конструктор Эти объекты может быть создан (во время преобразования) экземплярами TagExtraInfo.

Параметры:

varName - Имя переменной сценариев

className - Тип этой переменной

declare - Если это правда, это - новая переменная (на некоторых языках, это потребует объявления),

scope - Индикация относительно лексического контекста переменной

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

getVarName

public java.lang.String getVarName()

Возвращает имя переменной сценариев.

Возвраты:

имя переменной сценариев

getClassName

public java.lang.String getClassName()

Возвращает тип этой переменной.

Возвраты:

тип этой переменной

getDeclare

public boolean getDeclare()

Возвраты, является ли это новой переменной. Если так, на некоторых языках это потребует объявления.

Возвраты:

является ли это новой переменной.

getScope

public int getScope()

Возвращает лексический контекст переменной.

Возвраты:

лексический контекст переменной, или AT_BEGIN, AT_END, или ВЛОЖЕННЫЙ.

См. Также:

AT_BEGIN, AT_END, NESTED