APPLICATION
public static final java.lang.String APPLICATION
Имя, используемое для хранения ServletContext'а в таблице имён PageContext'а.
APPLICATION_SCOPE
public static final int APPLICATION_SCOPE
Область видимости - приложение: именованная ссылка работает в данном ServletContext, пока он не будет затребован обратно.
AT_BEGIN
public static final int AT_BEGIN
Информация о видимости: переменная видна после начального тэга.
AT_END
public static final int AT_END
Информация о видимости: переменная видна после конечного тэга.
Конструктор. Детали. |
AutoFlush
protected boolean autoFlush
Конструктор. Детали. |
BODY_CONTENT_EMPTY
public static final java.lang.String BODY_CONTENT_EMPTY
static-константа для getBodyContent(), когда он пустой.
Конструктор. Детали. |
BODY_CONTENT_JSP
public static final java.lang.String BODY_CONTENT_JSP
static-константа для getBodyContent(), когда он - JSP.
BODY_CONTENT_TAG_DEPENDENT
public static final java.lang.String BODY_CONTENT_TAG_DEPENDENT
static-константа для getBodyContent(), когда он зависит от Tag'а.
BodyContent
protected BodyContent( e)
Protected-конструктор.
Неограниченный буфер, нет autoflushing'а.
Метод. Детали. |
protected bodyContent
Конструктор. Детали. |
BodyTagSupport
public BodyTagSupport()
Конструктор по умолчанию, все подклассы должны только определить public-конструктор с той же подписью и вызвать конструктор суперкласса.
Этот конструктор вызывается кодом, генерируемым JSP-транслятором.
Метод. Детали. |
CanBeRequestTime
public boolean canBeRequestTime()
Может ли атрибут содержать значение времени запроса.
Возвращает:может ли атрибут содержать значение времени запроса.
Clear
public abstract void clear() throws java.io.IOException
Очищает содержимое буфера. Если буфер уже был очищен, тогда операция clear должна вызывать IOException для обозначения указания на то, что некоторые данные безвозвратно записаны в поток вывода клиенту.
Вызывает:java.io.IOException - если возникает ошибка I/O.
ClearBody
public void clearBody()
Очищает тело без вызова исключений.
ClearBuffer
public abstract void clearBuffer() throws java.io.IOException
Очищает текущее содержимое буфера. В отличие от clear(), этот метод не вызывает исключение IOException, если буфер уже очищен. Он лишь очищает текущее содержимое буфера и возвращает управление.
Вызывает:java.io.IOException - если возникает ошибка I/O.
Close
public abstract void close() throws java.io.IOException
Закрывает поток, предварительно очистив его.
Этот метод не должен вызываться явно для начального/initial JspWriter'а, так как код, генерируемый JSP-контейнером, будет автоматически включать вызов close().
Закрытие уже закрытого потока, в отличие от flush(), не даст никакого эффекта.
Вызывает:java.io.IOException - если возникает ошибка I/O.
Переопределяет:close в классе java.io.Writer
CONFIG
public static final java.lang.String CONFIG
Имя, используемое для хранения ServletConfig'а в таблице имён PageContext'а.
DEFAULT_BUFFER
public static final int DEFAULT_BUFFER
константа, указывающая, что Writer буферизуется и использует размер буфера по умолчанию для данной реализации.
DoAfterBody
public int doAfterBody() throws
После обсчёта тела: повторно не вычислять и продолжать обсчёт страницы. По умолчанию ничего не делается с данными bodyContent'а (если имеются).
Возвращает:SKIP_BODYПереопределяет: в классе
public int doAfterBody() throws
Производит (повторное) вычисление тела. Этот метод вызывается объектом реализации JSP-страницы после каждого вычисления тела в объекте BodyEvaluation. Этот метод не вызывается. если нет вычисления тела.
Если doAfterBody возвращает EVAL_BODY_AGAIN, происходит новое вычисление тела (с последующим новым вызовом doAfterBody).
Если doAfterBody возвращает SKIP_BODY, больше вычисление тела не производится, значение out будет восстановлено методом popBody в pageContext и будет затем вызван doEndTag.
Повторные вызовы метода могут привести к различным действиям, поскольку могут происходить изменения разделяемого статуса, или из-за внешних вычислений.
JSP-контейнер будет ресинхронизировать любые значения переменных, которые обозначены как таковые в TagExtraInfo, после вызова doAfterBody().
Возвращает:нужны ли дополнительные обсчёты тела.Вызывает:
Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | | КОНСТРУКТОР |
ДЕТАЛИ: | КОНСТРУКТОР |
public int doAfterBody() throws
Процессинг по умолчанию тела.
Кем специфицирован: в интерфейсе .
Возвращает:SKIP_BODYСм. также:
DoCatch
public void doCatch(java.lang.Throwable t) throws java.lang.Throwable
Вызывается. если возникает Throwable в процессе обсчёта BODY внутри тэга или в любом из следующих методов: Tag.doStartTag(), Tag.doEndTag(), IterationTag.doAfterBody() и BodyTag.doInitBody().
Этот метод не вызывается, если Throwable возникает в действия одного из setter-методов.
Этот метод может вызывать исключение (то же самое или новое), которое будет передано затем во вложенную цепь. Если исключение отловлено, вызывается doFinally().
Этот метод предназначен для использования в ответ на возникновение исключительного условия.
Параметры:t - отлавливаемое исключение, перемещающееся по данному тэгу.
DoEndTag
public int doEndTag() throws
Процессинг по умолчанию конечного тэга, возвращающего EVAL_PAGE.
Возвращает:EVAL_PAGEПереопределяет: в классе
public int doEndTag() throws
Обработать конечный тэг данного экземпляра. Этот метод вызывается объектом реализации JSP-страницы во всех обработчиках Tag'а.
Этот метод будет вызываться после возвращения из doStartTag. Тело акции может или может не быть вычисленным, в зависимости от return-занчения метода doStartTag.
Если этот метод возвращает EVAL_PAGE, остаток страницы продолжает обсчитываться.
Если этот метод возвращает SKIP_PAGE, остаток страницы не обсчитывается и запрос выполняется.
Если этот запрос был направлен или включён из другой страницы (или Servlet), выполняется обсчёт только текущей страницы.
JSP-контейнер будет ресинхронизировать любые значения переменных, обозначенных как таковые в TagExtraInfo, после вызова doEndTag().
Вызывает:JspException
public int doEndTag() throws
Обработка по умолчанию конечного тэга, возвращающего EVAL_PAGE.
См. также:
DoFinally
public void doFinally()
Всегда вызывается после doEndTag() для любого класса, реализующего Tag, IterationTag или BodyTag. Этот метод вызывается, даже если исключение возникает в BODY тэга или в одном из следующих методов: Tag.doStartTag(), Tag.doEndTag(), IterationTag.doAfterBody() и BodyTag.doInitBody().
Этот метод не вызывается, если Throwable возникает в действия одного из setter-методов.
Этот метод не должен вызывать Exception.
Этот метод предназначен для обслуживания целостности вызываемых данных и акций по обслуживанию ресурсов.
Класс |
СЛЕДУЮЩИЙ ИНТЕРФЕЙС
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | КОНСТРУКТОР |
ДЕТАЛИ: ПОЛЕ | КОНСТРУКТОР |
DoInitBody
public void doInitBody() throws
Подготавливает вычисление тела. Этот метод вызывается объектом реализации JSP-страницы после setBodyContent и до первого вычисления тела. Этот метод не будет вызываться для пустых тэгов или непустых тэгов, чей метод doStartTag() возвращает SKIP_BODY или EVAL_BODY_INCLUDE.
JSP-контейнер будет ресинхронизировать любые значения переменных, которые обозначены как таковые в TagExtraInfo, после вызова doInitBody().
Вызывает:
Класс |
ПРЕДЫДУЩИЙ КЛАСС
РЕЗЮМЕ: ВНУТРЕННИЙ | | КОНСТРУКТОР |
ДЕТАЛИ: | КОНСТРУКТОР |
public void doInitBody() throws
Подготавливает для вычисления тела сразу перед первым вычислением тела: нет акции.
Специфицирован в: в интерфейсе
DoStartTag
public int doStartTag() throws
Процессинг по умолчанию начального тэга, возвращающего EVAL_BODY_BUFFERED.
Возвращает:EVAL_BODY_BUFFEREDПереопределяет: в классе
public int doStartTag() throws
Обрабатывает начальный тэг данного экземпляра. Этот метод вызывается объектом реализации JSP-страницы.
Метод doStartTag принимает, что свойства pageContext и parent уже установлены. Он также принимает, что любые свойства, экспонированные как атрибуты, также установлены. Если этот метод вызывается, это означает, что тело ещё не обсчитывалось.
Этот метод возвращает Tag.EVAL_BODY_INCLUDE или BodyTag.EVAL_BODY_BUFFERED для указания на то, что тело акции должно быть обсчитано, или SKIP_BODY - для обозначения обратного.
Если Tag возвращает EVAL_BODY_INCLUDE, результат вычисления тела (если оно имеется) включается в текущий "out" JspWriter, как происходит при вызове doEndTag().
BodyTag.EVAL_BODY_BUFFERED является единственным верным значением, если обработчик тэга реализует BodyTag.
JSP-контейнер будет ресинхронизировать любые значения переменных, обозначенных как таковые в TagExtraInfo, после вызова doStartTag().
Вызывает:JspExceptionСм. также:
public int doStartTag() throws
Обработка по умолчанию начального тэга, возвращающего SKIP_BODY.
См. также:
EVAL_BODY_AGAIN
public static final int EVAL_BODY_AGAIN
Запрашивает вычисление некоторого тела. Возвращается из doAfterBody.
Для обеспечения совместимости с JSP 1.1, значение тщательно выбирается, чтобы быть таким же, как и, ныне не рекомендуемое, BodyTag.EVAL_BODY_TAG,
Метод. Детали. |
EVAL_BODY_BUFFERED
public static final int EVAL_BODY_BUFFERED
Запрашивает создание нового буфера, BodyContent, в котором вычисляется тело данного тэга.
Возвращено из doStartTag, если он реализует BodyTag. Для doStartTag будет недопустимым return-занчением, если класс не реализует BodyTag.
Метод. Детали. |
EVAL_BODY_INCLUDE
public static final int EVAL_BODY_INCLUDE
Вычислить тело в существующем потоке out. Верное return-значение для doStartTag.
EVAL_BODY_TAG
public static final int EVAL_BODY_TAG
Не рекомендуется. Как и в Java JSP API 1.2, использовать BodyTag.EVAL_BODY_BUFFERED или IterationTag.EVAL_BODY_AGAIN.Не рекомендуемая для использования константа, которая имеет то же самое значение, что и EVAL_BODY_BUFFERED и EVAL_BODY_AGAIN. Это имя отмечено как не рекомендуемое для поощрения использования двух новых терминов, которые являются более описательными.
EVAL_PAGE
public static final int EVAL_PAGE
Продолжить вычисление страницы. Верное return-значение для doEndTag().
Метод. Детали. |
EXCEPTION
public static final java.lang.String EXCEPTION
Имя, используемое для хранения неотловленного исключения в списке атрибутов ServletRequest'а и в таблице имён PageContext'а.
Конструктор. Детали. |
FindAncestorWithClass
public static final findAncestorWithClass(from, java.lang.Class klass)
Находит экземпляр данного типа класса - ближайший к данному экземпляру. Этот метод использует метод getParent из интерфейса Tag.
Этот метод используется для координации кооперирующихся тэгов.
Текущая версия спецификации предоставляет только один формальный способ указания рассматриваемого типа обработчика тэга: класс реализации обработчика тэга, описанный с субэлементе tag-class элемента tag. Это расширяется неформальным способом путём разрешения автору библиотеки тэгов указывать в субэлементе description рассматриваемый тип. Тип должен быть подтипом класса реализации обработчика тэга или void. Это дополнительное ограничение может быть использовано специализированным контейнером, который знает об этой специфической библиотеке тэгов, как в случае со стандартной библиотекой тэгов JSP.
Если автор библиотеки тэгов предоставляет информацию о рассматриваемом типе обработчика тэга, клиентский программный код должен придерживаться этого ограничения. А точнее, Class, передаваемый методу findAncestorWithClass, должен быть подтипом рассматриваемого типа.
Параметры:from - экземпляр, с которого начинать просмотр.klass - подкласс Tag'а или др. соответствующего интерфейса.
FindAttribute
public abstract java.lang.Object findAttribute(java.lang.Stringname)
Ищет именованный атрибут в областях видимости page, request, session (если запущена) и application, в указанном порядке, и возвращает ассоциированное значение или null.
Возвращает:ассоциированное значение или null
Flush
public void flush() throws java.io.IOException
Переопределил flush(), поэтому это недопустимо.
Недопустимо очищать BodyContent, поскольку позади него нет фонового потока.
Переопределяет: в классе .
public abstract void flush() throws java.io.IOException
Очищает (промывает/Flush) поток. Если поток сохранил в буфере любые символы из разных методов write(), немедленно записывает их по назначению. Затем, если назначением является другой символ или поток байтов, очищает поток. Таким образом, один вызов flush() будет очищать все буферы в цепи Writer'ов и OutputStream'ов.
Этот метод может быть вызван неявно, если размер буфера превышен.
После того как поток был закрыт, последующие вызовы методов write() или flush() приводят к вызову исключения IOException.
Вызывает:java.io.IOException - если возникает ошибка I/O.
Переопределяет:flush в классе java.io.Writer
Forward
public abstract void forward(java.lang.StringrelativeUrlPath) throws javax.servlet.ServletException, java.io.IOException
Этот метод используется для перенаправления текущих ServletRequest и ServletResponse другому активному компоненту приложения.
Если relativeUrlPath начинается с "/", тогда специфицированный URL вычисляется относительно DOCROOT ServletContext'а
для данной JSP.
Если путь не начинается с "/", специфицированный URL вычисляется относительно URL запроса, который был отображён в вызывающую JSP.
Верным является только вызов этого метода из Thread, выполняющегося внутри метода _jspService(...) в JSP.
После успешного вызова этого метода, для вызывающего Thread не разрешаются попытки модифицировать
ServletResponse-объект. Любая такая попытка даёт непредсказуемое поведение. Обычно вызывающий, после вызова этого метода, немедленно возвращается из метода _jspService(...).
Параметры:relativeUrlPath - специфицирует относительный путь URL к целевому ресурсу, как описано выше.
Вызывает:javax.servlet.ServletExceptionjava.io.IOExceptionjava.lang.IllegalArgumentException - если URL целевого ресурса неразрешим.java.lang.IllegalStateException - если ServletResponse не в том состоянии, когда перенаправление может быть выполнено.java.lang.SecurityException - если целевой ресурс не может быть достигнут взывающим.
Все классы и интерфейсы Java Server Pages
public abstract java.lang.Object getAttribute(java.lang.Stringname)
Возвращает объект, ассоциированный с именем в области видимости page, или null, если не найден.
Параметры:name - имя получаемого атрибута
Вызывает:NullPointerException - если name - nulljava.lang.IllegalArgumentException - если область видимости неверна
public abstract java.lang.Object getAttribute(java.lang.String name, int scope)
Возвращает объект, ассоциированный с именем в специфицированной области видимости, или null, если не найден.
Параметры:name - имя атрибута для установкиscope - область видимости, с которой ассоциируется name/objectВызывает:NullPointerException - если name - nulljava.lang.IllegalArgumentException - если область видимости неверна
public java.lang.Object getAttribute(java.lang.StringattName)
Значение атрибута. Возвращает определённый объект REQUEST_TIME_VALUE, если это значение времени запроса. Возвращает null, если атрибут не установлен.
Возвращает:объект значения атрибута.
Все классы и интерфейсы Java Server Pages
public abstract java.util.Enumeration getAttributeNamesInScope(intscope)
Перечисляет все атрибуты в данной области видимости.
Возвращает:перечисление имён (java.lang.String) всех атрибуты в специфицированной области видимости.
Все классы и интерфейсы Java Server Pages
public java.util.Enumeration getAttributes()
Перечисляет атрибуты.
Возвращает:перечисление атрибутов в TagData.
Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ| | |
ДЕТАЛИ: | |
public [] getAttributes()
Информация атрибута (в TLD) данного тэга. Значение return - это массив, описывающий атрибуты данного тэга, как указано в TLD. Нулевой return означает отсутствие атрибутов.
Возвращает:массив TagAttributeInfo данного тэга.
Все классы и интерфейсы Java Server Pages
public abstract int getAttributesScope(java.lang.String name)
Получает область видимости, где определён данный атрибут.
Возвращает:область видимости объекта, ассоциированного со специфицированным именем, или 0.
Все классы и интерфейсы Java Server Pages
public java.lang.String getAttributeString(java.lang.StringattName)
Получает значение данного атрибута.
Возвращает:строковое значение атрибута.
Все классы и интерфейсы Java Server Pages
public getBodyContent()
Получить текущий bodyContent.
Возвращает:содержимое тела.
public java.lang.String getBodyContent()
Информация bodycontent для данного тэга.
Возвращает:строку содержимого тела.
Все классы и интерфейсы Java Server Pages
public int getBufferSize()
Этот метод возвращает размер буфера, используемого JspWriter'ом.
Возвращает:размер буфера в байтах или 0, если буферизации нет.
Все классы и интерфейсы Java Server Pages
public java.lang.String getClassName()
Тело элемента <variable-class>.
Возвращает:Имя класса переменной.
Все классы и интерфейсы Java Server Pages
public boolean getDeclare()
Тело элемента <declare>.
Возвращает:Объявляется переменная, или нет.
Все классы и интерфейсы Java Server Pages
public static getDefaultFactory()
Возвращает:фактория по умолчанию для данной реализации.
Все классы и интерфейсы Java Server Pages
public java.lang.String getDisplayName()
Получает displayName.
Возвращает:краткое имя, отображаемое утилитами.
Все классы и интерфейсы Java Server Pages
public getEnclosingWriter()
Получает содержащий JspWriter.
Возвращает:содержащий JspWriter, переданный на этапе конструирования.
Класс |
ПРЕДЫДУЩИЙ КЛАСС
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: ПОЛЕ | |
Все классы и интерфейсы Java Server Pages
public abstract getEngineInfo()
вызывается для получения специфической для данной реализации информации о текущей JSP-машине.
Возвращает:JspEngineInfo-объект, описывающий текущую JSP-машину.
Класс |
ДЕТАЛИ: ПОЛЕ | |
Все классы и интерфейсы Java Server Pages
public abstract java.lang.Exception getException()
Текущее значение объекта exception (Exception).
Возвращает:любое исключение, передаваемое как errorpage.
Все классы и интерфейсы Java Server Pages
public java.lang.String getId()
Значение атрибута id, если имеется.
Возвращает:значение атрибута id или null.
public java.lang.String getId()
Значение атрибута id данного тэга; или null.
public java.lang.String getId()
Получает jsp:id. Null означает, что доступной информации нет.
Возвращает:информацию jsp:id.
Все классы и интерфейсы Java Server Pages
public static getIdAttribute([]a)
Удобный static-метод, проходящий по массиву TagAttributeInfo-объектов в поисках "id".
Параметры:a - массив TagAttributeInfo.
Возвращает:Ссылка на TagAttributeInfo с именем "id".
Все классы и интерфейсы Java Server Pages
public java.lang.String getInfoString()
Строка информации для данного тэга.
Возвращает:info-строку.
public java.lang.String getInfoString()
Информация (документация) для данного TLD.
Все классы и интерфейсы Java Server Pages
public java.util.Map getInitParameters()
Получает данные init-параметров как неизменяемую Map/Карту. Имена параметров - это ключи, а значения параметров являются значениями.
Возвращает:init-параметры как неизменяемая карта.
Все классы и интерфейсы Java Server Pages
public abstract java.io.InputStream getInputStream()
Возвращает поток ввода в XML-просмотре JSP-страницы. Вызывает XML-просмотр JSP-страницы, имеющей развёрнутые директивы include.
Возвращает:Поток ввода документа.
Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | |
ДЕТАЛИ: ПОЛЕ | |
Все классы и интерфейсы Java Server Pages
public java.lang.String getLargeIcon()
Получает путь к большой иконке.
Возвращает:путь к большой иконке, отображаемой утилитами.
Все классы и интерфейсы Java Server Pages
public java.lang.String getMessage()
Получает локализованное сообщение о проверке.
Возвращает:сообщение о проверке.
Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | |
ДЕТАЛИ: ПОЛЕ | |
Все классы и интерфейсы Java Server Pages
public java.lang.String getName()
Имя данного атрибута.
Возвращает:имя атрибута.
Все классы и интерфейсы Java Server Pages
public java.lang.String getNameFromAttribute()
Тело элемента <name-from-attribute>. Это имя атрибута чьё значение (на этапе трансляции) будет давать имя переменной. Необходимо наличие одного из элементов: <name-given> или <name-from-attribute>.
Возвращает:Атрибут, чьё значение определяет имя переменной.
Все классы и интерфейсы Java Server Pages
public java.lang.String getNameGiven()
Тело элемента <name-given>.
Возвращает:Константу-имя переменной.
Все классы и интерфейсы Java Server Pages
public abstract getOut()
Текущее значение объекта out (JspWriter).
Возвращает:текущий поток JspWriter'а, используемый для ответа клиенту.
Все классы и интерфейсы Java Server Pages
public abstract java.lang.Object getPage()
Текущее значение объекта page (Servlet).
Возвращает:экземпляр класса реализации Page (Servlet), ассоциированный с данным pageContext'ом.
Все классы и интерфейсы Java Server Pages
public abstract getPageContext(javax.servlet.Servletservlet, 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, или nullneedsSession - true, если JSP участвует в сессииbuffer - размер буфера в байтах, PageContext.NO_BUFFER - если буфера нет, PageContext.DEFAULT_BUFFER - если буфер по умолчанию для данной реализацииautoflush - должен ли буфер автоматически очищаться в потоке вывода, или вызывать IOException?Возвращает:контекст страницыСм. также: