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.
