Класс 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-схемы, которые будут потреблять большое количество ресурсов. Если обработка 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.