Класс Validator

protected Validator()

public abstract void reset()

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)

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)

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.

public abstract ErrorHandler getErrorHandler()

Возвращает:

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

См. также:

• setErrorHandler(ErrorHandler)

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.

public abstract LSResourceResolver getResourceResolver()

Возвращает:

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

См. также:

• setErrorHandler(ErrorHandler)

public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException

Параметры:

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

Возвращает:

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

Исключения:

SAXNotRecognizedException — если значение функции невозможно назначить или получить.

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

NullPointerException — если параметр name имеет значение null.

См. также:

• setFeature(String, boolean)

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

Параметры:

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

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

Исключения:

SAXNotRecognizedException — если значение функции невозможно назначить или получить.

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

NullPointerException — если параметр name имеет значение null.

См. также:

• getFeature(String)

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

Параметры:

name — имя свойства, представляющее собой ненулевой URI с полным указанием.

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

Исключения:

SAXNotRecognizedException — если значение свойства невозможно назначить или получить.

SAXNotSupportedException — если Validator распознает имя свойства, но не может задать запрашиваемое значение.

NullPointerException — если параметр name имеет значение null.

public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException

Параметры:

name — имя свойства, представляющее собой ненулевой URI с полным указанием.

Возвращает:

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

Исключения:

SAXNotRecognizedException — если значение свойства невозможно назначить или получить.

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

NullPointerException — если параметр name имеет значение null.

См. также:

• setProperty(String, Object)