Класс ValidatorHandler

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

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

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

Когда указан 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 об этом исключении уведомляться не должно.

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

Обработчик ошибок может быть использован для настройки процесса обработки ошибок во время валидации. Когда установлен 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.

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.

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

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

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

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

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

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

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

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

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

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

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

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

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