javax.servlet.jsp
Класс JspFactory

java.lang.Object | +--javax.servlet.jsp.JspFactory
public abstract class JspFactory
extends java.lang.Object

JspFactory это абстрактный класс, определяющий несколько "фабричных"/factory методов, доступных JSP-странице на этапе прогона, для создания экземпляров различных интерфейсов и классов, используемых для поддержки реализации JSP.

Соответствующая требованиям реализация JSP-Машины будет в процессе своей инициализации инстанциировать зависящий от реализации подкласс этого класса и сделает его глобально доступным для использования классами реализации JSP посредством регистрации экземпляра, созданного данным классом с помощью static-метода setDefaultFactory().

Классы PageContext и JspEngineInfo являются единственными зависящими от реализации классами, которые могут создаваться только в фактории.

Объекты JspFactory не должны использоваться авторами JSP-страниц.


Конструктор. Резюме.
JspFactory ()
           
 
Метод. Резюме.
static JspFactory getDefaultFactory ()
           
abstract  JspEngineInfo getEngineInfo ()
           вызывается для получения специфической для данной реализации информации о текущей JSP-машине.
abstract  PageContext getPageContext (javax.servlet.Servlet servlet, javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, java.lang.String errorPageURL, boolean needsSession, int buffer, boolean autoflush)
           получает экземпляр зависящего от реализации абстрактного класса javax.servlet.jsp.PageContext для вызова Servlet и текущего обслуживания запроса и ответа.
abstract  void releasePageContext (PageContext pc)
           вызывается для освобождения ранее размещённого объекта PageContext.
static void setDefaultFactory (JspFactory deflt)
           установить факторию по умолчанию для данной реализации.
 
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Конструктор. Детали.

JspFactory

public JspFactory()
Метод. Детали.

setDefaultFactory

public static void setDefaultFactory(JspFactory deflt)

установить факторию по умолчанию для данной реализации.
Только среда прогона программ JSP-Машина может вызывать этот метод.

Параметры:
default - реализация фактории по умолчанию.

getDefaultFactory

public static JspFactory getDefaultFactory()
Возвращает:
фактория по умолчанию для данной реализации.

getPageContext

public abstract PageContext getPageContext(javax.servlet.Servlet servlet, javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, java.lang.String errorPageURL, boolean needsSession, int buffer, boolean autoflush)

получает экземпляр зависящего от реализации абстрактного класса javax.servlet.jsp.PageContext для вызова Servlet и текущего обслуживания запроса и ответа.

Этот метод обычно вызывается до процессинга метода _jspService() класса реализации JSP, чтобы получить объект PageContext для обрабатываемого запроса.

Вызов этого метода должен приводить к вызову метода PageContext.initialize().
Возвращаемый PageContext инициализируется соответствующим образом.

Все PageContext-объекты, полученные с помощью данного метода, должны уничтожаться через вызов releasePageContext().

Параметры:
servlet - запрашивающий сервлет
config - ServletConfig для запрашивающего Servlet'а
request - текущий запрос/request, обслуживаемый сервлетом
response - текущий ответ/response, обслуживаемый сервлетом
errorPageURL - URL страницы ошибок для запрашивающей JSP, или null
needsSession - true, если JSP участвует в сессии
buffer - размер буфера в байтах, PageContext.NO_BUFFER - если буфера нет, PageContext.DEFAULT_BUFFER - если буфер по умолчанию для данной реализации
autoflush - должен ли буфер автоматически очищаться в потоке вывода, или вызывать IOException?
Возвращает:
контекст страницы
См. также:
PageContext

releasePageContext

public abstract void releasePageContext(PageContext pc)

вызывается для уничтожения/освобождения ранее размещённого PageContext-объекта. результатом является вызов PageContext.release().
Этот метод должен вызываться до возвращения из метода _jspService() класса реализации JSP.

Параметры:
pc - PageContext, полученный ранее методом getPageContext()

getEngineInfo

public abstract JspEngineInfo getEngineInfo()

вызывается для получения специфической для данной реализации информации о текущей JSP-машине.

Возвращает:
JspEngineInfo-объект, описывающий текущую JSP-машину.