Класс Validator

Обработчик, проверяющий XML-документ по Schema.

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

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

Validator

protected Validator()

Методы

reset

public abstract void reset()

validate

public void validate(Source source)
              throws SAXException,
                     IOException

Параметры:

source - XML для проверки. Должен быть XML-документом или XML-элементом и не должен быть null. Для обратной совместимости результаты попытки проверки чего-либо, кроме документа или элемента, зависят от реализации. Реализации должны либо распознать и обработать входные данные, либо бросить исключение IllegalArgumentException.

Исключения:

IllegalArgumentException - Если Source является XML-объектом, который реализация не может проверить (например, инструкция обработки).

SAXException - Если обработчик ошибок ErrorHandler бросает исключение SAXException или если обнаружена фатальная ошибка, и обработчик ошибок ErrorHandler возвращается без ошибок.

IOException - Если валидатор обрабатывает SAXSource и базовый XMLReader бросает исключение IOException.

NullPointerException - Если параметр source имеет значение null.

См. также:

validate(Source source, Result result)

validate

public abstract void validate(Source source,
                              Result result)
                       throws SAXException,
                              IOException

Параметры:

source - XML для проверки. Должен быть XML-документом или XML-элементом и не должен быть null. Для обратной совместимости результаты попытки проверки чего-либо, кроме документа или элемента, зависят от реализации. Реализации должны либо распознать и обработать входные данные, либо бросить исключение IllegalArgumentException.

result - Объект Result, который получает (возможно, дополненный) XML. Этот параметр может быть null, если вызывающая сторона не заинтересована в нём. Обратите внимание, что при использовании DOMResult, валидатор может просто передать тот же узел DOM из DOMSource в DOMResult (в этом случае source.getNode()==result.getNode()), он может скопировать всё дерево DOM или изменить узел, переданный из источника.

Исключения:

IllegalArgumentException - Если тип Result не соответствует типу Source или если Source является XML-объектом, который реализация не может проверить (например, инструкция обработки).

SAXException - Если ErrorHandler бросает исключение SAXException или если обнаружена фатальная ошибка, и ErrorHandler возвращается без ошибок.

IOException - Если валидатор обрабатывает SAXSource и базовый XMLReader бросает исключение IOException.

NullPointerException - Если параметр source имеет значение null.

См. также:

validate(Source source)

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, установленного для этого валидатора Validator.

Возвращает:

Метод возвращает объект, последний установленный через метод setErrorHandler(ErrorHandler), или null, если этот метод не был вызван с момента создания этого валидатора Validator.

См. также:

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, установленного для этого Validator.

Возвращает:

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

См. также:

setErrorHandler(ErrorHandler)

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Параметры:

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

Возвращает:

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

Исключения:

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

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

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

См. также:

setFeature(String, boolean)

setFeature

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

Параметры:

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

value - Требуемое значение функции (true или false).

Исключения:

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

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

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

См. также:

getFeature(String)

setProperty

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

Параметры:

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

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

Исключения:

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

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

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

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Параметры:

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

Возвращает:

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

Исключения:

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

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

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

См. также:

setProperty(String, Object)