Все классы и интерфейсы Java Server Pages
APPLICATION_SCOPE
public static final int APPLICATION_SCOPEОбласть видимости - приложение: именованная ссылка работает в данном ServletContext, пока он не будет затребован обратно.
APPLICATION
public static final java.lang.String APPLICATIONИмя, используемое для хранения ServletContext'а в таблице имён PageContext'а.
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_EMPTYstatic-константа для getBodyContent(), когда он пустой.
| Конструктор. Детали. |
BODY_CONTENT_JSP
public static final java.lang.String BODY_CONTENT_JSPstatic-константа для getBodyContent(), когда он - JSP.
BODY_CONTENT_TAG_DEPENDENT
public static final java.lang.String BODY_CONTENT_TAG_DEPENDENTstatic-константа для 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()Тело элемента
Возвращает:Имя класса переменной.
Все классы и интерфейсы Java Server Pages
public boolean getDeclare()Тело элемента
Возвращает:Объявляется переменная, или нет.
Все классы и интерфейсы 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()Тело элемента
Возвращает:Атрибут, чьё значение определяет имя переменной.
Все классы и интерфейсы Java Server Pages
public java.lang.String getNameGiven()Тело элемента
Возвращает:Константу-имя переменной.
Все классы и интерфейсы 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?Возвращает:контекст страницыСм. также:
Все классы и интерфейсы Java Server Pages
public getParent()Получает родителя (ближайший содержащий обработчик тэга) данного обработчика тэга.
Метод getParent() может использоваться для навигации по структуре вложенного обработчика тэга на этапе прогона для кооперации нескольких акций; например, метод findAncestorWithClass() в TagSupport предоставляет удобный способ выполнения этого.
Текущая версия спецификации предоставляет только один формальный способ обозначения рассматриваемого типа обработчика тэга: класс реализации обработчика тэга, описанный в субэлементе tag-class элемента tag. Он расширяется в неформальной манере, давая автору библиотеки тэгов возможность указывать в субэлементе description рассматриваемый тип. Тип должен быть подтипом класса реализации обработчика тэга или void. Это дополнительное ограничение может быть обработано специализированным контейнером, который знает о об этой конкретной библиотеке тэгов, как в случае со стандартной библиотекой тэгов JSP.
public getParent()
Экземпляр Tag'а, ближайший содержащий данный экземпляр тэга.
См. также:
Все классы и интерфейсы Java Server Pages
public java.lang.String getPrefixString()Префикс назначенный этой taglib.
Все классы и интерфейсы Java Server Pages
public getPreviousOut()Получить окружающий out JspWriter.
Возвращает:содержащий JspWriter из bodyContent'а.
| Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: | |
Все классы и интерфейсы Java Server Pages
public abstract java.io.Reader getReader()Возвращает значение данного BodyContent'а как Reader.
Возвращает:значение данного BodyContent'а как Reader.
Все классы и интерфейсы Java Server Pages
public java.lang.String getReliableURN()"Надёжное" URN, указанное в TLD. Может использоваться утилитами авторизации в качестве глобального идентификатора (атрибут uri) при создании директивы include для данной библиотеки.
Все классы и интерфейсы Java Server Pages
public abstract int getRemaining()Этот метод возвращает количество неиспользуемых байтов в буфере.
Возвращает:количество неиспользуемых байтов в буфере.
Все классы и интерфейсы Java Server Pages
public abstract javax.servlet.ServletRequest getRequest()Текущее значение объекта request (ServletRequest).
Возвращает:ServletRequest для данного PageContext'а.
Все классы и интерфейсы Java Server Pages
public java.lang.String getRequiredVersion()Строка, описывающая требуемую версию JSP-контейнера.
Все классы и интерфейсы Java Server Pages
public abstract javax.servlet.ServletResponse getResponse()Текущее значение объекта response (ServletResponse).
Возвращает:ServletResponse для данного PageContext'а.
Все классы и интерфейсы Java Server Pages
public java.lang.Throwable getRootCause()Возвращает исключение, вызвавшее данное JSP-исключение.
Возвращает: Throwable, вызвавшее данное JSP-исключение.
| Класс |
ПРЕДЫДУЩИЙ КЛАСС
ФРЭЙМЫ
БЕЗ ФРЭЙМОВ
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | |
ДЕТАЛИ: ПОЛЕ | |
Все классы и интерфейсы Java Server Pages
public int getScope()Тело элемента
Возвращает:Область видимости, даваемая переменной.
| Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | |
ДЕТАЛИ: ПОЛЕ | |
public int getScope()
| Класс |
СЛЕДУЮЩИЙ КЛАСС
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: | |
Все классы и интерфейсы Java Server Pages
public abstract javax.servlet.ServletConfig getServletConfig()Экземпляр ServletConfig'а.
Возвращает:ServletConfig для данного PageContext'а.
Все классы и интерфейсы Java Server Pages
public abstract javax.servlet.ServletContext getServletContext()Экземпляр ServletContext'а.
Возвращает:ServletContext для данного PageContext'а.
Все классы и интерфейсы Java Server Pages
public abstract javax.servlet.http.HttpSession getSession()Текущее значение объекта session (HttpSession).
Возвращает:HttpSession для данного PageContext'а или null.
Все классы и интерфейсы Java Server Pages
public java.lang.String getShortName()Предпочтительное краткое имя (prefix), как указано в TLD. Может использоваться утилитами авторизации в качестве предпочтительного префикса при создании директивы include для данной библиотеки.
Все классы и интерфейсы Java Server Pages
public java.lang.String getSmallIcon()Получает путь к маленькой иконке.
Возвращает:путь к маленькой иконке, отображаемой утилитами.
Все классы и интерфейсы Java Server Pages
public abstract java.lang.String getSpecificationVersion()Возвращает номер версии спецификации JSP, которая поддерживается данной JSP-машиной.
Спецификация номера версии состоит из положительных десятичных целых чисел, разделённых точками ".", например, "2.0" или "1.2.3.4.5.6.7". Это позволяет использовать расширяемый номер для обозначения major, minor, micro и др. версий. Номер версии обязан начинаться с цифры.
Возвращает:версию спецификации, null возвращается, если версия не известна.
| Класс |
ПРЕДЫДУЩИЙ КЛАСС
ФРЭЙМЫ БЕЗ ФРЭЙМОВ
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | |
ДЕТАЛИ: ПОЛЯ | |
Все классы и интерфейсы Java Server Pages
public abstract java.lang.String getString()Возвращает значение данного BodyContent'а как String.
Возвращает:значение данного BodyContent'а как String.
Все классы и интерфейсы Java Server Pages
public getTag(java.lang.String shortname)Получает TagInfo для данного имени тэга, просматривая все тэги данной библиотеки тэгов.
Параметры:shortname - краткое имя (не prefix/префикс) тэга.
| Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: | |
Все классы и интерфейсы Java Server Pages
public java.lang.String getTagClassName()Имя класса, предоставляющего обработчик для данного тэга.
Возвращает:имя класса обработчика тэга.
Все классы и интерфейсы Java Server Pages
public getTagExtraInfo()Экземпляр (если имеется) для дополнительной информации тэга.
Возвращает:экземпляр TagExtraInfo, если имеется.
Все классы и интерфейсы Java Server Pages
public final getTagInfo()Получает TagInfo для данного класса.
Возвращает:TagInfo, которого расширяет данный экземпляр.
| Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | |
ДЕТАЛИ: ПОЛЕ | |
Все классы и интерфейсы Java Server Pages
public getTagLibrary()Экземпляр TabLibraryInfo, к которому мы (?) принадлежим.
Возвращает:экземпляр библиотеки тэгов, к которому мы принадлежим.
Все классы и интерфейсы Java Server Pages
public java.lang.String getTagName()Имя Tag'а.
Возвращает:имя (краткое) тэга.
Все классы и интерфейсы Java Server Pages
public [] getTags()Массив, описывающий тэги, определённые данной библиотекой тэгов.
Все классы и интерфейсы Java Server Pages
public [] getTagVariableInfos()Получает TagVariableInfo-объекты, ассоциированные с данным TagInfo.
Возвращает:TagVariableInfo-объекты, ассоциированные с данным TagInfo.
Все классы и интерфейсы Java Server Pages
public java.lang.String getTypeName()Тип (как String) данного атрибута.
Возвращает:тип атрибута.
Все классы и интерфейсы Java Server Pages
public java.lang.String getURI()Значение атрибута uri.
Все классы и интерфейсы Java Server Pages
public java.lang.Object getValue(java.lang.Stringk)Получает значение, ассоциированное с ключом.
Параметры:k - строка-ключ.
Все классы и интерфейсы Java Server Pages
public java.util.Enumeration getValues()Перечисляет значения, хранимые данным обработчиком тэга.
| Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: | |
Все классы и интерфейсы Java Server Pages
public [] getVariableInfo(data)Получает информацию о переменных скриптинга, определённых тэгом, ассоциированным с данным экземпляром TagExtraInfo. Атрибуты времени запроса обозначены как таковые в параметре TagData.
Параметры:data - TagData-экземпляр.
Возвращает:Массив VariableInfo-данных.
public [] getVariableInfo(data)
Информация об объектах скриптинга, созданных данным тэгом на этапе прогона.
Это удобный метод ассоциированного TagExtraInfo-класса.
По умолчанию null, если тэг не имеет атрибута "id", иначе - {"id", Object}
Параметры:data - TagData, описывающий данную акцию .
Возвращает:Массив VariableInfo-элементов.
HandlePageException
public abstract void handlePageException(java.lang.Exceptione) throws javax.servlet.ServletException, java.io.IOExceptionЭтот метод предназначен для процессинга/обработки необработанного исключения уровня "page" путём перенаправления исключения специфицированной для данной JSP странице ошибок или, если ничего не было специфицировано, для выполнения какой-либо специфицированной реализацией акции.
Класс реализации JSP обычно должен будет зачистить локальный статус до вызова этого метода и сразу после этого возвратить управление. Недопустимой является генерация вывода клиенту или модификация статуса ServletResponse'а после вызова этого метода.
Этот метод сохранён для обеспечения обратной совместимости. Вновь генерируемый код должен использовать PageContext.handlePageException(Throwable).
Параметры:e - обрабатываемое исключение.
Вызывает:javax.servlet.ServletExceptionjava.io.IOExceptionNullPointerException - если exception - null.java.lang.SecurityException - если целевой ресурс не может быть достигнут взывающим.
См. также:
public abstract void handlePageException(java.lang.Throwable t) throws javax.servlet.ServletException, java.io.IOException
Этот метод идентичен методу handlePageException(Exception), за исключением того, что он принимает Throwable. Это предпочтительный метод для использования, так как он позволяет создавать соответствующую реализацию семантики errorpage.
Этот метод предназначен для процессинга/обработки необработанного исключения уровня "page" путём перенаправления исключения специфицированной для данной JSP странице ошибок или, если ничего не было специфицировано, для выполнения какой-либо специфицированной реализацией акции.
Класс реализации JSP обычно должен будет зачистить локальный статус до вызова этого метода и сразу после этого возвратить управление. Недопустимой является генерация вывода клиенту или модификация статуса ServletResponse'а после вызова этого метод.
Параметры:t - обрабатываемый throwable.
Вызывает:javax.servlet.ServletExceptionjava.io.IOExceptionNullPointerException - если exception - null.java.lang.SecurityException - если целевой ресурс не может быть достигнут взывающим.
См. также:
ID
public static final java.lang.String ID"id" привязывается как ID. Нет никакого реального преимущества при использовании его как-нибудь ещё, так как IDREFs не обрабатываются иначе.
| Конструктор. Детали. |
Иерархия Интерфейсов
| Класс | Дерево |
НАЗАД
Иерархия Интерфесов
| Класс | Дерево |
ВПЕРЁД
Иерархия Классов
Include
public abstract void include(java.lang.String relativeUrlPath) throws javax.servlet.ServletException, java.io.IOExceptionВызывает обработку специфицированного ресурса как части текущих ServletRequest и ServletResponse, обрабатываемых вызывающим Thread. Вывод обрабатываемых запросом целевых ресурсов записывается непосредственно в поток вывода ServletResponse'а.
Текущий "out" JspWriter'а для данной JSP очищается, в качестве побочного эффекта этого вызова, до обработки include.
Если relativeUrlPath начинается с "/", специфицированный URL вычисляется относительно DOCROOT ServletContext'а
для данной JSP.
Если путь не начинается с "/", специфицированный URL вычисляется относительно URL запроса, который был отображён в вызывающую JSP.
Верным является только вызов этого метода из Thread, выполняющегося внутри метода _jspService(...) в JSP.
Параметры:relativeUrlPath - специфицирует относительный путь URL к включаемому целевому ресурсу.
Вызывает:javax.servlet.ServletExceptionjava.io.IOExceptionjava.lang.IllegalArgumentException - если URL целевого ресурса неразрешим.java.lang.SecurityException - если целевой ресурс не может быть достигнут взывающим.
Info
protected java.lang.String info| Конструктор. Детали. |
Initialize
public abstract void initialize(javax.servlet.Servletservlet, javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, java.lang.String errorPageURL, boolean needsSession, int bufferSize, boolean autoFlush) throws java.io.IOException, java.lang.IllegalStateException, java.lang.IllegalArgumentExceptionМетод initialize вызывается для инициализации неинициализированного PageContext'а так, что он (РС) может быть использован классом Реализации JSP для обслуживания входящего запроса и ответа внутри метода _jspService().
Этот метод обычно вызывается из JspFactory.getPageContext(), чтобы инициализировать статус.
Этот метод нужен для создания начального JspWriter'а и ассоциирования имени "out'а" в области видимости page с этим вновь созданным объектом.
Этот метод не должен использоваться авторами страниц или библиотек тэгов.
Параметры:servlet - Servlet, ассоциированный с данным PageContext'омrequest - текущий запрос в данном Servlet'еresponse - текущий ответ для данного Servlet'аerrorPageURL - значение атрибута errorpage из директивы page или nullneedsSession - значение атрибута session из директивы pagebufferSize - значение атрибута buffer из директивы pageautoFlush - значение атрибута autoflush из директивы pageВызывает:java.io.IOException - во время создания JspWriterjava.lang.IllegalStateException - если out некорректно инициализирован
IsAutoFlush
public boolean isAutoFlush()Этот метод указывает, очищается ли JspWriter автоматически (autoFlush).
Возвращает:очищается ли JspWriter автоматически, или вызывает исключение IOExceptions при выполнении условий переполнения буфера.
| Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: | |
IsRequired
public boolean isRequired()Необходим ли/required атрибут.
Возвращает:необходим ли атрибут.
IsValid
public boolean isValid( data)Проверка атрибутов на этапе трансляции. Атрибуты времени запроса обозначены как таковые в параметре TagData.
Параметры:data - TagData-экземпляр.
Возвращает:верен ли данный экземпляр тэга.
public boolean isValid( data)
Проверка атрибутов на этапе трансляции. Это удобный метод ассоциированного TagExtraInfo-класса.
Параметры:data - экземпляр TagData времени трансляции.Возвращает:верны ли данные.
Javax.servlet.jsp Интерфейс HttpJspPage
public abstract interface HttpJspPageextendsИнтерфейс HttpJspPage описывает взаимодействие, которое Класс Реализации JSP-Страницы обязан выполнять при использовании протокола HTTP.
Поведение идентично JspPage, за исключением подписи метода _jspService, который теперь выражается в системе типов Java и включён в интерфейс явно.
См. также:
| Метод. Резюме. | |
| void | (javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Метод _jspService() соответствует телу JSP-страницы. |
| Методы, унаследованные от интерфейса javax.servlet.jsp. |
| , |
| Методы, унаследованные от интерфейса javax.servlet.Servlet |
| destroy, getServletConfig, getServletInfo, init, service |
| Метод. Детали. |
Javax.servlet.jsp Интерфейс JspPage
Все Известный Субинтерфейсы:public abstract interface JspPageextends javax.servlet.Servlet
Интерфейс JspPage описывает общее взаимодействие, которое класс Реализации JSP-Страницы обязан выполнять; страницы, использующие протокол HTTP, описаны интерфейсом HttpJspPage.
Методы Два плюс Один/Two plus One
Этот интерфейс определяет протокол с 3 методами; только два из них: jspInit() и jspDestroy() являются частью данного интерфейса, так как подпись/signature третьего метода: _jspService() зависит от специфики используемого протокола и не может быть выражена общим способом в Java.
Класс, реализующий этот интерфейс, отвечает за вызов вышеуказанных методов в подходящее время на базе вызовов соответствующих Servlet-базирующихся методов.
Методы jspInit() и jspDestroy() могут определяться автором JSP, но метод _jspService() определяется автоматически JSP-процессором на базе содержимого JSP-страницы.
_jspService()
Метод _jspService() соответствует телу/body JSP-страницы. Этот метод определяется автоматически JSP-контейнером и никогда не должен определяться автором JSP.
Если суперкласс специфицируется с использованием атрибута extends, этот суперкласс может избрать выполнение некоторых акций в методе service() до или после вызова метода _jspService().
См. использование атрибута extends в главе JSP_Машина спецификации JSP.
Специфика подписи/signature зависит от протокола, поддерживаемого JSP-страницей.
public void _jspService(ServletRequestSubtype request, ServletResponseSubtype response) throws ServletException, IOException;
| Метод. Резюме. | |
| void | () Метод jspDestroy() вызывается при уничтожении JSP-страницы. |
| void | () Метод jspInit() вызывается при инициализации JSP-страницы. |
| Методы, унаследованные от интерфейса javax.servlet.Servlet |
| destroy, getServletConfig, getServletInfo, init, service |
| Метод. Детали. |
Javax.servlet.jsp Класс JspEngineInfo
java.lang.Object | +--javax.servlet.jsp.JspEngineInfopublic abstract class JspEngineInfoextends java.lang.Object
JspEngineInfo это абстрактный класс, предоставляющий информацию о текущей JSP-машине.
| Конструктор. Резюме. | |
| () |
| Метод.Резюме. | |
| abstract java.lang.String | () Возвращает номер версии спецификации JSP, которая поддерживается данной JSP-машиной. |
| Методы, унаследованные от класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp Класс JspException
java.lang.Object | +--java.lang.Throwable | +--java.lang.Exception | +--javax.servlet.jsp.JspExceptionПрямые Известные Подклассы:
public class JspExceptionextends java.lang.Exception
Общее исключение, известное JSP-машине; неотловленное JspExceptions приводит к вызову механизма errorpage.
См. также:
| Конструктор. Резюме. |
| () Конструирует JspException. |
| (java.lang.String msg) Конструирует новое JSP-исключение со специфицированным сообщением. |
| (java.lang.String message, java.lang.Throwable rootCause) Конструирует новое JSP-исключение, когда JSP нужно вызывать исключение, и включает сообщение об "основной причине" исключения, которая конфликтует с нормальным ходом процесса, включая сообщение описания. |
| (java.lang.Throwable rootCause) Конструирует новое JSP-исключение, когда JSP нужно вызывать исключение, и включает сообщение об "основной причине" исключения, которая конфликтует с нормальным ходом процесса. |
| Метод. Резюме. | |
| java.lang.Throwable | () Возвращает исключение, вызвавшее это JSP-исключение. |
| Методы, унаследованные от класса java.lang.Throwable |
| fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString |
| Методы, унаследованные от класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp Класс JspFactory
java.lang.Object | +--javax.servlet.jsp.JspFactorypublic abstract class JspFactoryextends java.lang.Object
JspFactory это абстрактный класс, определяющий несколько "фабричных"/factory методов, доступных JSP-странице на этапе прогона, для создания экземпляров различных интерфейсов и классов, используемых для поддержки реализации JSP.
Соответствующая требованиям реализация JSP-Машины будет в процессе своей инициализации инстанциировать зависящий от реализации подкласс этого класса и сделает его глобально доступным для использования классами реализации JSP посредством регистрации экземпляра, созданного данным классом с помощью static-метода setDefaultFactory().
Классы PageContext и JspEngineInfo являются единственными зависящими от реализации классами, которые могут создаваться только в фактории.
Объекты JspFactory не должны использоваться авторами JSP-страниц.
| Конструктор. Резюме. | |
| () |
| Метод. Резюме. | |
| static | () |
| abstract | () вызывается для получения специфической для данной реализации информации о текущей JSP-машине. |
| abstract | (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 | ( pc) вызывается для освобождения ранее размещённого объекта PageContext. |
| static void | ( deflt) установить факторию по умолчанию для данной реализации. |
| Методы, унаследованные от класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp Класс JspTagException
java.lang.Object | +--java.lang.Throwable | +--java.lang.Exception | +-- | +--javax.servlet.jsp.JspTagExceptionpublic class JspTagExceptionextends
Исключение, используемое Обработчиком Тэга для указания на непреодолимую ошибку. Эта ошибка отлавливается на верхнем уровне JSP-страницы и выводит страницу об ошибках.
См. также:
| Конструктор. Резюме. |
| () Нет сообщения. |
| (java.lang.String msg) Конструктор с сообщением.. |
| Методы, унаследованные от класса javax.servlet.jsp. |
| Методы, унаследованные от класса java.lang.Throwable |
| fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString |
| Методы, унаследованные от класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp Класс JspWriter
java.lang.Object | +--java.io.Writer | +--javax.servlet.jsp.JspWriterПрямые Известные Подклассы:
public abstract class JspWriterextends java.io.Writer
Акции и шаблонные данные на JSP-странице записываются с использованием JspWriter-объекта, на который ссылаются через неявную переменную out, инициализируемую автоматически, через использование методов в PageContext-объекте.
Этот абстрактный класс эмулирует некоторую функциональность классов java.io.BufferedWriter и java.io.PrintWriter, однако отличие в том, что он взывает java.io.IOException из методов print, в то время как PrintWriter этого не делает.
Буферизация
Начальный/initial JspWriter-объект ассоциируется с PrintWriter-объектом ServletResponse'а способом, зависящим от того, буферизуется страница или нет. Если страница буферизуется, вывод, записываемый в этот JspWriter-объект, будет записываться непосредственно через PrintWriter, который, если необходимо, будет создаваться путём вызова метода getWriter() в объекте response. Но если страница буферизуется, PrintWriter-объект не будет создаваться, пока буфер не очистится и операции типа setContentType() являются законными. Поскольку такая гибкость значительно упрощает программирование, буферизация в JSP-страницах выполняется по умолчанию.
Буферизация затрагивает вопрос: что делать, если буфер заполнен?
Есть два подхода к решению этой проблемы:
Переполнение буфера не является фатальной ошибкой; если буфер заполнен, вывод просто очищается.
Переполнение буфера является фатальной ошибкой; если буфер заполнен, вызывается исключение.
Оба подхода являются верными, и, соответственно, оба поддерживаются JSP-технологией. Поведение страницы контролируется атрибутом autoFlush, который по умолчанию - true. В общем, JSP-страницы, которым необходима гарантия корректности и полноты данных, высылаемых клиенту, могут установить атрибут autoFlush в false, что обычно делается в случае, если клиентом является само приложение. С другой стороны, JSP-страницы, отсылающие данные клиенту, могут даже после частичного конструирования установить атрибут autoFlush в true; что делается тогда, когда данные сразу выводятся через браузер. Каждое приложение действует в соответствии со своими потребностями.
Альтернативным было снятие ограничений на размер буфера; но это имело тот недостаток, что вычисления на этапе прогона могли поглотить неограниченное количество ресурсов ОС.
Неявная переменная "out" класса реализации JSP имеет этот тип. Если директива page избирает autoflush="true", тогда все операции I/O (ввода-вывода) этого класса автоматически очищают содержимое буфера, если условие overflow/переполнение могло бы возникнуть при выполнении текущей операции без очистки. Если autoflush="false", тогда все операции I/O (ввода-вывода) этого класса будут вызывать исключение IOException, если при выполнении текущей операции приводит к условию overflow/переполнения буфера.
См. также:Writer, java.io.BufferedWriter, PrintWriter
| Поле. Резюме. | |
| protected boolean | |
| protected int | |
| static int | константа, указывающая, что Writer буферизуется и использует размер буфера по умолчанию для данной реализации. |
| static int | константа, указывающая, что Writer не буферизует вывод. |
| static int | константа, указывающая, что Writer буферизуется и размер буфера не ограничен; это используется в BodyContent. |
| Поля, унаследованные от класса java.io.Writer |
| lock |
| Конструктор. Резюме. | |
| protected | (int bufferSize, boolean autoFlush) protected-конструктор. |
| Метод. Резюме. | |
| abstract void | () Очищает содержимое буфера. |
| abstract void | () Очищает текущее содержимое буфера. |
| abstract void | () Закрывает поток, предварительно очистив его. Этот метод не должен вызываться явно для начального/initial JspWriter'а, так как код, генерируемый JSP-контейнером, будет автоматически включать вызов close(). |
| abstract void | () Очищает поток. |
| int | () Этот метод возвращает размер буфера, используемого JspWriter'ом. |
| abstract int | () Этот метод возвращает количество неиспользуемых байтов буфера. |
| boolean | () Этот метод указывает, очищается ли JspWriter автоматически. |
| abstract void | () Записывает символы новой строки. |
| abstract void | (boolean b) Печатает булево значение. |
| abstract void | (char c) Печатает символ. |
| abstract void | (char[] s) Печатает массив символов. |
| abstract void | (double d) Печатает число с плавающей точкой двойной точности. |
| abstract void | (float f) Печатает число с плавающей точкой. |
| abstract void | (int i) Печатает целое число. |
| abstract void | (long l) Печатает длинное целое число. |
| abstract void | (java.lang.Object obj) Печатает объект. |
| abstract void | (java.lang.String s) Печатает строку. |
| abstract void | () Заканчивает текущую строку печатью символов новой строки. |
| abstract void | (boolean x) Печатает булево значение и затем оканчивает строку. |
| abstract void | (char x) Печатает символ и затем оканчивает строку. |
| abstract void | (char[] x) Печатает массив символов и затем оканчивает строку. |
| abstract void | (double x) Печатает число с плавающей точкой двойной точности и затем оканчивает строку. |
| abstract void | (float x) Печатает число с плавающей точкой и затем оканчивает строку. |
| abstract void | (int x) Печатает целое число и затем оканчивает строку. |
| abstract void | (long x) Печатает длинное целое число и затем оканчивает строку. |
| abstract void | (java.lang.Object x) Печатает Object и затем оканчивает строку. |
| abstract void | (java.lang.String x) Печатает String и затем оканчивает строку. |
| Методы, унаследованные от класса java.io.Writer |
| write, write, write, write, write |
| Методы, унаследованные от класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Поле. Детали. |
Javax.servlet.jsp Класс PageContext
java.lang.Object | +--javax.servlet.jsp.PageContextpublic abstract class PageContextextends java.lang.Object
Экземпляр класса PageContext предоставляет доступ ко всем пространствам имён, ассоциированным с JSP-страницей, к различным атрибутам страницы, а также слой поверх деталей реализации.
Неявные объекты добавляются к pageContext автоматически.
Класс PageContext это абстрактный класс, разработанный с возможностью последующего расширения для предоставления реализаций, в зависимости от свойств самих же реализаций, в среде соответствующих JSP-машин. Экземпляр PageContext получается классом реализации JSP через вызов метода JspFactory.getPageContext(), и освобождается через вызов метода JspFactory.releasePageContext().
Примеры использования PageContext, JspFactory и других классов в объекте Реализации JSP-Страницы можно найти повсюду.
PageContext имеет особенности, упрощающие работу авторов страниц/компонентов и реализаторов страниц, в том числе:
несколько удобных API для доступа к различным public-объектам;
Методы, Предназначенные для Кода, Генерируемого Контейнером
Некоторые методы предназначены для использования кодом , генерируемым контейнером, а не кодом, написанным авторами 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 |
| Поле. Детали. |
Javax.servlet.jsp.tagext Интерфейс BodyTag
Все Известные Реализующие Классы:public abstract interface BodyTagextends
Интерфейс BodyTag расширяет IterationTag путём определения дополнительных методов, которые дают обработчику тэга возможность манипулировать содержимым, вычисляя его тело.
Обработчик тэга отвечает за манипуляции с содержимым тела. Например, обработчик тэга может взять содержимое тела, конвертировать его в String с помощью метода bodyContent.getString и затем использовать его (содержимое). Ил обработчик тэга может взять содержимое тела и записать его в содержащий JspWriter, используя метод bodyContent.writeOut.
Обработчик тэга, реализующий BodyTag, рассматривается как обработчик, реализующий IterationTag, за исключением того, что метод doStartTag может возвратить SKIP_BODY, EVAL_BODY_INCLUDE или EVAL_BODY_BUFFERED.
Если возвращено EVAL_BODY_INCLUDE, вычисление происходит, как в IterationTag.
Если возвращено EVAL_BODY_BUFFERED, будет создан BodyContent-объект (кодом, сгенерированным JSP-компилятором) для захвата вычисления тела. Код, сгенерированный JSP-компилятором, получает BodyContent-объект с помощью вызова метода pushBody текущего pageContext'а, который дополнительно сохраняет предыдущее значение out. Компилятор страницы возвращает этот объект через вызов метода popBody класса PageContext; этот вызов также восстанавливает значение out.
Этот интерфейс предоставляет одно новое свойство с setter-методом один новый метод акции.
Свойства
Имеется новое свойство, bodyContent, для получения BodyContent-объекта, в котором объект реализации JSP-страницы будет размещать результат вычисления (и повторного вычисления, если нужно) тела. Setter-метод (setBodyContent) будет вызываться только в том случае, если doStartTag() возвращает EVAL_BODY_BUFFERED.
Методы
В дополнение к setter-методу для свойства bodyContent имеется новый метод акции: doInitBody(), который вызывается сразу после setBodyContent() и перед вычислением тела. Этот метод будет вызываться только в том случае, если doStartTag() возвращает EVAL_BODY_BUFFERED.
Жизненный цикл
Детали жизненного цикла показаны на диаграмме переноса. Исключения, вызываемые при вычислении doStartTag(), setBodyContent(), doInitBody(), BODY, doAfterBody(), прерывают выполнение и помещаются на верх стэка, если только обработчик тэга не реализует интерфейс TryCatchFinally; см. детали об этом интерфейсе.

Пустая и Непустая Акция
Если TagLibraryDescriptor-файл указывает, что акция обязана всегда иметь пустую акцию, через вхождение
В ином случае, метод doStartTag() может возвратить SKIP_BODY, EVAL_BODY_INCLUDE или EVAL_BODY_BUFFERED.
Если возвращено SKIP_BODY, тело не вычисляется и вызывается doEndTag().
Если возвращено EVAL_BODY_INCLUDE, setBodyContent() не вызывается, doInitBody() не вызывается, тело вычисляется и "передаётся/passed through" текущему out, doAfterBody() вызывается, а затем, после 0 или более итераций, вызывается doEndTag().
Если возвращено EVAL_BODY_BUFFERED, вызывается setBodyContent(), вызывается doInitBody(), тело вычисляется, вызывается doAfterBody(), а затем, после 0 или более итераций, вызывается doEndTag().
| Поле. Резюме. | |
| staticint | Запрашивается создание нового буфера, BodyContent, в котором вычисляется тело этого тэга. |
| static int | Не рекомендуется. Как и в Java JSP API 1.2, использовать BodyTag.EVAL_BODY_BUFFERED или IterationTag.EVAL_BODY_AGAIN. |
| Поля, унаследованные из класса javax.servlet.jsp.tagext. |
| Поля, унаследованные из класса javax.servlet.jsp.tagext. |
| , , , |
| Метод. Резюме. | |
| void | () Подготавливает вычисление тела. |
| void | ( b) Устанавливает свойство bodyContent. |
| Методы, унаследованные из интерфейса javax.servlet.jsp.tagext. |
| Методы, унаследованные из интерфейса javax.servlet.jsp.tagext. |
| , , , , , |
| Поле. Детали. |
Javax.servlet.jsp.tagext Интерфейс IterationTag
Все Известные Субинтерейсы:Все Известные Реализующие Классы:
public abstract interface IterationTagextends
Интерфейс IterationTag расширяет Tag, определяя один дополнительный метод, управляющий повторяющимися вычислениями тела.
Обработчик тэга, реализующий IterationTag, рассматривается как обработчик, реализующий Tag, с учётом методов doStartTag() и doEndTag(). IterationTag предоставляет новый метод: doAfterBody().
Метод doAfterBody() вызывается после каждого обсчёта тела для управления повторными вычислениями тела. Если doAfterBody() возвращает IterationTag.EVAL_BODY_AGAIN, то тело будет вычисляться ещё раз.
Если doAfterBody() возвращает Tag.SKIP_BODY, тело будет пропущено, и вместо этого будет вычислен doEndTag().
Свойства
Нет новых свойств, дополняющих свойства Tag'а.
Методы
Есть один новый метод: doAfterBody().
Жизненный цикл
Детали жизненного цикла показаны на диаграмме. Исключения, вызываемые в процессе вычисления doStartTag(), BODY и doAfterBody() прерывают выполнение и помещаются на верх стэка, если только обработчик тэга не реализует интерфейс TryCatchFinally; см. детали об этом интерфейсе.

Пустая и Непустая Акция
Если TagLibraryDescriptor-файл указывает, что акция всегда обязана иметь пустую акцию, через вхождение
Иначе, метод doStartTag() может возвратить SKIP_BODY или EVAL_BODY_INCLUDE.
Если возвращено SKIP_BODY, тело не вычисляется и вызывается doEndTag().
Если возвращено EVAL_BODY_INCLUDE, тело вычисляется и "передаётся" текущему out, затем вызывается doAfterBody() и, после 0 или более итераций, вызывается doEndTag().
| Поле. Резюме. | |
| staticint | Запрос на вычисление тела. |
| Поля, унаследованные из класса javax.servlet.jsp.tagext. |
| , , , |
| Метод. Резюме. | |
| int | () Производит (повторное) вычисление тела. |
| Методы, унаследованные из интерфейса javax.servlet.jsp.tagext. |
| , , , , , |
| Поле. Детали. |
Javax.servlet.jsp.tagext Интерфейс Tag
Все Известные Субинтерфейсы:,public abstract interface Tag
Интерфейс простого обработчика тэга, который не манипулирует своим телом. Интерфейс Tag определяет базовый протокол между обработчиком Tag'а и классом реализации JSP-страницы. Определяет жизненный цикл и методы, вызываемые в начальном.
Свойства
Интерфейс Tag специфицирует setter- и getter-методы для основных свойств pageContext и parent.
Объект реализации JSP-страницы вызывает setPageContext и setParent, в указанной последовательности, до вызова doStartTag() или doEndTag().
Методы
Выполняются два главных действия: doStartTag и doEndTag. После того как соответствующие свойства инициализированы, методы doStartTag и doEndTag могут быть вызваны в обработчике тэга. Принимается, что между этими вызовами обработчик тэга поддерживает статус, который обязан быть сохранён.
После вызова doEndTag обработчик тэга доступен для последующих вызовов (и предполагается, что он сохраняет свои свойства).
Жизненный цикл
Детали жизненного цикла представлены на диаграмме, со следующими комментариями:

После того как выполнены все вызовы обработчика тэга, в нём вызывается метод release.
После того как метод release вызван, принимается, что все свойства, включая parent и pageContext, восстановлены в неспецифицированные значения. Компилятор страницы гарантирует, что release() будет вызван в обработчике Tag'а до освобождения обработчика в GC.
Пустая и Непустая Акция
Если TagLibraryDescriptor- файл указывает, что акция должна всегда иметь пустую акцию, посредством вхождения
Иначе, метод doStartTag() может возвратить SKIP_BODY или EVAL_BODY_INCLUDE.
Если возвращено SKIP_BODY, тело, если имеется, не обсчитывается.
Если возвращено EVAL_BODY_INCLUDE, тело обсчитывается и "передаётся" текущему out.
| Поле. Резюме. | |
| staticint | Вычисляет тело в существующем потоке out. |
| static int | Продолжить обсчёт страницы. |
| static int | Пропустить вычисление тела. |
| static int | Пропустить остаток страницы. |
| Метод. Резюме. | |
| int | () Обработать конечный тэг данного экземпляра. |
| int | () Обработать начальный тэг данного экземпляра. |
| () Получить родителя (ближайший содержащий обработчик тэга) данного обработчика тэга. |
|
| void | () Вызывается в обработчике Tag'а для освобождения состояния. |
| void | ( pc) Устанавливает текущий контекст страницы. |
| void | ( t) Устанавливает родителя (ближайший содержащий обработчик тэга) данного обработчика тэга. |
| Поле. Детали. |
Javax.servlet.jsp.tagext Интерфейс TryCatchFinally
public abstract interface TryCatchFinallyВспомогательный интерфейс для обработчиков тэгов с интерфейсом Tag, IterationTag или BodyTag, которым нужны дополнительные возможности для обслуживания ресурсов.
Этот интерфейс предоставляет два новых метода: doCatch(Throwable) и doFinally().
Прототип вызова таков:
h = get a Tag(); // получить обработчик тэга, возможно, из пула
h.setPageContext(pc); // инициализировать, как нужно h.setParent(null); h.setFoo("foo");
// протокол вызова тэга; см. Tag.java try { doStartTag()... .... doEndTag()... } catch (Throwable t) { // реакция на исключительное условие h.doCatch(t); } finally { // восстановление инвариантов данных и освобождение вызванных ресурсов h.doFinally(); }
... другие вызовы, возможно, с новыми setter'ами ... h.release(); // освобождение ресурсов длительного пользования
| Метод. Резюме. | |
| void | (java.lang.Throwable t) Вызывается. если возникает Throwable в процессе обсчёта BODY внутри тэга или в любом из следующих методов: Tag.doStartTag(), Tag.doEndTag(), IterationTag.doAfterBody() и BodyTag.doInitBody(). |
| void | () Всегда вызывается после doEndTag() для любого класса, реализующего Tag, IterationTag или BodyTag. |
| Метод. Детали. |
Javax.servlet.jsp.tagext Класс BodyContent
java.lang.Object | +--java.io.Writer | +-- | +--javax.servlet.jsp.tagext.BodyContentpublic abstract class BodyContentextends
Инкапсуляция обсчёта тела акции так, что она (акция) становится доступной для обработчика тэга. BodyContent является подклассом JspWriter'а.
Обратите внимание, что содержимое BodyContent'а является результатом вычисления, поэтому будет содержать не акции или что-либо подобное, а результат их вызовов.
BodyContent имеет методы для конвертации своего содержимого в String, чтобы читать его содержимое, и для зачистки содержимого.
Размер буфера BodyContent-объекта не ограничен. BodyContent-объект не может находиться в режиме autoFlush. невозможно вызвать flush в BodyContent-объекте, так как отсутствует фоновый/backing поток.
Экземпляры BodyContent'а создаются путём вызова методов pushBody и popBody класса PageContext. BodyContent содержится внутри другого JspWriter (может быть, другого BodyContent-объекта), следующего в структуре их ассоциированных акций.
BodyContent становится доступным BodyTag'у через вызов setBodyContent(). Обработчик тэга может использовать этот объект/object до момента после вызова doEndTag().
| Поля, унаследованные из класса javax.servlet.jsp. |
| , , , , |
| Поля, унаследованные из класса java.io.Writer |
| lock |
| Конструктор. Резюме. | |
| protected | ( e) Protected-конструктор. |
| Метод. Резюме. | |
| void | () Зачищает тело/body без вызова исключений. |
| void | () Переопределил flush(), поэтому это недопустимо. |
| () Получает содержащий JspWriter. |
|
| abstract java.io.Reader | () Возвращает значение данного BodyContent'а как Reader. |
| abstract java.lang.String | () Возвращает значение BodyContent'а как String. |
| abstract void | (java.io.Writer out) Записывает содержимое данного BodyContent'а в Writer. |
| Методы, унаследованные из класса javax.servlet.jsp. |
| , , , , , , , , , , , , , , , , , , , , , , , , , |
| Методы, унаследованные из класса java.io.Writer |
| write, write, write, write, write |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp.tagext Класс BodyTagSupport
java.lang.Object | +-- | +--javax.servlet.jsp.tagext.BodyTagSupportpublic class BodyTagSupportextends implements
Базовый класс для определения обработчиков тэгов, реализующих BodyTag.
Класс BodyTagSupport реализует интерфейс BodyTag и добавляет несколько удобных методов, включая getter-методы для свойства bodyContent и методы для получения предыдущего out JspWriter.
Многие обработчики тэгов расширяют BodyTagSupport и лишь переопределяют несколько методы.
См. также:
| Поле. Резюме. | |
| protected |
| Поля, унаследованные из класса javax.servlet.jsp.tagext. |
| , |
| Конструктор. Резюме. |
| () Конструктор по умолчанию, все подклассы должны только определить public-конструктор с той же подписью и вызвать конструктор суперкласса. |
| Метод. Резюме. | |
| int | () После обсчёта тела: повторно не вычислять и продолжать обсчёт страницы. |
| int | () Процессинг по умолчанию конечного тэга, возвращающего EVAL_PAGE. |
| void | () Подготавливает к вычислению тела сразу перед первым вычислением тела: нет акции. |
| int | () Процессинг по умолчанию начального тэга, возвращающего EVAL_BODY_BUFFERED. |
| () Получить текущий bodyContent. |
|
| () Получить окружающий (содержащий) out JspWriter. |
|
| void | () Освободить статус. |
| void | ( b) Подготавливает к вычислению тела: берёт bodyContent. |
| Методы, унаследованные из класса javax.servlet.jsp.tagext. |
| , , , , , , , , , |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Поле. Детали. |
Javax.servlet.jsp.tagext Класс PageData
java.lang.Object | +--javax.servlet.jsp.tagext.PageDatapublic abstract class PageDataextends java.lang.Object
Информация времени трансляции о JSP-странице. Эта информация соответствует XML-просмотру JSP-страницы.
Объекты этого типа генерируются JSP-транслятором, например, когда передаются экземпляру TagLibraryValidator'а.
| Конструктор. Резюме. | |
| () |
| Метод. Резюме. | |
| abstract java.io.InputStream | () Возвращает поток ввода в XML-просмотре JSP-страницы. |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp.tagext Класс TagAttributeInfo
java.lang.Object | +--javax.servlet.jsp.tagext.TagAttributeInfopublic class TagAttributeInfoextends java.lang.Object
Информация об атрибутах Tag'а, доступных на этапе трансляции. Этот класс инстанциируется из Tag Library Descriptor-файла (TLD).
Сюда включается только информация, необходимая для генерации кода. Другая информация, наподобие SCHEMA для проверки, находится в других местах.
| Поле. Резюме. | |
| staticjava.lang.String | "id" привязывается как ID. |
| Конструктор. Резюме. |
| (java.lang.String name, boolean required, java.lang.String type, boolean reqTime) Конструктор для TagAttributeInfo. |
| Метод. Резюме. | |
| boolean | () Может ли данный атрибут содержать значение времени запроса. |
| static | ([] a) Удобный static-метод, проходящий по массиву TagAttributeInfo-объектов в поисках "id". |
| java.lang.String | () Имя данного атрибута. |
| java.lang.String | () Тип (как String) данного атрибута. |
| boolean | () необходим ли данный атрибут. |
| java.lang.String | () |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Поле. Детали. |
Javax.servlet.jsp.tagext Класс TagData
java.lang.Object | +--javax.servlet.jsp.tagext.TagDatapublic class TagDataextends java.lang.Objectimplements java.lang.Cloneable
Информация (только времени трансляции) пары attribute/value для экземпляра тэга.
TagData используется только в качестве аргумента методов isValid и getVariableInfo в of TagExtraInfo, которые вызываются на этапе трансляции.
| Поле. Резюме. | |
| staticjava.lang.Object | Определённое значение атрибута для указания его значения в выражении времени запроса (которое ещё не доступно, поскольку экземпляры TagData используются на этапе трансляции). |
| Конструктор. Резюме. |
| (java.util.Hashtable attrs) Конструктор для TagData. |
| (java.lang.Object[][] atts) Конструктор для TagData. |
| Метод. Резюме | |
| java.lang.Object | (java.lang.String attName) Значение атрибута. |
| java.util.Enumeration | () Перечисляет атрибуты. |
| java.lang.String | (java.lang.String attName) Получает значение для данного атрибута. |
| java.lang.String | () Значение атрибута id, если доступно. |
| void | (java.lang.String attName, java.lang.Object value) Устанавливает значение атрибута. |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Поле. Детали. |
Javax.servlet.jsp.tagext Класс TagExtraInfo
java.lang.Object | +--javax.servlet.jsp.tagext.TagExtraInfopublic abstract class TagExtraInfoextends java.lang.Object
Необязательный класс/Optional, предоставляемый автором библиотеки тэгов для описания дополнительной информации времени трансляции, не указанной в TLD. Класс TagExtraInfo упоминается в Tag Library Descriptor-файле (TLD).
Этот класс может использоваться:
JSP-транчлятор отвечает за то, чтобы начальное значение, возвращаемое вызовами getTagInfo(), соответствовало TagInfo-объекту для транслируемого тэга. Если выполняется явный вызов setTagInfo(), передаваемый объект будет возвращён последующими вызовами getTagInfo().
Единственный способ повлиять на значение, возвращаемое методом getTagInfo(), - через вызовы setTagInfo(), и, таким образом, TagExtraInfo.setTagInfo() вызывается JSP-транслятором TagInfo-объектом, который соответствует транслируемому тэгу. Вызов должен происходить до любого вызова метода isValid() и до любого вызова getVariableInfo().
| Конструктор. Резюме. | |
| () |
| Метод. Резюме. | |
| () Получает TagInfo для данного класса. |
|
| [] | ( data) Получает информацию о переменных скриптинга, определённых тэгом, ассоциированным с данным экземпляром TagExtraInfo. |
| boolean | ( data) Проверка атрибутов на этапе трансляции. |
| void | ( tagInfo) Устанавливает TagInfo для данного класса. |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp.tagext Класс TagInfo
java.lang.Object | +--javax.servlet.jsp.tagext.TagInfopublic class TagInfoextends java.lang.Object
Tag-информация для тэга в Библиотеке Тэгов; Этот класс инстанциируется из Tag Library Descriptor-файла (TLD) и доступен только на этапе трансляции.
| Поле. Резюме. | |
| staticjava.lang.String | static-константа для getBodyContent(), если он пустой |
| static java.lang.String | static-константа для getBodyContent(), если он - JSP |
| static java.lang.String | static-константа для getBodyContent(), если он зависит от Tag'а |
| Конструктор. Резюме. |
| (java.lang.String tagName, java.lang.String tagClassName, java.lang.String bodycontent, java.lang.String infoString, taglib, tagExtraInfo, [] attributeInfo) Конструктор для TagInfo из данных в формате JSP 1.1 для TLD. |
| (java.lang.String tagName, java.lang.String tagClassName, java.lang.String bodycontent, java.lang.String infoString, taglib, tagExtraInfo, [] attributeInfo, java.lang.String displayName, java.lang.String smallIcon, java.lang.String largeIcon, [] tvi) Конструктор для TagInfo из данных в формате JSP 1.2 для TLD. |
| Метод. Резюме. | |
| [] | () Информация атрибута (в TLD) данного тэга. |
| java.lang.String | () Информация bodycontent для данного тэга. |
| java.lang.String | () Получает displayName |
| java.lang.String | () Строка информации для тэга. |
| java.lang.String | () Получает путь к большой иконке. |
| java.lang.String | () Получает путь к маленькой иконке. |
| java.lang.String | () Имя класса, предоставляющего обработчик для данного тэга. |
| () Экземпляр (если имеется) для дополнительной информации тэга. |
|
| () Экземпляр TabLibraryInfo, к которому принадлежим. |
|
| java.lang.String | () Имя Tag'а. |
| [] | () Получает Get TagVariableInfo-объекты, ассоциированные с данным TagInfo. |
| [] | ( data) Информация об объектах скриптинга, созданных этим тэгом на этапе прогона. |
| boolean | ( data) Проверка атрибутов на этапе трансляции. |
| void | ( tei) Устанавливает экземпляр для дополнительной информации тэга. |
| void | ( tl) Устанавливает свойство TagLibraryInfo. |
| java.lang.String | () Строго для целей отладки ... |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Поле. Детали. |
Javax.servlet.jsp.tagext Класс TagLibraryInfo
java.lang.Object | +--javax.servlet.jsp.tagext.TagLibraryInfopublic abstract class TagLibraryInfoextends java.lang.Object
Информация этапа трансляции, ассоциированная с директивой taglib, и лежащий в её основе TLD-файл.
Большая часть информации - непосредственно из TLD, за исключением значений prefix и uri, используемых в директиве taglib.
| Поле. Резюме. | |
| protected java.lang.String | |
| protected java.lang.String | |
| protected java.lang.String | |
| protected java.lang.String | |
| protected [] | |
| protected java.lang.String | |
| protected java.lang.String | |
| protected java.lang.String |
| Конструктор. Резюме. | |
| protected | (java.lang.String prefix, java.lang.String uri) Конструктор. |
| Метод. Резюме. | ||
| java.lang.String | () Информация (документация) для данного TLD. |
|
| java.lang.String | () Префикс, назначенный данной taglib. | |
| java.lang.String | () "Надёжное" URN, указанное в TLD. | |
| java.lang.String | () Строка, описывающая необходимую версию JSP-контейнера. | |
| java.lang.String | () Предпочтительное краткое имя (prefix/префикс), как указано в TLD. | |
| (java.lang.String shortname) Получает TagInfo для данного имени тэга, просматривая все тэги в данной библиотеке тэгов. | ||
| [] | () Массив, описывающий тэги, определённые данной библиотекой тэгов. | |
| java.lang.String | () Значение атрибута uri. |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Поле. Детали. |
Javax.servlet.jsp.tagext Класс TagLibraryValidator
java.lang.Object | +--javax.servlet.jsp.tagext.TagLibraryValidatorpublic abstract class TagLibraryValidatorextends java.lang.Object
Класс проверщика на этапе трансляции для JSP-страницы. проверщик оперирует XML-документом, ассоциированным с JSP-страницей.
TLD-файл ассоциирует класс TagLibraryValidator и некоторые init-аргументы с библиотекой тэгов.
JSP-контейнер отвечает за размещение соответствующего экземпляра соответствующего подкласса:
После инициализации вызывается метод validate(String, String, PageData), где первые два аргумента - это аргументы prefix и uri, используемые директивой taglib.
Экземпляр TagLibraryValidator'а может создавать вспомогательные объекты внутренне для выполнения проверки (например, проверщик XSchema) и может повторно использовать их для всех страниц в ходе данной трансляции.
JSP-контейнер не гарантирует сериализацию вызовов метода validate(), и TagLibraryValidator'ы должны выполнять необходимую синхронизацию, если потребуется.
JSP-контейнер может по выбору поддерживать атрибут jsp:id для предоставления качественной проверки ошибок. Если атрибут поддерживается, контейнер будет отслеживать JSP-страницы по мере передачи контейнеру и назначать каждому элементу уникальный "id", который передаётся как значение атрибута jsp:id. Каждый XML-элемент в имеющемся XML-просмотре будет расширен этим атрибутом.
TagLibraryValidator может затем использовать этот атрибут в одном или более объектах ValidationMessage. В свою очередь, контейнер может использовать эти значения для предоставления более точной информации о местонахождении ошибки.
| Конструктор. Резюме. | |
| () |
| Метод. Резюме. | |
| java.util.Map | () Получает данные init-параметров как неизменяемую Map/Карту. |
| void | () Освобождает любые данные, сохраняемые данным экземпляром для целей проверки. |
| void | (java.util.Map map) Устанавливает init-данные в TLD для данного проверщика. |
| [] | (java.lang.String prefix, java.lang.String uri, page) Проверяет JSP-страницу. |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp.tagext Класс TagSupport
java.lang.Object | +--javax.servlet.jsp.tagext.TagSupportПрямые Известные Подклассы:
public class TagSupportextends java.lang.Objectimplements , java.io.Serializable
Базовый класс для определения новых обработчиков тэгов, реализующих Tag.
Класс TagSupport является вспомогательным классом, предназначенным для использования в качестве базового класса для новых обработчиков тэгов.
Класс TagSupport реализует интерфейсы Tag и IterationTag и добавляет удобные методы, включая getter-методы, для свойств Tag'а. TagSupport имеет один static-метод, который включён для облегчения координации между кооперирующимися тэгами.
Многие обработчики тэгов будут расширять TagSupport и лишь переопределять некоторые методы.
См. также:
| Поле. Резюме. | |
| protected java.lang.String | |
| protected |
| Конструктор. Резюме. |
| () Конструктор по умолчанию, все подклассы должны лишь определить public-конструктор с той же подписью м вызывать конструктор суперкласса. |
| Метод. Резюме. | |
| int | () Обработка по умолчанию тела. |
| int | () Обработка по умолчанию конечного тэга, возвращающего EVAL_PAGE. |
| int | () Обработка по умолчанию начального тэга, возвращающего SKIP_BODY. |
| static | ( from, java.lang.Class klass) Находит экземпляр данного типа класса - ближайший к данному экземпляру. |
| java.lang.String | () Значение атрибута id данного тэга; или null. |
| () Экземпляр Tag'а, ближайший содержащий данный экземпляр тэга. |
|
| java.lang.Object | (java.lang.String k) Получает значение, ассоциированное с ключом. |
| java.util.Enumeration | () Перечисляет значения, хранимые данным обработчиком тэга. |
| void | () Освободить статус. |
| void | (java.lang.String k) Удалить значение, ассоциированное с ключом. |
| void | (java.lang.String id) Устанавливает атрибут id данного тэга. |
| void | ( pageContext) Устанавливает контекст страницы. |
| void | ( t) Устанавливает содержащий/nesting тэг данного тэга. |
| void | (java.lang.String k, java.lang.Object o) Ассоциирует значение со String-ключом. |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Поле. Детали. |
Javax.servlet.jsp.tagext Класс TagVariableInfo
java.lang.Object | +--javax.servlet.jsp.tagext.TagVariableInfopublic class TagVariableInfoextends java.lang.Object
Информация переменной для тэга в Библиотеке Тэгов; этот класс инстанциируется из Tag Library Descriptor-файла (TLD) и доступен только на этапе трансляции.
Этот объект должен быть неизменяемым.
Данная информация доступна только в формате JSP 1.2
| Конструктор. Резюме. |
| (java.lang.StringnameGiven, java.lang.String nameFromAttribute, java.lang.String className, boolean declare, int scope) Конструктор для TagVariableInfo. |
| Метод. Резюме. | |
| java.lang.String | () Тело элемента |
| boolean | () Тело элемента |
| java.lang.String | () Тело элемента |
| java.lang.String | () Тело элемента |
| int | () Тело элемента |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp.tagext Класс ValidationMessage
java.lang.Object | +--javax.servlet.jsp.tagext.ValidationMessagepublic class ValidationMessageextends java.lang.Object
Сообщение о проверке из TagLibraryValidator.
JSP-контейнер может (по выбору/optionally) поддерживать атрибут jsp:id для предоставления более качественной проверки ошибок. Если это поддерживается, контейнер будет отслеживать JSP-страницы по мере передачи контейнеру и будет присваивать каждому элементу уникальный "id", который передаётся как значение атрибута jsp:id. Каждый XML-элемент, доступный в XML-просмотре, будет дополнен этим атрибутом. TagLibraryValidator может после этого использовать этот атрибут в одном или более ValidationMessage-объектах. Контейнер, в свою очередь, может использовать эти значения для предоставления более точной информации о местонахождении ошибки.
| Конструктор. Резюме. |
| (java.lang.Stringid, java.lang.String message) Создаёт ValidationMessage. |
| Метод. Резюме. | |
| java.lang.String | () Получает jsp:id. |
| java.lang.String | () Получает локализованное сообщение об ошибке. |
| Методы, унаследованные из класа java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Конструктор. Детали. |
Javax.servlet.jsp.tagext Класс VariableInfo
java.lang.Object | +--javax.servlet.jsp.tagext.VariableInfopublic class VariableInfoextends java.lang.Object
Информация о переменных скриптинга, которые создаются/модифицируются тэгом (на этапе прогона). Эта информация предоставляется TagExtraInfo-классами и используется фазой трансляции JSP.
Переменные скриптинга, генерируемые специальной акцией, могут иметь значения scope: page, request, session и application.
Имя класса (VariableInfo.getClassName) в возвращаемых объектах используется для определения типов переменных скриптинга. В связи с этим, специальная акция не может создать переменную скриптинга примитивного типа. Обойти это можно с помощью "боксовых/boxed" типов.
Имя класса может быть Полным Квалифицированным Именем Класса или кратким именем класса.
Если предоставляется Полное Квалифицированное Имя Класса, оно должно ссылаться на класс, который должен находится в пути CLASSPATH для данного Web-Приложения (см. спецификацию Servlet 2.3 - это директории WEB-INF/lib и WEB-INF/classes). Невыполнение этого приведёт к ошибке времени трансляции.
Если задаются краткие имена классов в VariableInfo-объектах, то имя класса обязано быть именем public-класса в контексте директив import страницы, на которой появилась специальная акция (будет проверено, имеется ли трёп JLS, на который ссылаются). Класс обязан также находиться в пути CLASSPATH для данного Web-Приложения (см. спецификацию Servlet 2.3 - это директории WEB-INF/lib и WEB-INF/classes). Невыполнение этого приведёт к ошибке времени трансляции.
Комментарии Использования
Часто полное квалифицированное имя класса ссылается на класс, который известен библиотеке тэгов и, таким образом, будет помещён в тот же самый JAR-файл, что и обработчики тэгов. В большинстве других случаев оно будет ссылаться на класс, который находится на платформе, на которой построен JSP-процессор (типа J2EE). Использование полных квалифицированных имён классов таким образом является относительно более устойчивым к ошибкам конфигурации.
| Конструктор. Резюме. |
| (java.lang.String varName, java.lang.String className, boolean declare, int scope) Конструктор. Эти объекты могут быть созданы (на этапе трансляции) экземплярами TagExtraInfo. |
| Метод. Резюме. | |
| java.lang.String | () |
| boolean | () |
| int | () |
| java.lang.String | () |
| Методы, унаследованные из класса java.lang.Object |
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Поле. Детали. |
JspDestroy
public void jspDestroy()Метод jspDestroy() вызывается при уничтожении JSP-страницы.
JSP-страница может переопределять этот метод через включение его определения в элемент declaration.
JSP-страница должна переопределять метод destroy() из Servlet.
| Класс |
СЛЕДУЮЩИЙ КЛАСС
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | КОНСТРУКТОР |
ДЕТАЛИ: ПОЛЕ | КОНСТРУКТОР |
public JspException(java.lang.Stringmsg)
Конструирует новое JSP-исключение со специфицированным сообщением. Сообщение может быть записано в log-файл сервера и/или выведено пользователю.
Параметры:msg - String, специфицирующая текст сообщения исключения.
public JspException(java.lang.String message, java.lang.Throwable rootCause)
Конструирует новое JSP-исключение, когда JSP нужно вызывать исключение, и включает сообщение об "основной причине" исключения, которая конфликтует с нормальным ходом процесса, включая сообщение описания.
Параметры:message - String, содержащая текст сообщения исключения.rootCause - исключение Throwable, причина которого конфликтует с нормальной работой сервлета, делая необходимым вызов данного исключения сервлета.
public JspException(java.lang.ThrowablerootCause)
Конструирует новое JSP-исключение, когда JSP нужно вызывать исключение, и включает сообщение об "основной причине" исключения, которая конфликтует с нормальным ходом процесса. Сообщение исключения базируется на локализованном сообщении об исключении.
Этот метод вызывает метод getLocalizedMessage в исключении Throwable для получения локализованного сообщения исключения. При создании подкласса от JspException этот метод может быть переопределён для создания сообщения исключения, разработанного для конкретного места (язык, страна...).
Параметры:rootCause - исключение Throwable, причина которого конфликтует с нормальной работой сервлета, делая необходимым вызов данного исключения сервлета.
| Метод. Детали. |
JspInit
public void jspInit()Метод jspInit() вызывается при инициализации JSP-страницы. Реализация JSP (и класс, упомянутый атрибутом extends, если имеется) отвечает за то, что с этого момента вызовы метода getServletConfig() будут возвращать нужное значение.
JSP-страница может переопределять этот метод через включение его определения в элемент declaration.
JSP-страница должна переопределять метод init() из Servlet.
_JspService
public void _jspService(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) throws javax.servlet.ServletException, java.io.IOExceptionМетод _jspService() соответствует телу/body JSP-страницы. Этот метод определяется автоматически JSP-контейнером и никогда не должен определяться автором JSP-страницы.
Если суперкласс специфицирован с использованием атрибута extends, этот суперкласс может избрать выполнение некоторых акций в своём методе service() до или после вызова метода _jspService().
См. использование атрибута extends в главе JSP_Engine/Машина спецификации JSP.
| Класс |
ПРЕДЫДУЩИЙ КЛАСС
ФРЭЙМЫ БЕЗ ФРЭЙМОВ
ДЕТАЛИ: ПОЛЕ | КОНСТРУКТОР |
JspTagException
public JspTagException(java.lang.String msg)Конструктор с сообщением..
public JspTagException()
Нет сообщения.
| Класс |
СЛЕДУЮЩИЙ КЛАСС
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | |
ДЕТАЛИ: ПОЛЕ | | МЕТОД
JspWriter
protected JspWriter(intbufferSize, boolean autoFlush)protected-конструктор.
| Метод. Детали. |
NESTED
public static final int NESTEDИнформация о видимости: переменная видна только внутри между начальным/конечным тэгами.
NewLine
public abstract void newLine() throws java.io.IOExceptionЗаписывает разделитель строк. Строковое значение разделителей строк определяется системным свойством line.separator, и это не обязательно может быть один символ новой строки ('\n').
Вызывает:java.io.IOException - если возникает ошибка I/O (ввода-вывода).
NO_BUFFER
public static final int NO_BUFFERконстанта, указывающая, что Writer не буферизует вывод.
Описание Пакета javax.servlet.jsp.tagext
Классы и интерфейсы для определения Библиотек Тэгов JavaServer Pages.Спецификация JavaServer Pages(tm) (JSP) 1.2 предоставляет переносимый механизм описания библиотек тэгов.
Библиотека тэгов JSP содержит:
Спецификация JSP 1.2 и реализация, на которую имеются ссылки, содержат простые и довольно сложные примеры акций, определённых с использованием этого механизма. Они находятся на сайте JSP по адресу: . Некоторым читателям, возможно, понадобится консультироваться там для получения представления о том, как эти механизмы работают совместно.
| Пакет | Класс |
СЛЕДУЮЩИЙ ПАКЕТ
OUT
public static final java.lang.String OUTИмя, используемое для хранения текущего JspWriter'а в таблице имён PageContext'а.
PAGE_SCOPE
public static final int PAGE_SCOPEОбласть видимости - страница: (по умолчанию) именованная ссылка работает в данном PageContext до возвращения из текущего вызова Servlet.service().
PAGECONTEXT
public static final java.lang.String PAGECONTEXTИмя, используемое для хранения данного PageContext'а в его собственной таблице имён.
protected pageContext
| Конструктор. Детали. |
Пакет javax.servlet.jsp.tagext
Классы и интерфейсы для определения Библиотек Тэгов JavaServer Pages.См.:
| Интерфейс. Резюме. | |
| Интерфейс BodyTag расширяет IterationTag путём определения дополнительных методов, позволяющих обработчику тэга манипулировать содержимым, вычисляя его тело. | |
| Интерфейс IterationTag расширяет Tag путём определения дополнительного метода, управляющего повторными вычислениями его тела. | |
| Интерфейс простого обработчика тэга, который не манипулирует его телом. | |
| Вспомогательный интерфейс для Tag, IterationTag или обработчика тэга BodyTag'а, которым нужны дополнительные возможности для обслуживания ресурсов. |
| Класс. Резюме. | |
| Инкапсуляция вычисления/обсчёта тела акции, делающая её доступной обработчику тэга. | |
| Базовый класс для определения обработчиков тэгов, реализующих BodyTag. | |
| Информация времени трансляции о JSP-странице. | |
| Информация об атрибутах Tag'а, доступная на этапе трансляции. | |
| Информация (только на этапе трансляции) пары attribute/value для экземпляра тэга. | |
| Необязательный/Optional класс, предоставляемый автором библиотеки тэгов, для описания информации времени трансляции, не описанной в TLD. | |
| Tag-информация для тэга в Tag Library; этот класс инстанциируется из Tag Library Descriptor-файла (TLD) и доступен только на этапе трансляции. | |
| Информация времени трансляции, ассоциированная с директивой taglib, и её TLD-файл. | |
| Класс проверщика времени трансляции для JSP-страницы. | |
| Базовый класс для определения новых обработчиков тэгов, реализующих Tag. | |
| Информация переменной для тэга в Библиотеке Тэгов; этот класс инстанциируется из Tag Library Descriptor-файла (TLD) и доступен только на этапе трансляции. | |
| Проверочное сообщение из TagLibraryValidator'а. | |
| Информация переменной скриптинга, созданной/модифицированной тэгом (на этапе прогона). |
Пакет javax.servlet.jsp
Пакет javax.servlet.jsp содержит несколько классов и интерфейсов, описывающих и определяющих контракты между классом реализации JSP-страницы и средой прогона программ такого класса, предоставляемых (классов) экземпляру такого класса соответствующим JSP-контейнером.См.:
| Интерфейс. Резюме. | |
| Интерфейс HttpJspPage описывает взаимодействие, которое Класс Реализации JSP-Страницы обязан выполнять при использовании протокола HTTP. | |
| Интерфейс JspPage описывает типовое взаимодействие которое Класс Реализации JSP-Страницы обязан выполнять; страницы, использующие протокол HTTP, описываются интерфейсом HttpJspPage. |
| Класс. Резюме. | |
| JspEngineInfo это абстрактный класс, предоставляющий информацию о текущей JSP-машине. | |
| JspFactory это абстрактный класс, определяющий несколько методов фактории, доступных JSP-странице на этапе прогона, для целей создания экземпляров различных интерфейсов и классов, используемых для поддержки реализации JSP. | |
| Акции и шаблонные данные в JSP-странице, написанные с использованием JspWriter-объекта, на который ссылаются через неявную переменную out, которая инициализируется автоматически через использование методов в PageContext-объекте. | |
| PageContext-экземпляр, предоставляющий доступ ко всем пространствам имён, ассоциированным с JSP-страницей, к различным атрибутам страницы, а также слой поверх деталей реализации. |
| Исключение. Резюме. | |
| Общее исключение, известное JSP-машине; неотловленное JspExceptions будет приводить к вызову механизмов errorpage. | |
| Исключение, используемое Обработчиком Тэга для указания на непоправимую ошибку. |
| Пакет | Класс |
PopBody
public popBody()Возвращает предыдущий JspWriter "out", сохранённый парным методом pushBody(), и обновляет значение атрибута "out" в пространстве имён области видимости page PageContext'а.
Возвращает:сохранённый JspWriter.
| Класс |
СЛЕДУЮЩИЙ КЛАСС
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: | |
Печатает булево значение. Строка, производимая методом String.valueOf(boolean), транслируется в байты в соответствии с кодировкой символов по умолчанию на данной платформе, и эти байты записываются точно в манере метода Writer.write(int).
Параметры:b - печатаемое boolean.
Вызывает:java.io.IOException
public abstract void print(char c) throws java.io.IOException
Печатает символ. Символ транслируется в один или более байтов в соответствии с кодировкой символов по умолчанию на данной платформе, и эти байты записываются точно в манере метода Writer.write(int).
Параметры:c - печатаемый char.
Вызывает:java.io.IOException
public abstract void print(long l) throws java.io.IOException
Печатает длинное целое. Строка, производимая методом by String.valueOf(long), транслируется в байты в соответствии с кодировкой символов по умолчанию на данной платформе, и эти байты записываются точно в манере метода Writer.write(int).
Параметры:l - печатаемое long.
Вызывает:java.io.IOException - См. также:java.lang.Long#toString(long)
public abstract void print(floatf) throws java.io.IOException
Печатает число с плавающей точкой. Строка, производимая методом String.valueOf(float), транслируется в байты в соответствии с кодировкой символов по умолчанию на данной платформе, и эти байты записываются точно в манере метода Writer.write(int).
Параметры:f - печатаемое float.
Вызывает:java.io.IOExceptionСм. также:java.lang.Float#toString(float)
public abstract void print(double d) throws java.io.IOException
Печатает число с плавающей точкой двойной точности. Строка, производимая методом String.valueOf(double), транслируется в байты в соответствии с кодировкой символов по умолчанию на данной платформе, и эти байты записываются точно в манере метода Writer.write(int).
Параметры:d - печатаемое double.
Вызывает:java.io.IOExceptionСм. также:java.lang.Double#toString(double)
public abstract void print(char[]s) throws java.io.IOException
Печатает массив символов. Символы конвертируются в байты в соответствии с кодировкой символов по умолчанию на данной платформе, и эти байты записываются точно в манере метода Writer.write(int).
параметры:s - массив печатаемых chars.
Вызывает:NullPointerException - если s равно nulljava.io.IOException
public abstract void print(java.lang.String s) throws java.io.IOException
Печатает строку. Если аргумент - null, тогда печатается строка "null". Иначе, символы строки конвертируются в байты в соответствии с кодировкой символов по умолчанию на данной платформе, и эти байты записываются точно в манере метода Writer.write(int).
Параметры:s - печатаемая String.
Вызывает:java.io.IOException
public abstract void print(java.lang.Objectobj) throws java.io.IOException
Печатает объект. Строка, производимая методом String.valueOf(Object), транслируется в байты в соответствии с кодировкой символов по умолчанию на данной платформе, и эти байты записываются точно в манере метода Writer.write(int.
Параметры:obj - печатаемый Object.
Вызывает:java.io.IOExceptionСм. также:Object.toString()
Println
public abstract void println() throws java.io.IOExceptionЗаканчивает текущую строку, печатая строку разделителей строк. Строка разделителей строк определяется системным свойством line.separator, и это не обязательно один символ новой строки ('\n').
Вызывает:java.io.IOException
public abstract void println(booleanx) throws java.io.IOException
Печатает булево значение и заканчивает строку. Этот метод ведёт себя так, будто он вызывает , а затем - .
Вызывает:java.io.IOException
public abstract void println(intx) throws java.io.IOException
Печатает целое число и заканчивает строку. Этот метод ведёт себя так, будто он вызывает , а затем - .
Вызывает:java.io.IOException
public abstract void println(long x) throws java.io.IOException
Печатает длинное целое число и заканчивает строку. Этот метод ведёт себя так, будто он вызывает , а затем - .
Вызывает:java.io.IOException
public abstract void println(floatx) throws java.io.IOException
Печатает число с плавающей точкой и заканчивает строку. Этот метод ведёт себя так, будто он вызывает , а затем - .
Вызывает:java.io.IOException
public abstract void println(double x) throws java.io.IOException
Печатает число с плавающей точкой двойной точности и заканчивает строку. Этот метод ведёт себя так, будто он вызывает , а затем - .
Вызывает:java.io.IOException
public abstract void println(char[]x) throws java.io.IOException
Печатает массив символов и заканчивает строку. Этот метод ведёт себя так, будто он вызывает , а затем - .
Вызывает:java.io.IOException
public abstract void println(java.lang.String x) throws java.io.IOException
Печатает String и заканчивает строку. Этот метод ведёт себя так, будто он вызывает , а затем - .
Вызывает:java.io.IOException
public abstract void println(java.lang.Objectx) throws java.io.IOException
Печатает Object и заканчивает строку. Этот метод ведёт себя так, будто он вызывает , а затем - .
Вызывает:java.io.IOException
PushBody
public pushBody()Возвращает новый BodyContent-объект, сохраняет текущий "out" JspWriter и обновляет значение атрибута "out" в пространстве имён области видимости page PageContext'а.
Возвращает:новый BodyContent.
Release
public void release()Освободить статус.
Переопределяет: в классе
public abstract void release()
Этот метод будет "восстанавливать/reset" начальное состояние PageContext'а, освобождая все ссылки и подготавливая PageContext для возможного использования в последующих вызовах initialize(). Этот метод обычно вызывается из JspFactory.releasePageContext().
Подклассы должны включать этот метод (быть оболочкой).
Этот метод не должен использоваться авторами страниц или библиотек тэгов.
public void release()
Освобождает любые данные, сохраняемые данным экземпляром для целей проверки.
| Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | ПОЛЕ | |
ДЕТАЛИ: ПОЛЕ | |
public void release()
Освобождает статус.
См. также:
ReleasePageContext
public abstract void releasePageContext( pc)вызывается для уничтожения/освобождения ранее размещённого PageContext-объекта. результатом является вызов PageContext.release().
Этот метод должен вызываться до возвращения из метода _jspService() класса реализации JSP.
Параметры:pc - PageContext, полученный ранее методом getPageContext()
RemoveAttribute
public abstract void removeAttribute(java.lang.String name)Удаляет ссылку на объект, ассоциированный с данным именем, просматривая все области видимости в установленном порядке просмотра.
Параметры:name - имя удаляемого объекта.
public abstract void removeAttribute(java.lang.Stringname, int scope)
Удаляет ссылку на объект, ассоциированный с данным именем, в данной области видимости.
Параметры:name - имя удаляемого объекта.scope - область видимости для просмотра.
RemoveValue
public void removeValue(java.lang.String k)Удаляет значение, ассоциированное с ключом.
Параметры:k - строка-ключ.
REQUEST_SCOPE
public static final int REQUEST_SCOPEОбласть видимости - запрос: именованная ссылка работает в данном ServletRequest, ассоциированном с Servlet, до завершения выполнения текущего запроса.
REQUEST_TIME_VALUE
public static final java.lang.Object REQUEST_TIME_VALUEОпределённое значение атрибута для указания его значения в выражении времени запроса (которое ещё не доступно, поскольку экземпляры TagData используются на этапе трансляции).
| Конструктор. Детали. |
REQUEST
public static final java.lang.String REQUESTИмя, используемое для хранения ServletRequest'а в таблице имён PageContext'а.
RESPONSE
public static final java.lang.String RESPONSEИмя, используемое для хранения ServletResponse в таблице имён PageContext'а.
SESSION_SCOPE
public static final int SESSION_SCOPEОбласть видимости - сессия (верно, только если данная страница участвует в сессии): именованная ссылка работает в данной HttpSession (если запущена), ассоциированной с Servlet'ом, до закрытия HttpSession.
SESSION
public static final java.lang.String SESSIONИмя, используемое для хранения HttpSession в таблице имён PageContext'а.
SetAttribute
public abstract void setAttribute(java.lang.Stringname, java.lang.Object attribute)Регистрирует имя и объект, специфицированные с семантикой области видимости page.
Параметры:name - имя атрибута для установкиattribute - объект для ассоциирования с именемВызывает:NullPointerException - если name или object - null
public abstract void setAttribute(java.lang.String name, java.lang.Object o, int scope)
Регистрирует имя и объект, специфицированные с соответствующей семантикой области видимости.
Параметры:name - имя атрибута для установкиo - объект для ассоциирования с именемscope - область видимости, с которой ассоциируется name/objectВызывает:NullPointerException - если name или object - nulljava.lang.IllegalArgumentException - если область видимости неверна
public void setAttribute(java.lang.String attName, java.lang.Object value)
Устанавливает значение атрибута.
Параметры:attName - имя атрибута.value - значение.
SetBodyContent
public void setBodyContent(b)Устанавливает свойство bodyContent. Этот метод вызывается объектом реализации JSP-страницы не более одного раза на каждый вызов акции. Этот метод вызывается до doInitBody. Этот метод не будет вызываться для пустых тэгов или непустых тэгов, чей метод doStartTag() возвращает SKIP_BODY или EVAL_BODY_INCLUDE.
Если setBodyContent вызывается, значение неявного объекта out уже было изменено в pageContext-объекте. Передаваемый BodyContent-объект не будет содержать в себе данных, но может быть использован повторно (и зачищен) после некоторого предыдущего вызова.
BodyContent-объект является доступным и имеет соответствующее содержимое до момента сразу после вызова метода doEndTag - в этом случае он может быть снова использован повторно.
Параметры:b - BodyContent
public void setBodyContent(b)
Подготавливает для вычисления тела: берёт bodyContent.
Специфицирован в: в интерфейсе .Параметры:b - BodyContent
SetDefaultFactory
public static void setDefaultFactory(deflt)установить факторию по умолчанию для данной реализации.
Только среда прогона программ JSP-Машина может вызывать этот метод.
Параметры:default - реализация фактории по умолчанию.
SetId
public void setId(java.lang.Stringid)Устанавливает атрибут id для данного тэга.
Параметры:id - String для id.
SetInitParameters
public void setInitParameters(java.util.Mapmap)Устанавливает init-данные в TLD для данного проверщика. Имена параметров - это ключи, а значения параметров являются значениями.
Параметры:initMap - Map/Карта, описывающая init-параметры.
SetPageContext
public void setPageContext(pc)Устанавливает текущий контекст страницы. Этот метод вызывается объектом реализации JSP-страницы до вызова doStartTag().
Это значение *не* восстанавливается/reset методом doEndTag() и обязано быть восстановлено явно реализацией страницы, если изменяется между вызовами doStartTag().
Параметры:pc - контекст страницы для данного обработчика тэга.
public void setPageContext(pageContext)
Устанавливает контекст страницы.
Параметры:pageContenxt - PageContext.См. также:
SetParent
public void setParent( t)Устанавливает родителя (ближайший содержащий обработчик тэга) данного обработчика тэга.
Вызывается объектом реализации JSP-страницы до вызова doStartTag().
Это значение *не* восстанавливается/reset методом doEndTag() и обязано быть восстановлено явно реализацией страницы.
Параметры:t - родительский тэг/tag или null.
public void setParent(t)
Устанавливает содержащий тэг данного тэга.
Параметры:t - родительский Tag.См. также:
SetTagExtraInfo
public void setTagExtraInfo(tei)Устанавливает экземпляр для дополнительной информации тэга.
Параметры:tei - экземпляр TagExtraInfo.
SetTagInfo
public final void setTagInfo(tagInfo)Устанавливает TagInfo для данного класса.
Параметры:tagInfo - TagInfo, которого расширяет данный экземпляр.
SetTagLibrary
public void setTagLibrary(tl)Устанавливает свойство TagLibraryInfo.
Заметьте, что элемент TagLibraryInfo зависит не только от информации TLD, но также и от специфики используемого экземпляра taglib. Это значит, что большое количество работы понадобится для конструирования и инициализации TagLib-объектов.
Если используется осторожно, этот setter поможет исключить необходимость создания новых элементов TagInfo для каждой директивы taglib.
Параметры:tl - TagLibraryInfo для назначения.
SetValue
public void setValue(java.lang.String k, java.lang.Object o)Ассоциирует значение со String-ключом.
Параметры:k - String-ключ.o - ассоциируемое значение.
SKIP_BODY
public static final int SKIP_BODYПропустить вычисление тела. Верное return-значение для doStartTag и doAfterBody.
SKIP_PAGE
public static final int SKIP_PAGEПропустить остаток страницы. Верное return-значение для doEndTag.
TagAttributeInfo
public TagAttributeInfo(java.lang.Stringname, boolean required, java.lang.String type, boolean reqTime)Конструктор для TagAttributeInfo. Этот класс инстанциируется только из TagLibrary-кода по запросу из некоторого JSP-кода,разбирающего TLD (Tag Library Descriptor).
Параметры:name - имя атрибута.required - необходим ли атрибут в экземплярах тэга.type - имя типа атрибута.reqTime - содержит ли атрибут Attribute времени запроса.
| Метод. Детали. |
TagData
public TagData(java.lang.Object[][]atts)Конструктор для TagData.
Типичный конструктор выглядит так: static final Object[][] att = {{"connection", "conn0"}, {"id", "query0"}}; static final TagData td = new TagData(att);
Все значения обязаны быть Strings, за исключением тех, которые содержат определённый объект REQUEST_TIME_VALUE.
Параметры:atts - static-атрибут и значения. Может быть null.
public TagData(java.util.Hashtable attrs)
Конструктор для TagData.
Если у Вас уже есть атрибуты в хэш-таблице, используйте этот конструктор.
Параметры:attrs - хэш-таблица, из которой получать значения.
| Метод. Детали. |
TagInfo
public TagInfo(java.lang.StringtagName, java.lang.String tagClassName, java.lang.String bodycontent, java.lang.String infoString, taglib, tagExtraInfo, [] attributeInfo)Конструктор для TagInfo из данных в формате JSP 1.1 для TLD. Этот класс инстанциируется только из кода TagLibrary по запросу некоторого кода JSP, который разбирает TLD (Tag Library Descriptor).
Обратите внимание, что, поскольку TagLibibraryInfo отражает информацию и TLD, и директивы taglib, экземпляр TagInfo зависит от директивы taglib. Возможно, это ошибка дизайна, которая будет устранена в будущем.
Параметры:tagName - имя данного тэга;tagClassName - имя класса обработчика тэга;bodycontent - информация содержимого тела этих тэгов;infoString - строка (optional) информации для данного тэга;taglib - экземпляр библиотеки тэгов, содержащей нас;tagExtraInfo - экземпляр, предоставляющий дополнительную информацию Tag'а. Может быть null;attributeInfo - массив AttributeInfo-данных из дескриптора. Может быть null.
public TagInfo(java.lang.String tagName, java.lang.String tagClassName, java.lang.String bodycontent, java.lang.String infoString, taglib, tagExtraInfo, [] attributeInfo, java.lang.String displayName, java.lang.String smallIcon, java.lang.String largeIcon, [] tvi)
Конструктор для TagInfo из данных в формате JSP 1.2 для TLD. Этот класс инстанциируется только из кода TagLibrary по запросу некоторого кода JSP, который разбирает TLD (Tag Library Descriptor).
Обратите внимание, что, поскольку TagLibibraryInfo отражает информацию и TLD, и директивы taglib, экземпляр TagInfo зависит от директивы taglib. Возможно, это ошибка дизайна, которая будет устранена в будущем.
Параметры:tagName - имя данного тэга;tagClassName - имя класса обработчика тэга;bodycontent - информация содержимого тела этих тэгов;infoString - строка (optional) информации для данного тэга;taglib - экземпляр библиотеки тэгов, содержащей нас;tagExtraInfo - экземпляр, предоставляющий дополнительную информацию Tag'а. Может быть null;attributeInfo - массив AttributeInfo-данных из дескриптора. Может быть null;displayName - краткое имя, отображаемое утилитами;smallIcon - путь к небольшой иконке, отображаемой утилитами;largeIcon - путь к большой иконке, отображаемой утилитами;tagVariableInfo - массив TagVariableInfo (или null).
| Метод. Детали. |
TagLibraryInfo
protected TagLibraryInfo(java.lang.Stringprefix, java.lang.String uri)Конструктор.
Здесь вызывается конструктор для TagInfo, и TagAttributeInfo - после разбора TLD-файла.
Параметры:prefix - префикс, используемый директивой tagliburi - URI, используемый директивой taglib
| Метод. Детали. |
TagLibraryValidator
public TagLibraryValidator()| Метод. Детали. |
TagSupport
public TagSupport()Конструктор по умолчанию, все подклассы должны лишь определить public-конструктор с той же подписью и вызвать конструктор суперкласса.
Этот конструктор вызывается колом, сгенерированным JSP-транслятором.
| Метод. Детали. |
TagVariableInfo
public TagVariableInfo(java.lang.String nameGiven, java.lang.String nameFromAttribute, java.lang.String className, boolean declare, int scope)Конструктор для TagVariableInfo.
Параметры:nameGiven - значение
| Метод. Детали. |
ToString
public java.lang.String toString()Переопределяет:toString в классе java.lang.Object.
| Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: | |
public java.lang.String toString()
Строго для целей отладки ...
Переопределяет:toString в классе java.lang.Object.
| Класс |
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: | |
UNBOUNDED_BUFFER
public static final int UNBOUNDED_BUFFERконстанта, указывающая, что Writer буферизуется и размер буфера не ограничен; испоьзуется в BodyContent.
Validate
public [] validate(java.lang.Stringprefix, java.lang.String uri, page)Проверяет JSP-страницу. Будет вызываться однократно на директиву в JSP-странице. Этот метод будет возвращать null, если страница верна; иначе метод должен возвращать массив ValidationMessage-объектов. Массив длиной в нуль также интерпретируется как отсутствие ошибок.
Параметры:prefix - значение аргумента prefix в директиве;uri - значение аргумента uri в директиве;thePage - JspData page-объект.
Возвращает:нулевой объект, или массив нулевой длины, если ошибок нет, иначе - массив ValidationMessages-объектов.
ValidationMessage
public ValidationMessage(java.lang.String id, java.lang.String message)Создаёт ValidationMessage. Это сообщение-String должно быть ненулевым. Значение id может быть null, если сообщение не специфично XML-элементу или если никаких атрибутов jsp:id не было передано. Если ненулевое, значение id обязано быть значением атрибута jsp:id для PageData, переданным в метод validate().
Параметры:id - null или значение атрибута jsp:id.message - локализованное сообщение о проверке.
| Метод. Детали. |
VariableInfo
public VariableInfo(java.lang.StringvarName, java.lang.String className, boolean declare, int scope)Конструктор. Эти объекты могут быть созданы (на этапе трансляции) экземплярами TagExtraInfo.
Параметры:id - имя переменной скриптингаclassName - имя класса переменной скриптингаdeclare - если true, это новая переменная (в некоторых языках программирования потребуется определение)scope - обозначение лексической области видимости переменной
| Метод. Детали. |
WriteOut
public abstract void writeOut(java.io.Writerout) throws java.io.IOExceptionЗаписывает содержимое данного BodyContent'а в Writer. Подклассы могут оптимизировать патэрны обычного вызова.
Параметры:out - writer, в который помещается содержимое данного вычисления тела.
Бизнес: Предпринимательство - Малый бизнес - Управление
- Бизнес
- Разновидности бизнеса
- Планирование бизнеса
- Управление бизнесом
- Предпринимательство
- Русское предпринимательство
- Управление и предпринимательство
- Малый бизнес
- Виды малого бизнеса
- Русский малый бизнес
- Управление малым бизнесом
- Posix для малого бизнеса
- Телефония как малый бизнес
- Телефония на Java для малого бизнеса