Javax.servlet.jsp.tagext Класс TagInfo
java.lang.Object | +--javax.servlet.jsp.tagext.TagInfo
public 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.TagLibraryInfo
public 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.TagLibraryValidator
public abstract class TagLibraryValidatorextends java.lang.Object
Класс проверщика на этапе трансляции для JSP-страницы. проверщик оперирует XML-документом, ассоциированным с JSP-страницей.
TLD-файл ассоциирует класс TagLibraryValidator и некоторые init-аргументы с библиотекой тэгов.
JSP-контейнер отвечает за размещение соответствующего экземпляра соответствующего подкласса:
используя новый экземпляр fresh или повторно используя уже имеющийся; вызывая метод setInitParams(Map) в экземпляре.
После инициализации вызывается метод 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.TagVariableInfo
public 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 | () Тело элемента <variable-class>. |
| boolean | () Тело элемента <declare>. |
| java.lang.String | () Тело элемента <name-from-attribute>. |
| java.lang.String | () Тело элемента <name-given>. |
| int | () Тело элемента <scope>. |
| Методы, унаследованные из класса 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.ValidationMessage
public 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.VariableInfo
public 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 содержит:
Tag Library Descriptor/Дескриптор Библиотеки Тэгов;Несколько классов обработчика тэга, определяющих поведение на этапе запроса;Дополнительные классы и ресурсы, используемые на этапе прогона;Возможно, некоторые дополнительные классы для ввода дополнительной информации трансляции.
Спецификация 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
Пакет 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. | |
| Исключение, используемое Обработчиком Тэга для указания на непоправимую ошибку. |
| Пакет | Класс |
Пакет 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'а. | |
| Информация переменной скриптинга, созданной/модифицированной тэгом (на этапе прогона). |
PopBody
public popBody()
Возвращает предыдущий JspWriter "out", сохранённый парным методом pushBody(), и обновляет значение атрибута "out" в пространстве имён области видимости page PageContext'а.
Возвращает:сохранённый JspWriter.
| Класс |
СЛЕДУЮЩИЙ КЛАСС
РЕЗЮМЕ: ВНУТРЕННИЙ | | |
ДЕТАЛИ: | |
public abstract void print(booleanb) throws java.io.IOException
Печатает булево значение. Строка, производимая методом 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
public static final java.lang.String REQUEST
Имя, используемое для хранения ServletRequest'а в таблице имён PageContext'а.
REQUEST_SCOPE
public static final int REQUEST_SCOPE
Область видимости - запрос: именованная ссылка работает в данном ServletRequest, ассоциированном с Servlet, до завершения выполнения текущего запроса.
REQUEST_TIME_VALUE
public static final java.lang.Object REQUEST_TIME_VALUE
Определённое значение атрибута для указания его значения в выражении времени запроса (которое ещё не доступно, поскольку экземпляры TagData используются на этапе трансляции).
| Конструктор. Детали. |
RESPONSE
public static final java.lang.String RESPONSE
Имя, используемое для хранения ServletResponse в таблице имён PageContext'а.
SESSION
public static final java.lang.String SESSION
Имя, используемое для хранения HttpSession в таблице имён PageContext'а.
SESSION_SCOPE
public static final int SESSION_SCOPE
Область видимости - сессия (верно, только если данная страница участвует в сессии): именованная ссылка работает в данной HttpSession (если запущена), ассоциированной с Servlet'ом, до закрытия HttpSession.
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 - значение <name-given>nameFromAttribute - значение <name-from-attribute>className - значение <variable-class>declare - значение <declare>scope - значение <scope>
| Метод. Детали. |
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, в который помещается содержимое данного вычисления тела.
