[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Web мастеру, CGI, Perl, PHP, Apache" / Оглавление документа

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

java.lang.Object
  |
  +--javax.servlet.jsp.tagext.TagLibraryValidator

public abstract class TagLibraryValidator

extends java.lang.Object

Класс проверщика на этапе трансляции для JSP-страницы. проверщик оперирует XML-документом, ассоциированным с JSP-страницей.

TLD-файл ассоциирует класс TagLibraryValidator и некоторые init-аргументы с библиотекой тэгов.

JSP-контейнер отвечает за размещение соответствующего экземпляра соответствующего подкласса:

• используя новый экземпляр fresh или повторно используя уже имеющийся;
• вызывая метод setInitParams(Map) в экземпляре.

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

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

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

Конструктор. Резюме.

TagLibraryValidator ()

 

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

 

Методы, унаследованные из класса java.lang.Object

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

 

Конструктор. Детали.

TagLibraryValidator

public TagLibraryValidator()

setInitParameters

public void setInitParameters(java.util.Map map)

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

Параметры:

initMap - Map/Карта, описывающая init-параметры.

getInitParameters

public java.util.Map getInitParameters()

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

Возвращает:

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

validate

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

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

Параметры:

prefix - значение аргумента prefix в директиве;

uri - значение аргумента uri в директиве;

thePage - JspData page-объект.

Возвращает:

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

release

public void release()

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

Партнёры:

Хостинг: