Класс ValidatorHandler

Потоковый валидатор, работающий с потоком SAX.

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

ValidatorHandler проверяет, следуют ли события SAX набору ограничений, описанных в ассоциированной Schema, и дополнительно может изменять события SAX (например, добавляя значения по умолчанию и т.д.).

ValidatorHandler расширяет ContentHandler, но уточняет базовый ContentHandler следующим образом:

1. События startElement/endElement должны получать непустые строки для uri, localName, и qname, даже если SAX разрешает некоторые из них быть null. Аналогично, заданный пользователем ContentHandler получит непустые строки для всех трех параметров.
2. Приложения должны гарантировать, что ValidatorHandler правильно вызывают ContentHandler.startPrefixMapping(String,String) и ContentHandler.endPrefixMapping(String). Аналогично, заданный пользователем ContentHandler получит события startPrefixMapping/endPrefixMapping. Если ValidatorHandler вводит дополнительные связи пространств имен, заданный пользователем ContentHandler получит дополнительные события startPrefixMapping/endPrefixMapping.
3. Attributes для метода ContentHandler.startElement(String,String,String,Attributes) может или не может содержать атрибуты xmlns*.

Объект ValidatorHandler автоматически сбрасывается каждый раз при вызове метода startDocument.

Распознаваемые свойства и функции

Этот стандарт определяет следующую функцию, которую должны распознавать все реализации ValidatorHandler.

http://xml.org/sax/features/namespace-prefixes

Эта функция контролирует, как ValidatorHandler вводит связи пространств имен, которые отсутствовали в исходном потоке событий SAX. При установке этой функции в значение true, необходимо убедиться, что пользовательский ContentHandler увидит соответствующий атрибут xmlns* в объекте Attributes обратного вызова ContentHandler.startElement(String,String,String,Attributes). В противном случае, атрибуты xmlns* не должны добавляться к Attributes, переданному указанному пользователем ContentHandler.

(Обратите внимание, что независимо от этого переключателя, связи пространств имен всегда сообщаются приложениям через методы ContentHandler.startPrefixMapping(String,String) и ContentHandler.endPrefixMapping(String) заданного пользователем ContentHandler.)

Обратите внимание, что эта функция НЕ влияет на способ получения ValidatorHandler событий SAX. Она просто изменяет способ дополнения им событий SAX.

Эта функция установлена в значение false по умолчанию.

Конструкторы

ValidatorHandler

protected ValidatorHandler()

Методы

setContentHandler

public abstract void setContentHandler(ContentHandler receiver)

Параметры:

receiver - ContentHandler или значение null.

getContentHandler

public abstract ContentHandler getContentHandler()

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

Возвращает:

Этот метод возвращает объект, который был в последний раз задан с помощью метода getContentHandler(), или null, если этот метод никогда не вызывался с момента создания этого ValidatorHandler.

См. также:

setContentHandler(ContentHandler)

setErrorHandler

public abstract void setErrorHandler(ErrorHandler 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
     }
 }

Параметры:

errorHandler - Новый обработчик ошибок для установки. Этот параметр может быть null.

getErrorHandler

public abstract ErrorHandler getErrorHandler()

Возвращает текущего ErrorHandler, установленного для этого ValidatorHandler.

Возвращает:

Этот метод возвращает объект, который был в последний раз задан с помощью метода setErrorHandler(ErrorHandler), или null, если этот метод никогда не вызывался с момента создания этого ValidatorHandler.

См. также:

setErrorHandler(ErrorHandler)

setResourceResolver

public abstract void setResourceResolver(LSResourceResolver resourceResolver)

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

         return null; // always return null
     }
 }

Параметры:

resourceResolver - Новый разрешитель ресурсов для установки. Этот параметр может быть null.

getResourceResolver

public abstract LSResourceResolver getResourceResolver()

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

Возвращает:

Этот метод возвращает объект, который был в последний раз задан с помощью метода setResourceResolver(LSResourceResolver), или null, если этот метод никогда не вызывался с момента создания этого ValidatorHandler.

См. также:

setErrorHandler(ErrorHandler)

getTypeInfoProvider

public abstract TypeInfoProvider getTypeInfoProvider()

Возвращает:

null, если валидатор/язык схемы не поддерживает понятие TypeInfo. В противном случае возвращается непустой действительный TypeInfoProvider.

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Параметры:

name - Имя функции, которое представляет собой непустой полностью квалифицированный URI.

Возвращает:

Текущее значение функции (true или false).

Исключения:

SAXNotRecognizedException - Если значение функции не может быть присвоено или получено.

SAXNotSupportedException - Если ValidatorHandler распознаёт имя функции, но не может определить его значение в данный момент.

NullPointerException - Когда name имеет значение null.

См. также:

setFeature(String, boolean)

setFeature

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

Параметры:

name - Имя функции, которое является непустым полностью квалифицированным URI.

value - Запрашиваемое значение функции (true или false).

Исключения:

SAXNotRecognizedException - Если значение функции не может быть назначено или получено.

SAXNotSupportedException - Когда ValidatorHandler распознает имя функции, но не может установить запрашиваемое значение.

NullPointerException - Когда name равно null.

См. также:

getFeature(String)

setProperty

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

Параметры:

name - Имя свойства, которое является непустым полностью квалифицированным URI.

object - Запрашиваемое значение свойства.

Исключения:

SAXNotRecognizedException - Если значение свойства нельзя назначить или получить.

SAXNotSupportedException - Когда ValidatorHandler распознаёт имя свойства, но не может установить запрашиваемое значение.

NullPointerException - Когда name равно null.

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Параметры:

name - Имя свойства, которое является непустым полностью квалифицированным URI.

Возвращает:

Текущее значение свойства.

Исключения:

SAXNotRecognizedException - Если значение свойства нельзя назначить или получить.

SAXNotSupportedException - Когда XMLReader распознаёт имя свойства, но не может определить его значение в данный момент.

NullPointerException - Когда name равно null.

См. также:

setProperty(String, Object)