Спецификация Java Server Pages 1.2

JSP.10.5.5 TagLibraryValidator



Синтаксис


public abstract class TagLibraryValidator


Описание

Класс проверщика этапа трансляции для 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. Контейнер тогда, в свою очередь, может использовать эти значения для предоставления более точной информации о местонахождении ошибки.

JSP.10.5.5.27 Конструкторы



public TagLibraryValidator()

JSP.10.5.5.28 Методы


public java.util.Map getInitParameters()


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


Возвращает: параметры init как неизменяемую карту.


public void release()

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


public void setInitParameters(java.util.Map map)

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

Параметры:

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

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

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

Параметры:

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

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

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

Возвращает: null-объект, или массив нулевой длины при отсутствии ошибок, или массив объектов ValidationMessages.


Содержание раздела