Класс Validator

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

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

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

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

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

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

Для проверки одного Source в другой вид Result, используйте трансформатор тождества (см. TransformerFactory.newTransformer()).

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

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

Обработчик ошибок можно использовать для настройки процесса обработки ошибок во время проверки. Если обработчик ошибок 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.

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.

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

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

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

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

Имя свойства — любой полностью квалифицированный 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).

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

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

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