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

javax.servlet.jsp
Класс JspContext

java.lang.Object
  javax.servlet.jsp.JspContext

Прямые Известные Подклассы:

PageContext

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

JspContext служит основным class для PageContext class и краткие обзоры вся информация, которая не является определенной для сервлетов. Это учитывает Простые Расширения Тега, которые будут использоваться за пределами контекста Сервлета запроса/ответа.

JspContext предоставляет много услуг автору страницы/компонента и конструктору страницы, включая:

• единственный API, чтобы управлять различными определяющими контекст пространствами имен
• механизм, чтобы получить JspWriter для вывода
• механизм, чтобы представить страницу направляющие атрибуты среде сценариев

Методы, Предназначенные для Контейнерного Сгенерированного Кода

Следующие методы позволяют управлению вложенными потоками JspWriter реализовать Расширения Тега: pushBody() и popBody()

Методы, Предназначенные для авторов JSP

Некоторые методы обеспечивают универсальный доступ к разнообразным объектам, представляющим контексты. Реализация должна использовать базовую машину, соответствующую тому контексту, таким образом, информацию можно передать назад и вперед между базовой средой (например, Сервлеты) и страницами JSP. Методы: setAttribute(), getAttribute(), findAttribute(), removeAttribute(), getAttributesScope() и getAttributeNamesInScope().

Следующие методы обеспечивают удобный доступ к неявным объектам: getOut()

Следующие методы обеспечивают программируемый доступ к средству анализа Языка Выражения: getExpressionEvaluator(), getVariableResolver()

С тех пор:

JSP 2.0

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

JspContext()
Единственный конструктор.

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

abstract java.lang.Object	findAttribute(java.lang.String name) Поиски именованного атрибута в странице, запросе, сеанс (если допустимый), и область (и) действия приложения в порядке и возвратах значение связались или нуль.
abstract java.lang.Object	getAttribute(java.lang.String name) Возвращает объект, связанный с именем в контексте страницы или нуле если не найденный.
abstract java.lang.Object	getAttribute(java.lang.String name, int scope) Возвратите объект, связанный с именем в указанном контексте или нуле если не найденный.
abstract java.util.Enumeration<java.lang.String>	getAttributeNamesInScope(int scope) Перечислите все атрибуты в данном контексте.
abstract int	getAttributesScope(java.lang.String name) Получите контекст, где данный атрибут определяется.
abstract ELContext	getELContext() Возвраты ELContext связанный с этим JspContext.
abstract ExpressionEvaluator	getExpressionEvaluator() Осуждаемый. С JSP 2.1, замененный JspApplicationContext#getExpressionFactory
abstract JspWriter	getOut() Текущая стоимость возражает (JspWriter).
abstract VariableResolver	getVariableResolver() Осуждаемый. С JSP 2.1, замененный ELContext#getELResolver, который может быть получен jspContext.getELContext().getELResolver().
JspWriter	popBody() Возвратите предыдущий JspWriter "," спасенный соответствием pushBody (), и обновите значение, атрибут в контексте страницы приписывает пространство имен JspContext.
JspWriter	pushBody(java.io.Writer writer) Возвратите новый объект JspWriter, который отправляет вывод предоставленному Писателю.
abstract void	removeAttribute(java.lang.String name) Удалите ссылку на объект, связанную с именем от всех контекстов.
abstract void	removeAttribute(java.lang.String name, int scope) Удалите ссылку на объект, связанную с указанным именем в данном контексте.
abstract void	setAttribute(java.lang.String name, java.lang.Object value) Зарегистрируйте имя и оцените определенный с семантикой контекста страницы.
abstract void	setAttribute(java.lang.String name, java.lang.Object value, int scope) Зарегистрируйте имя и оцените определенный с соответствующей семантикой контекста.

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

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

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

JspContext

public JspContext()

Единственный конструктор. (Для вызова конструкторами подкласса, обычно неявными.)

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

setAttribute

public abstract void setAttribute(java.lang.String name,
                                  java.lang.Object value)

Зарегистрируйте имя и оцените определенный с семантикой контекста страницы. Если значение, которое передают в, null, это имеет тот же самый эффект как вызов removeAttribute( name, PageContext.PAGE_SCOPE ).

Параметры:

name - имя атрибута, чтобы установить

value - значение, чтобы связаться с именем, или нулем, если атрибут должен быть удален из контекста страницы.

Броски:

java.lang.NullPointerException - если имя является нулем

setAttribute

public abstract void setAttribute(java.lang.String name,
                                  java.lang.Object value,
                                  int scope)

Зарегистрируйте имя и оцените определенный с соответствующей семантикой контекста. Если значение, которое передают в, null, это имеет тот же самый эффект как вызов removeAttribute( name, scope ).

Параметры:

name - имя атрибута, чтобы установить

value - объект связаться с именем, или нулем, если атрибут должен быть удален из указанного контекста.

scope - контекст, с которым можно связать имя/объект

Броски:

java.lang.NullPointerException - если имя является нулем

IllegalArgumentException - если контекст недопустим

IllegalStateException - если контекстом является PageContext. SESSION_SCOPE, но страница, которую требовали, не участвует в сеансе, или сеанс был лишен законной силы.

getAttribute

public abstract java.lang.Object getAttribute(java.lang.String name)

Возвращает объект, связанный с именем в контексте страницы или нуле если не найденный.

