Все классы и интерфейсы Java Server Pages
       

Javax.servlet.jsp Класс PageContext


java.lang.Object | +--javax.servlet.jsp.PageContext

public abstract class PageContextextends java.lang.Object

Экземпляр класса PageContext предоставляет доступ ко всем пространствам имён, ассоциированным с JSP-страницей, к различным атрибутам страницы, а также слой поверх деталей реализации.

Неявные объекты добавляются к pageContext автоматически.

Класс PageContext это абстрактный класс, разработанный с возможностью последующего расширения для предоставления реализаций, в зависимости от свойств самих же реализаций, в среде соответствующих JSP-машин. Экземпляр PageContext получается классом реализации JSP через вызов метода JspFactory.getPageContext(), и освобождается через вызов метода JspFactory.releasePageContext().

Примеры использования PageContext, JspFactory и других классов в объекте Реализации JSP-Страницы можно найти повсюду.

PageContext имеет особенности, упрощающие работу авторов страниц/компонентов и реализаторов страниц, в том числе:

  • единый API для обслуживания пространств имён различных областей видимости;

  • несколько удобных API для доступа к различным public-объектам;

  • механизм получения JspWriter'а для вывода;
  • механизм обслуживания использования сессии страницей;
  • механизм экспонирования ("показа") атрибутов директивы page среде скриптинга;
  • механизмы направления или включения текущего запроса в другие компоненты приложения;
  • механизм обработки процессов исключений errorpage;

Методы, Предназначенные для Кода, Генерируемого Контейнером

Некоторые методы предназначены для использования кодом , генерируемым контейнером, а не кодом, написанным авторами JSP-страниц или библиотек тэгов JSP.

Методами, поддерживающими жизненный цикл, являются initialize() и release().

Методы делающие возможным обслуживание вложенных потоков JspWriter'а для реализации Расширений Тэгов: pushBody() и popBody()

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



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


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


    getOut(), getException(), getPage()

    getRequest(), getResponse(), getSession(), getServletConfig() и getServletContext().


Следующие методы предоставляют поддержку для направления, включения и обработки ошибок: forward(), include() и handlePageException().

Поле. Резюме.
staticjava.lang.String

          Имя, используемое для хранения ServletContext в таблице имён PageContext.
static int

          Область видимости - приложение: именованные ссылки работают в ServletContext'е, пока он не будет вызван.
static java.lang.String

          Имя, используемое для хранения ServletConfig в таблице имён PageContext.
static java.lang.String

          Имя, используемое для хранения неотловленного исключения в списке атрибутов ServletRequest'а и в таблице имён PageContext.
static java.lang.String

          Имя, используемое для хранения текущего JspWriter'а в таблице имён PageContext.
static java.lang.String

          Имя, используемое для хранения Servlet в таблицах имён этого PageContext.
static int

          Область видимости - страница: (это значение по умолчанию) именованные ссылки работают в этом PageContext'е до возвращения из текущего вызова метода Servlet.service().
static java.lang.String

          Имя, используемое для хранения этого PageContext'а в его собственной таблице имён.
static java.lang.String

          Имя, используемое для хранения  ServletRequest'а в таблице имён PageContext.
static int

          Область видимости - запрос: именованные ссылки работают из ServletRequest'а, ассоциированного с Servlet'ом, пока выполнение текущего запроса не будет завершено.
static java.lang.String

          Имя, используемое для хранения  ServletResponse в таблице имён PageContext'а.
static java.lang.String

          Имя, используемое для хранения  HttpSession в таблице имён PageContext'а.
static int

          Область видимости - сессия (верно, только если данная страница участвует в сессии): именованные ссылки работают из HttpSession (если имеется), ассоциированного с Servlet'ом, пока HttpSession не будет закрыта.
<


Конструктор. Резюме.
()

           
Метод. Резюме.
abstract  java.lang.Object (java.lang.String name)

          Ищет именованный атрибут в области(-ях) видимости page, request, session (если запущена) и application, в указанном порядке, и возвращает ассоциированное значение или null.
abstract  void (java.lang.String relativeUrlPath)

           Этот метод используется для перенаправления текущего ServletRequest'а и ServletResponse'а другому активному компоненту приложения.
abstract  java.lang.Object (java.lang.String name)

          Возвращает объект, ассоциированный с именем в области видимости page, или null, если объект не найден.
abstract  java.lang.Object (java.lang.String name, int scope)

          Возвращает объект, ассоциированный с именем в специфицированной области видимости, или null, если объект не найден.
abstract  java.util.Enumeration (int scope)

          Перечисляет все атрибуты в данной области видимости.
abstract  int (java.lang.String name)

          Получит область видимости, в которой определён данный атрибут.
abstract  java.lang.Exception ()

          Текущее значение объекта исключения (Exception).
abstract   ()

          Текущее значение объекта out (JspWriter).
abstract  java.lang.Object ()

          Текущее значение объекта page (Servlet).
abstract  javax.servlet.ServletRequest ()

          Текущее значение объекта request (ServletRequest).
abstract  javax.servlet.ServletResponse ()

          Текущее значение объекта response (ServletResponse).
abstract  javax.servlet.ServletConfig ()

          ServletConfig-экземпляр.
abstract  javax.servlet.ServletContext ()

          ServletContext-экземпляр.
abstract  javax.servlet.http.HttpSession ()

          Текущее значение объекта session (HttpSession).
abstract  void (java.lang.Exception e)

           Этот метод предназначен для обработки необработанного исключения уровня "page" путём перенаправления исключения специфицированной для данной JSP-страницы странице ошибок, либо, если ничего не было специфицировано, выполняя некоторое зависящее от реализации действие.
abstract  void (java.lang.Throwable t)

           Этот метод идентичен handlePageException(Exception), за исключением того, что он принимает Throwable.
abstract  void (java.lang.String relativeUrlPath)

           Вызывает обработку специфицированных ресурсов как части текущих ServletRequest и ServletResponse, обрабатываемых вызывающим Thread/потоком.
abstract  void (javax.servlet.Servlet servlet, javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, java.lang.String errorPageURL, boolean needsSession, int bufferSize, boolean autoFlush)

           Метод initialize вызывается для инициализации неинициализированного PageContext'а так, что он (РС) может использоваться классом Реализации JSP для обслуживания входящих запросов и ответов внутри метода _jspService().
  ()

          Возвращает "out" предыдущего JspWriter'а, сохраняемый парным pushBody() и обновляет значение атрибута "out" в пространстве имён атрибутов из области видимости page PageConxtext'а.
  ()

          Возвращает BodyContent-объект, сохраняет текущий "out" JspWriter и обновляет значение атрибута "out" в пространстве имён атрибутов из области видимости page PageConxtext'а.
abstract  void ()

           Этот метод будет "восстанавливать/reset" начальное состояние PageContext'а, освобождая все ссылки и подготавливая PageContext для возможного использования в последующих вызовах initialize().
abstract  void (java.lang.String name)

          Удаляет ссылку на объект, ассоциированный с данным именем, просматривая во всех областях видимости в (установленном) порядке просмотра.
abstract  void (java.lang.String name, int scope)

          Удаляет ссылку на объект, ассоциированный со специфицированным именем в данной области видимости.
abstract  void (java.lang.String name, java.lang.Object attribute)

          Регистрирует имя/name и объект/object, специфицированные семантикой области видимости scope.
abstract  void (java.lang.String name, java.lang.Object o, int scope)

          Регистрирует имя/name и объект/object, специфицированные семантикой соответствующей области видимости.
 
Методы, унаследованные из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Поле. Детали.

Содержание раздела