Spec-Zone .ru спецификации, руководства, описания, API

javax.servlet.jsp.tagext
Класс TagLibraryValidator

java.lang.Object
  javax.servlet.jsp.tagext.TagLibraryValidator

Прямые Известные Подклассы:

PermittedTaglibsTLV, ScriptFreeTLV

public abstract class TagLibraryValidator
расширяет java.lang. Объект

Разовый преобразованием блок проверки допустимости class для страницы JSP. Блок проверки допустимости работает на режиме просмотра XML, связанном со страницей JSP.

Файл TLD связывает TagLibraryValidator class и некоторые init параметры с библиотекой тега.

Контейнер JSP является reponsible для того, чтобы определить местоположение соответствующего экземпляра соответствующего подкласса

• новый новый экземпляр, или повторное использование доступный
• вызовите setInitParams (Карта) метод на экземпляре

после того, как инициализированный, проверение (Строка, Строка, PageData) метод будет вызван, где первыми двумя параметрами является префикс и туры для этой библиотеки тега в Режиме просмотра XML. Префикс предназначается, чтобы облегчить производить сообщение об ошибке. Однако, это не всегда точно. В случае, где единственный URI отображается больше чем на один префикс в режиме просмотра XML, обеспечивается префикс первого URI. Поэтому, чтобы обеспечить высококачественные сообщения об ошибках в случаях, где элементы самого тега проверяются, префиксный параметр должен быть проигнорирован, и фактический префикс элемента должен использоваться вместо этого. TagLibraryValidators должен всегда использовать туров, чтобы идентифицировать элементы как beloning к библиотеке тега, не префиксу.

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

Контейнер JSP, как гарантируют, не сериализирует вызовы, проверяют () метода, и TagLibraryValidators должен выполнить любую синхронизацию, которой они могут потребовать.

С JSP 2.0, контейнер JSP должен обеспечить атрибут jsp:id, чтобы обеспечить более высокие качественные ошибки проверки допустимости. Контейнер отследит страницы JSP как передано к контейнеру, и присвоит каждому элементу уникальный "идентификатор", который передают как значение атрибута jsp:id. Каждый элемент XML в доступном режиме просмотра XML будет расширен с помощью этого атрибута. TagLibraryValidator может тогда использовать атрибут в одном или более объектах ValidationMessage. Контейнер тогда, поочередно, может использовать эти значения, чтобы предоставить более точную информацию о расположении ошибки.

Фактический префикс id атрибут может или, возможно, не jsp но это будет всегда отображаться на пространство имен http://java.sun.com/JSP/Page. Реализация TagLibraryValidator должна положиться на туров, не префикс, id атрибут.

Сводка конструктора

TagLibraryValidator()
Единственный конструктор.

Сводка метода

java.util.Map<java.lang.String,java.lang.Object>	getInitParameters() Получите init данные параметров как неизменную Карту.
void	release() Выпустите любые данные, сохраненные этим экземпляром в целях проверки допустимости.
void	setInitParameters(java.util.Map<java.lang.String,java.lang.Object> map) Установите init данные в TLD для этого блока проверки допустимости.
ValidationMessage[]	validate(java.lang.String prefix, java.lang.String uri, PageData page) Проверьте страницы JSP.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

TagLibraryValidator

public TagLibraryValidator()

Единственный конструктор. (Для вызова конструкторами подкласса, обычно неявными.)

Деталь метода

setInitParameters

public void setInitParameters(java.util.Map<java.lang.String,java.lang.Object> map)

Установите init данные в TLD для этого блока проверки допустимости. Названия параметра являются ключами, и значения параметра являются значениями.

Параметры:

map - Карта, описывающая init параметры

getInitParameters

public java.util.Map<java.lang.String,java.lang.Object> getInitParameters()

Получите init данные параметров как неизменную Карту. Названия параметра являются ключами, и значения параметра являются значениями.

Возвраты:

init параметры как неизменная карта.

проверить

public ValidationMessage[] validate(java.lang.String prefix,
                                    java.lang.String uri,
                                    PageData page)

Проверьте страницы JSP. Это будет вызвано однажды на уникальный URI библиотеки тега в режиме просмотра XML. Этот метод возвратит нуль, если страница будет допустима; иначе метод должен возвратить массив объектов ValidationMessage. Массив нуля длины также не интерпретируется как никакие ошибки.

Параметры:

prefix - первый префикс, с которым библиотека тега связывается в режиме просмотра XML. Отметьте, что некоторые теги могут использовать различный префикс, если пространство имен пересматривается.

uri - уникальный идентификатор библиотеки тега

page - объект страницы JspData

Возвраты:

Нулевой объект, или нулевая длина выстраивает если никакие ошибки, массив ValidationMessages иначе.

выпуск

public void release()

Выпустите любые данные, сохраненные этим экземпляром в целях проверки допустимости.