Класс ValidatorHandler

protected ValidatorHandler()

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

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

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

public abstract void setContentHandler(ContentHandler receiver)

Задает ContentHandler, получающий дополненный результат проверки.

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

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

public abstract ContentHandler getContentHandler()

Возвращает ContentHandler, получающий дополненный результат проверки.

public abstract void setErrorHandler(ErrorHandler errorHandler)

Задает 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.

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.