JSP.9.1.3 JspFactory
Синтаксис
public abstract class JspFactory
Описание
JspFactory является абстрактным классом, определяющим несколько factory/"фабричных"-методов, доступных JSP-странице на этапе прогона, для создания экземпляров различных интерфейсов и классов, используемых для поддержки JSP-реализации.
Соответствующая реализация JSP Engine будет, в процессе своей инициализации, инстанциировать зависящий от реализации подкласс этого класса сделает его глобально доступным для использования классами реализации JSP путём регистрации экземпляра, созданного этим классом, через static/статичный метод setDefaultFactory().
Классы PageContext и JspEngineInfo являются единственными зависящими от реализации классами, которые могут создаваться из factory/фактории.
JspFactory-объекты не должны использоваться авторами JSP-страниц.
JSP.9.1.3.3 Конструкторы
public JspFactory()
JSP.9.1.3.4 Методы
public static synchronized JspFactory getDefaultFactory()
Возвращает: факторию по умолчанию для данной реализации
public abstract JspEngineInfo getEngineInfo()
вызывается для получения специфической для реализации информации о текущей JSP-машине.
Возвращает: объект JspEngineInfo, описывающий текущую JSP-машину.
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.Page-Context для вызова Servlet и текущего отправления запроса/request и ответа/response.
Этот метод обычно вызывает раньше при обработке методом _jspService()
класса реализации JSP для того, чтобы получить объект PageContext для обрабатываемого запроса.
Вызов этого метода должен давать в результате вызов метода PageContext.initialize(). Возвращённый PageContext соответственно инициализирован.
Все объекты PageContext, полученные этим методом, должны быть освобождены через вызов releasePageContext().
Параметры:
servlet - запрашивающий сервлет
config - ServletConfig для запрашивающего Servlet'а
request - текущий запрос, находящийся в сервлете.
response - текущий ответ, находящийся в сервлете.
errorPageURL - URL страницы ответа на ошибки для запрашивающей JSP, или null.
needsSession - true, если JSP участвует в сессии.
buffer - размер буфера в байтах, PageContext.NO_BUFFER - если буфера нет, PageContext.DEFAULT_BUFFER - если по умолчанию в реализации.
autoflush - должен ли буфер автоматически зачищаться (опять зачистка...) в потоке вывода при переполнени буфера, или должно вызываться IOException?
Возвращает: page context/контекст страницы.
См. Также: .
public abstract void releasePageContext(PageContext pc)
Вызывается для освобождения ранее размещённого объекта PageContext. Даёт в результате вызов Page-Context.release(). Этот метод должен вызываться до возвращения из метода _jspService() класса реализации JSP.
Параметры:
pc - PageContext, полученный ранее методом getPageContext()
public static synchronized void setDefaultFactory(JspFactory deflt)
Устанавливает факторию по умолчанию для данной реализации. Для любой principal (основной среды работы?), кроме среды JSP Engine, недопустимо вызывать этот метод.
Параметры:
default - реализация фактории по умолчанию.
