Класс Validator

protected Validator()

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

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

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

public abstract void reset()

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

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

Сброшенный Validator не гарантирует, что у него будут те же раз решатель ресурсов LSResourceResolver или обработчик ошибок ErrorHandler Object, например, Object.equals(Object obj). Гарантируется функционально эквивалентный LSResourceResolver и ErrorHandler.

public void validate(Source source) throws SAXException, IOException

Проверяет указанный вход.

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

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 не выбросил никаких исключений, метод возвращается нормально.

public abstract void setErrorHandler(ErrorHandler errorHandler)

Устанавливает обработчик ошибок ErrorHandler для получения ошибок, обнаруженных во время вызова метода validate.

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

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

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

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

Если обработчик ошибок ErrorHandler равен null, реализация будет вести себя так, как если бы был установлен следующий обработчик ошибок 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.

public abstract ErrorHandler getErrorHandler()

Получает текущий обработчик ошибок ErrorHandler, установленный для этого валидатора Validator.

public abstract void setResourceResolver(LSResourceResolver resourceResolver)

Устанавливает LSResourceResolver для настройки разрешения ресурсов во время валидации.

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

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

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

         return null; // always return null
     }
 }
 

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

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

public abstract LSResourceResolver getResourceResolver()

Получает текущий LSResourceResolver, установленный для этого валидатора Validator.

public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException

Получение значения флага функции.

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

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

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

Установка значения флага функции.

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

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

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

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

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

Все реализации, которые реализуют JAXP 1.5 или более позднюю версию, должны поддерживать свойства XMLConstants.ACCESS_EXTERNAL_DTD и XMLConstants.ACCESS_EXTERNAL_SCHEMA.

• Доступ к внешним DTD в исходном или схеме ограничен протоколами, указанными в свойстве XMLConstants.ACCESS_EXTERNAL_DTD. Если доступ запрещён во время валидации из-за ограничения этого свойства, SAXException будет выброшен методом validate(Source).

  Доступ к внешним ссылкам, заданным атрибутом schemaLocation, ограничен протоколами, указанными в свойстве XMLConstants.ACCESS_EXTERNAL_SCHEMA. Если доступ запрещён во время валидации из-за ограничения этого свойства, SAXException будет выброшен методом validate(Source).

public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException

Получение значения свойства.

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

Валидаторы Validator не обязаны распознавать какие-либо конкретные имена свойств.

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