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

Пакет javax.servlet.jsp

Классы и интерфейсы для Базового JSP 2.1 API.

См.:
Описание

Сводка интерфейса

HttpJspPage	Интерфейс HttpJspPage описывает взаимодействие, которое Класс Реализации Страницы JSP должен удовлетворить при использовании протокола HTTP.
JspApplicationContext	Хранит определяющую контекст приложением информацию, относящуюся к контейнерам JSP.
JspPage	Интерфейс JspPage описывает универсальное взаимодействие, которое должна удовлетворить Реализация Страницы JSP class; страницы, которые используют протокол HTTP, описываются интерфейсом HttpJspPage.

Сводка класса

ErrorData	Содержит информацию об ошибке, для ошибочных страниц.
JspContext	JspContext служит основным class для PageContext class и краткие обзоры вся информация, которая не является определенной для сервлетов.
JspEngineInfo	JspEngineInfo является абстрактный class, который предоставляет информацию о текущем механизме JSP.
JspFactory	JspFactory является абстрактный class, который определяет много методов фабрики, доступных странице JSP во времени выполнения в целях создать экземпляры различных интерфейсов и классов, используемых, чтобы поддерживать реализацию JSP.
JspWriter	Данные действий и шаблона в странице JSP пишутся, используя объект JspWriter, на который ссылается неявная переменная, которая инициализируется, автоматически используя методы в объекте PageContext.
PageContext	PageContext расширяет JspContext, чтобы обеспечить полезную контекстную информацию для того, когда технология JSP используется в среде Сервлета.

Сводка исключения

JspException	Универсальное исключение, известное механизму JSP; непойманный JspExceptions приведет к вызову errorpage машины.
JspTagException	Исключение, которое будет использоваться Обработчиком Тега, чтобы указать на некоторую неисправимую ошибку.
SkipPageException	Исключение, чтобы указать на страницу вызова должно прекратить оценку.

Пакет javax.servlet.jsp Описание

Классы и интерфейсы для Базового JSP 2.1 API.

javax.servlet.jsp пакет содержит много классов и интерфейсов, которые описывают и определяют контракты между реализацией страницы JSP class и средой выполнения, предусмотренной экземпляр такого class приспосабливанием контейнер JSP.

Контракт Объекта Реализации Страницы JSP

Этот раздел описывает основной контракт между объектом реализации Страницы JSP и его контейнером.

Основной контракт определяется классами JspPage и HttpJspPage. JspFactory class описывает механизм, чтобы портативно инстанцировать всех необходимых объектов периода выполнения, и JspEngineInfo обеспечивает основную информацию о текущем контейнере JSP. Класс JspApplicationContext хранит определяющую контекст приложением информацию, относящуюся к контейнерам JSP. Это было добавлено в JSP 2.1, чтобы поддерживать интеграцию объединенного Языка Выражения.

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

Неявные Объекты

PageContext возразите и JspWriter доступны по умолчанию как неявные объекты.

Исключения

JspException class является основной class для всех исключений JSP. JspTagException и SkipPageException исключения используются механизмом расширения тега.

Для ошибочных страниц JSP, ErrorData class инкапсулирует информацию об ошибке.

Пример Реализации

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

Вот один пример того, как использовать эти классы

 public class foo implements Servlet {

 // ...

public void _jspService(HttpServletRequest request,
                        HttpServletResponse response)
       throws IOException, ServletException {

    JspFactory  factory     = JspFactory.getDefaultFactory();
    PageContext pageContext = factory.getPageContext(
                                        this,
                                        request,
                                        response,
                                        null,  // errorPageURL
                                        false, // needsSession
                                        JspWriter.DEFAULT_BUFFER,
                                        true   // autoFlush
                                );

    // initialize implicit variables for scripting env ...

    HttpSession session = pageContext.getSession();
    JspWriter   out     = pageContext.getOut();
    Object      page    = this;

    try {
        // body of translated JSP here ...
    } catch (Exception e) {
        out.clear();
        pageContext.handlePageException(e);
    } finally {
        out.close();
          factory.releasePageContext(pageContext);
    }
}