Класс 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 с полным указанием и не равное null.

Возвращает:

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

Исключения:

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

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

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

См. также:

• setFeature(String, boolean)

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

Параметры:

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

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

Исключения:

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

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

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

См. также:

• getFeature(String)

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

Параметры:

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

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

Исключения:

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

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

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

public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException

Параметры:

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

Возвращает:

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

Исключения:

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

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

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

См. также:

• setProperty(String, Object)