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. Каждый такой объект описывает переменную сценариев, обеспечивая ее имя, ее тип, нова ли переменная или нет, и каков ее контекст. Контекст лучше всего описывается через изображение:

ВЛОЖЕННЫЙ, AT_BEGIN и Переменные Контексты AT_END

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

Значение контекста для переменной подразумевает, какие методы могут влиять на ее значение и таким образом где синхронизация необходима как иллюстрировано таблицей ниже. Отметьте: синхронизация переменной (ых) произойдет после того, как соответствующий метод вызвали.
Переменные Точки синхронизации
  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
1 Вызванный после 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


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

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

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


Spec-Zone.ru - all specs in one place



free hit counter