Параметры:

name - имя атрибута, чтобы добраться

Возвраты:

объект, связанный с именем в контексте страницы или нуле, если не найденный.

Броски:

java.lang.NullPointerException - если имя является нулем

getAttribute

public abstract java.lang.Object getAttribute(java.lang.String name,
                                              int scope)

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

Параметры:

name - имя атрибута, чтобы установить

scope - контекст, с которым можно связать имя/объект

Возвраты:

объект, связанный с именем в указанном контексте или нуле, если не найденный.

Броски:

java.lang.NullPointerException - если имя является нулем

IllegalArgumentException - если контекст недопустим

IllegalStateException - если контекстом является PageContext. SESSION_SCOPE, но страница, которую требовали, не участвует в сеансе, или сеанс был лишен законной силы.

findAttribute

public abstract java.lang.Object findAttribute(java.lang.String name)

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

Параметры:

name - имя атрибута, чтобы искать

Возвраты:

значение связалось или нуль

Броски:

java.lang.NullPointerException - если имя является нулем

removeAttribute

public abstract void removeAttribute(java.lang.String name)

Удалите ссылку на объект, связанную с именем от всех контекстов. Ничего не делает, если нет такого объекта.

Параметры:

name - Имя объекта удалить.

Броски:

java.lang.NullPointerException - если имя является нулем

removeAttribute

public abstract void removeAttribute(java.lang.String name,
                                     int scope)

Удалите ссылку на объект, связанную с указанным именем в данном контексте. Ничего не делает, если нет такого объекта.

Параметры:

name - Имя объекта удалить.

scope - Контекст, где смотреть.

Броски:

IllegalArgumentException - если контекст недопустим

IllegalStateException - если контекстом является PageContext. SESSION_SCOPE, но страница, которую требовали, не участвует в сеансе, или сеанс был лишен законной силы.

java.lang.NullPointerException - если имя является нулем

getAttributesScope

public abstract int getAttributesScope(java.lang.String name)

Получите контекст, где данный атрибут определяется.

Параметры:

name - имя атрибута, чтобы возвратить контекст для

Возвраты:

контекст объекта, связанного с определенным именем или 0

Броски:

java.lang.NullPointerException - если имя является нулем

getAttributeNamesInScope

public abstract java.util.Enumeration<java.lang.String> getAttributeNamesInScope(int scope)

Перечислите все атрибуты в данном контексте.

Параметры:

scope - контекст, чтобы перечислить все атрибуты для

Возвраты:

перечисление имен (java.lang. Строка) всех атрибутов указанный контекст

Броски:

IllegalArgumentException - если контекст недопустим

IllegalStateException - если контекстом является PageContext. SESSION_SCOPE, но страница, которую требовали, не участвует в сеансе, или сеанс был лишен законной силы.

getOut

public abstract JspWriter getOut()

Текущая стоимость возражает (JspWriter).

Возвраты:

текущий поток JspWriter, используемый для клиентского ответа

getExpressionEvaluator

public abstract ExpressionEvaluator getExpressionEvaluator()

Осуждаемый. С JSP 2.1, замененный JspApplicationContext#getExpressionFactory

Обеспечивает программируемый доступ к ExpressionEvaluator. Контейнер JSP должен возвратить допустимый экземпляр ExpressionEvaluator, который может проанализировать ЭЛЬ выражения.

Возвраты:

Допустимый экземпляр ExpressionEvaluator.

С тех пор:

JSP 2.0

getVariableResolver

public abstract VariableResolver getVariableResolver()

Осуждаемый. С JSP 2.1, замененный ELContext#getELResolver, который может быть получен jspContext.getELContext().getELResolver().

Возвращает экземпляр VariableResolver, который обеспечивает доступ к неявным объектам, определенным в спецификации JSP, используя этот JspContext в качестве объекта контекста.

Возвраты:

Допустимый экземпляр VariableResolver.

С тех пор:

JSP 2.0

getELContext

public abstract ELContext getELContext()

Возвраты ELContext связанный с этим JspContext.

ELContext создается лениво и снова используется, если это уже существует. Есть новое ELContext для каждого JspContext.

ELContext должен содержать ELResolver описанный в спецификации JSP (и в javadocs для JspApplicationContext#addELResolver).

Возвраты:

ELContext связанный с этим JspContext.

С тех пор:

JSP 2.1

pushBody

public JspWriter pushBody(java.io.Writer writer)

Возвратите новый объект JspWriter, который отправляет вывод предоставленному Писателю. Сохраняет ток JspWriter, и обновляет значение, атрибут в контексте страницы приписывает пространство имен JspContext.

Возвращенный JspWriter должен реализовать все методы и вести себя, как если бы он был небуферизован. Более определенно:

• очистите (), должен бросить IOException
• clearBuffer () ничего не делает
• getBufferSize () всегда возвращается 0
• getRemaining () всегда возвращается 0

Параметры:

writer - Писатель для возвращенного JspWriter, чтобы отправить вывод.

Возвраты:

новый JspWriter, который пишет в данного Писателя.

С тех пор:

JSP 2.0

popBody

public JspWriter popBody()

Возвратите предыдущий JspWriter "," спасенный соответствием pushBody (), и обновите значение, атрибут в контексте страницы приписывает пространство имен JspContext.

Возвраты:

спасенный JspWriter.