javax.xml.validation

Блок проверки допустимости класса

java.lang. Объект

javax.xml.validation. Блок проверки допустимости

public abstract class Validator
extends Object

Процессор, который проверяет XML-документ по Schema.

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

С тех пор:

1.5

Сводка конструктора

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

Модификатор	Конструктор и Описание
protected	Validator() Конструктор для производных классов.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
abstract ErrorHandler	getErrorHandler() Получает ток ErrorHandler набор к этому Validator.
boolean	getFeature(String name) Ищите значение значения параметра.
Объект	getProperty(String name) Ищите значение свойства.
abstract LSResourceResolver	getResourceResolver() Получает ток LSResourceResolver набор к этому Validator.
abstract void	reset() Сбросьте это Validator к его исходной конфигурации.
abstract void	setErrorHandler(ErrorHandler errorHandler) Наборы ErrorHandler получить ошибки, с которыми встречаются во время validate вызов метода.
void	setFeature(String name, boolean value) Установите значение значения параметра.
void	setProperty(String name, Object object) Установите значение свойства.
abstract void	setResourceResolver(LSResourceResolver resourceResolver) Наборы LSResourceResolver настроить разрешение ресурса в то время как в эпизоде проверки допустимости.
void	validate(Source source) Проверяет указанного ввода.
abstract void	validate(Source source, Result result) Проверяет указанного ввода, и отправьте увеличенный результат проверки допустимости указанному выводу.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

Блок проверки допустимости

protected Validator()

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

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

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

Деталь метода

сброс

public abstract void reset()

Сбросьте это Validator к его исходной конфигурации.

Validator сбрасывается к тому же самому состоянию как тогда, когда оно создавалось с Schema.newValidator(). reset() разрабатывается, чтобы позволить повторное использование существующих Validators таким образом сохраняющий ресурсы, связанные с созданием новых Validators.

Сброс Validator как гарантируют, не будет иметь то же самое LSResourceResolver или ErrorHandler Objects, например. Object.equals(Object obj). Это, как гарантируют, будет иметь функционально равный LSResourceResolver и ErrorHandler.

проверить

public void validate(Source source)
              throws SAXException,
                     IOException

Проверяет указанного ввода.

Это - только метод удобства для validate(Source source, Result result) с result из null.

Параметры:

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

Броски:

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

SAXException - Если ErrorHandler броски a SAXException или если фатальная ошибка находится и ErrorHandler возвраты обычно.

IOException - Если блок проверки допустимости обрабатывает a SAXSource и базовое XMLReader броски IOException.

NullPointerException - Если source null.

См. Также:

validate(Source source, Result result)

проверить

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

Проверяет указанного ввода, и отправьте увеличенный результат проверки допустимости указанному выводу.

Этот метод устанавливает следующие ограничения для типов Source/Result принятый.

Source / Result Принятый
	StreamSource	SAXSource	DOMSource	StAXSource
null	OK	OK	OK	OK
StreamResult	OK	IllegalArgumentException	IllegalArgumentException	IllegalArgumentException
SAXResult	IllegalArgumentException	OK	IllegalArgumentException	IllegalArgumentException
DOMResult	IllegalArgumentException	IllegalArgumentException	OK	IllegalArgumentException
StAXResult	IllegalArgumentException	IllegalArgumentException	IllegalArgumentException	OK

Проверить того Source в другого отчасти Result, используйте преобразователь идентификационных данных (см. TransformerFactory.newTransformer()).

Ошибки, найденные во время проверки допустимости, отправляются указанному ErrorHandler.

Если документ допустим, или если документ содержит некоторые ошибки, но ни один из них не был фатальным и ErrorHandler не выдавал исключения, тогда возвраты метода обычно.

Параметры:

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

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

Броски:

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

SAXException - Если ErrorHandler броски a SAXException или если фатальная ошибка находится и ErrorHandler возвраты обычно.

IOException - Если блок проверки допустимости обрабатывает a SAXSource и базовое XMLReader броски IOException.

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

См. Также:

validate(Source source)

setErrorHandler

public abstract void setErrorHandler(ErrorHandler errorHandler)

Наборы ErrorHandler получить ошибки, с которыми встречаются во время validate вызов метода.

Обработчик ошибок может использоваться, чтобы настроить процесс обработки ошибок во время проверки допустимости. Когда ErrorHandler устанавливается, ошибки, найденные во время проверки допустимости, будут сначала отправлены ErrorHandler.

