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-контейнер отвечает за размещение соответствующего экземпляра соответствующего подкласса:

После инициализации вызывается метод validate(String, String, PageData), где первые два аргумента - это аргументы prefix и uri, используемые директивой taglib.

Экземпляр 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()
Освобождает любые данные, сохраняемые данным экземпляром для целей проверки.