Класс ValidatorHandler

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

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

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

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

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

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

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

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

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

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

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

Если метод ErrorHandler выбрасывает какое-либо Throwable, тот же объект 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; это также рекомендуется.