Обработчик ошибок может сразу прервать дальнейшую проверку допустимости, бросая SAXException от обработчика. Или например это может напечатать ошибку на экран и попытаться продолжать проверку допустимости, возвращаясь обычно из ErrorHandler

Если любой Throwable бросается от ErrorHandler, вызывающая сторона validate метод будет брошен то же самое Throwable объект.

Validator не позволяется бросить SAXException без первого создания отчетов об этом к ErrorHandler.

Когда 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
     }
 }
 

Когда новое Validator объект создается, первоначально это поле, устанавливают в NULL.

Параметры:

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

getErrorHandler

public abstract ErrorHandler getErrorHandler()

Получает ток ErrorHandler набор к этому Validator.

Возвраты:

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

См. Также:

setErrorHandler(ErrorHandler)

setResourceResolver

public abstract void setResourceResolver(LSResourceResolver resourceResolver)

Наборы LSResourceResolver настроить разрешение ресурса в то время как в эпизоде проверки допустимости.

Validator использование a LSResourceResolver когда это должно определить местоположение внешних ресурсов, в то время как проверка допустимости, хотя точно то, что составляет "располагающиеся внешние ресурсы", до каждого языка схемы.

Когда LSResourceResolver нуль, реализация будет вести себя как будто следующий LSResourceResolver устанавливается:

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

         return null; // always return null
     }
 }
 

Если a LSResourceResolver броски a RuntimeException (или экземпляры его производных классов), тогда Validator прервет парсинг и вызывающую сторону validate метод получит то же самое RuntimeException.

Когда новое Validator объект создается, первоначально это поле, устанавливают в NULL.

Параметры:

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

getResourceResolver

public abstract LSResourceResolver getResourceResolver()

Получает ток LSResourceResolver набор к этому Validator.

Возвраты:

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

См. Также:

setErrorHandler(ErrorHandler)

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Ищите значение значения параметра.

Имя функции является любым полностью определенным URI. Это возможно для a Validator распознать имя функции, но временно быть неспособными возвратить его значение. Некоторые значения функции могут быть доступными только в определенных контекстах, такой как прежде, во время, или после проверки допустимости.

Конструкторы свободны (и поощренный) изобрести свои собственные функции, используя имена, основанные на их собственных URI.

Параметры:

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

Возвраты:

Текущая стоимость функции (истина или ложь).

Броски:

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

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

NullPointerException - Когда параметр имени является нулем.

См. Также:

setFeature(String, boolean)

setFeature

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

Установите значение значения параметра.

Функция может быть использована, чтобы управлять путем a Validator схемы синтаксических анализов, хотя Validators не обязаны распознавать любые определенные имена функции.

Имя функции является любым полностью определенным URI. Это возможно для a Validator представить значение функции, но быть неспособными изменить текущую стоимость. Некоторые значения функции могут быть неизменными или изменчивыми только в определенных контекстах, такой как прежде, во время, или после проверки допустимости.

Параметры:

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

value - Требуемое значение функции (истина или ложь).

Броски:

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

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

NullPointerException - Когда параметр имени является нулем.

См. Также:

getFeature(String)

setProperty

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

Установите значение свойства.

Имя свойства является любым полностью определенным URI. Это возможно для a Validator распознать имя свойства, но быть неспособными изменить текущую стоимость. Некоторые значения свойств могут быть неизменными или изменчивыми только в определенных контекстах, такой как прежде, во время, или после проверки допустимости.

Validators не обязаны распознавать определение любых определенных имен свойства.

Параметры:

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

object - Требуемое значение для свойства.

Броски:

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

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

NullPointerException - Когда параметр имени является нулем.

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Ищите значение свойства.

Имя свойства является любым полностью определенным URI. Это возможно для a Validator распознать имя свойства, но временно быть неспособными возвратить его значение. Некоторые значения свойств могут быть доступными только в определенных контекстах, такой как прежде, во время, или после проверки допустимости.

Validators не обязаны распознавать любые определенные имена свойства.

Конструкторы свободны (и поощренный) изобрести свои собственные свойства, используя имена, основанные на их собственных URI.

Параметры:

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

Возвраты:

Текущая стоимость свойства.

Броски:

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

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

NullPointerException - Когда параметр имени является нулем.

См. Также:

setProperty(String, Object)