Класс ValidatorHandler

protected ValidatorHandler()

Конструктор для производных классов.

Конструктор ничего не делает.

Производные классы должны создать объекты ValidatorHandler, которые имеют null обработчик ошибок ErrorHandler и null разыскщик ресурсов LSResourceResolver.

public abstract void setContentHandler(ContentHandler receiver)

Устанавливает обработчик событий ContentHandler, который получает результаты валидации с расширениями.

При указании обработчика событий ContentHandler, класс ValidatorHandler будет работать как фильтр и в основном копировать входящие события в указанный обработчик событий ContentHandler.

При этом класс ValidatorHandler может изменять события, например, добавляя значения по умолчанию для атрибутов.

Класс ValidatorHandler может буферизовать события до определённой степени, но для использования ValidatorHandler анализатором, необходимо выполнить следующие требования.

1. Когда вызываются ContentHandler.startElement(String, String, String, Attributes), ContentHandler.endElement(String, String, String), ContentHandler.startDocument() или ContentHandler.endDocument() для класса ValidatorHandler, те же методы для указанного обработчика событий ContentHandler должны быть вызваны для того же события до возврата вызова.
2. Класс ValidatorHandler не должен вводить новые элементы, которые не были в исходных данных.
3. Класс ValidatorHandler не должен удалять атрибуты, которые были в исходных данных.

Если метод обратного вызова для указанного обработчика событий ContentHandler вызывает исключение, то то же исключение должно быть выброшено классом ValidatorHandler. Обработчик ошибок ErrorHandler не должен уведомляться об таком исключении.

Этот метод может быть вызван даже в середине процесса валидации.

public abstract ContentHandler getContentHandler()

Возвращает обработчик событий ContentHandler, который получает результаты валидации с расширениями.

public abstract void setErrorHandler(ErrorHandler errorHandler)

Устанавливает обработчик ошибок ErrorHandler для обработки ошибок, возникших во время валидации.

Обработчик ошибок может использоваться для настройки процесса обработки ошибок во время валидации. Когда обработчик ошибок ErrorHandler установлен, обнаруженные во время валидации ошибки сначала будут отправлены обработчику ошибок ErrorHandler.

Обработчик ошибок может немедленно прервать дальнейшую валидацию, выбросив исключение SAXException из обработчика. Или, например, он может вывести ошибку на экран и попытаться продолжить валидацию, вернувшись обычно из обработчика ErrorHandler.

Если любое исключение Throwable выбрасывается из обработчика ошибок ErrorHandler, то тот же объект исключения Throwable будет переброшен в верхний уровень стека вызовов.

Класс ValidatorHandler не может выбросить исключение SAXException без предварительного сообщения об этом обработчику ошибок ErrorHandler.

Если обработчик ошибок ErrorHandler равен null, то реализация будет вести себя так, как если бы был установлен следующий обработчик ошибок ErrorHandler:

 class DraconianErrorHandler implements ErrorHandler {
     public void fatalError( SAXParseException e ) throws SAXException {
         throw e;
     }
     public void error( SAXParseException e ) throws SAXException {
         throw e;
     }
     public void warning( SAXParseException e ) throws SAXException {
         // noop
     }
 }
 

При создании нового объекта ValidatorHandler это поле изначально устанавливается в значение null.

public abstract ErrorHandler getErrorHandler()

Возвращает текущий обработчик ошибок ErrorHandler, установленный для этого объекта ValidatorHandler.

public abstract void setResourceResolver(LSResourceResolver resourceResolver)

Устанавливает разыскщик ресурсов LSResourceResolver для настройки разрешения ресурсов во время валидации.

Класс ValidatorHandler использует разыскщик ресурсов LSResourceResolver при необходимости поиска внешних ресурсов во время валидации, хотя то, что считается "поиском внешних ресурсов", зависит от каждого языка схемы.

Если разыскщик ресурсов LSResourceResolver равен null, то реализация будет вести себя так, как если бы был установлен следующий разыскщик ресурсов LSResourceResolver:

 class DumbLSResourceResolver implements LSResourceResolver {
     public LSInput resolveResource(
         String publicId, String systemId, String baseURI) {

         return null; // always return null
     }
 }
 

Если разыскщик ресурсов LSResourceResolver выбрасывает исключение RuntimeException (или его производные), то класс ValidatorHandler прервёт процесс парсинга, и вызывающий метод validate получит то же исключение RuntimeException.

При создании нового объекта ValidatorHandler это поле изначально устанавливается в значение null.

public abstract LSResourceResolver getResourceResolver()

Возвращает текущий разыскщик ресурсов LSResourceResolver, установленный для этого объекта ValidatorHandler.

public abstract TypeInfoProvider getTypeInfoProvider()

Получает реализацию TypeInfoProvider для данного ValidatorHandler.

Полученная TypeInfoProvider может быть запрошена во время разбора для доступа к информации о типах, определённой валидатором.

Некоторые языки схем не определяют понятие типа; для таких языков этот метод может быть не поддерживается. Однако для соответствия этому спецификации, реализации для W3C XML Schema 1.0 должны поддерживать эту операцию.

public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException

Получает значение флага функции.

Имя функции — любой полносинтаксический URI. ValidatorHandler может распознать имя функции, но временно не сможет вернуть его значение. Некоторые значения функций доступны только в определённых контекстах, например, до, во время или после валидации.

Реализаторы свободны (и им рекомендуется) придумывать свои собственные функции, используя имена, основанные на своих собственных URI.

public void setFeature(String name, boolean value) throws SAXNotRecognizedException, SAXNotSupportedException

Устанавливает функцию для этого ValidatorHandler.

Функции могут использоваться для управления способом, которым ValidatorHandler анализирует схемы. Имя функции — любой полносинтаксический URI. SchemaFactory может предоставить значение функции, но не сможет изменить текущее значение. Некоторые значения функций могут быть неизменяемыми или изменяемыми только в определённых контекстах, например, до, во время или после валидации.

Все реализации обязаны поддерживать функцию XMLConstants.FEATURE_SECURE_PROCESSING. Когда функция:

• true: реализация ограничит обработку XML, чтобы соответствовать ограничениям реализации. Примеры включают ограничения расширения сущностей и конструкции XML Schema, которые потребляли бы большое количество ресурсов. Если обработка XML ограничена по соображениям безопасности, это будет сообщено через вызов зарегистрированного ErrorHandler.fatalError(SAXParseException exception). См. setErrorHandler(ErrorHandler errorHandler).
• false: реализация будет обрабатывать XML в соответствии со спецификациями XML без учёта возможных ограничений реализации.

public void setProperty(String name, Object object) throws SAXNotRecognizedException, SAXNotSupportedException

Устанавливает значение свойства.

Имя свойства — любой полносинтаксический URI. ValidatorHandler может распознать имя свойства, но не сможет изменить текущее значение. Некоторые значения свойств могут быть неизменяемыми или изменяемыми только в определённых контекстах, например, до, во время или после валидации.

ValidatorHandler не обязаны распознавать какие-либо конкретные имена свойств.

public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException

Получает значение свойства.

Имя свойства — любой полносинтаксический URI. ValidatorHandler может распознать имя свойства, но временно не сможет вернуть его значение. Некоторые значения свойств доступны только в определённых контекстах, например, до, во время или после валидации.

ValidatorHandler не обязаны распознавать какие-либо конкретные имена свойств.

Реализаторы свободны (и им рекомендуется) придумывать свои собственные свойства, используя имена, основанные на своих собственных URI.