T.M. SoftStudio

feci quod potui, faciant meliora potentes

JAXP API

Пакет javax.xml.validation

Пакет javax.xml.validation обеспечивает программный интерфейс для проверки XML-документов относительно их описания.

Для проверки XML-документов относительно описания их структуры пакет javax.xml.validation предоставляет два класса: Validator и ValidatorHandler.

Класс Validator позволяет работать с объектами javax.xml.transform.Source, представляющими проверяемые XML-документы, и имеет следующие методы.

  • public abstract void reset()

Сбрасывает объект Validator в его исходное состояние, тем самым обеспечивая его повторное использование.

  • public abstract void validate(Source source, Result result)

public void validate(Source source)

Осуществляют проверку определенного XML-документа или XML-элемента.

  • public abstract void setErrorHandler(ErrorHandler errorHandler)

public abstract ErrorHandler getErrorHandler()

Первый метод устанавливает, второй метод возвращает объект org.xml.sax.ErrorHandler, получающий уведомления об ошибках в процессе проверки XML-документа.

  • public abstract void setResourceResolver(LSResourceResolver
    resourceResolver)

public abstract LSResourceResolver getResourceResolver()

Первый метод устанавливает, второй метод возвращает объект org.w3c.dom.ls.LSResourceResolver, используемый для разрешения ссылок на внешние ресурсы.

  • public void setFeature(String name, boolean value)

public boolean getFeature(String name)

public void setProperty(String name, Object object)

public Object getProperty(String name)

Первая пара методов устанавливает и возвращает режимы реализации, вторая пара методов — свойста реализации.

Класс ValidatorHandler реализует интерфейс org.xml.sax.ContentHandler и обеспечивает проверку SAX-потоков, проверяя, соответствуют ли SAX-события ограничениям описания структуры XML-документа. Класс ValidatorHandler дополнительно к методам интерфейса ContentHandler имеет следующие методы.

  • public abstract void setContentHandler(ContentHandler receiver)

public abstract ContentHandler getContentHandler()

Первый метод устанавливает, второй метод возвращает объект ContentHandler, получающий результат проверки.

  • public abstract void setErrorHandler(ErrorHandler errorHandler)

public abstract ErrorHandler getErrorHandler()

Первый метод устанавливает, второй метод возвращает объект org.xml.sax.ErrorHandler, получающий уведомления об ошибках в процессе проверки.

  • public abstract void setResourceResolver(LSResourceResolver
    resourceResolver)

public abstract LSResourceResolver getResourceResolver()

Первый метод устанавливает, второй метод возвращает объект org.w3c.dom.ls.LSResourceResolver, используемый для разрешения ссылок на внешние ресурсы.

  • public abstract TypeInfoProvider getTypeInfoProvider()

Возвращает объект javax.xml.validation.TypeInfoProvider, обеспечивающий доступ к информации о типах данных атрибута или элемента. Класс TypeInfoProvider имеет методы:

    – public abstract TypeInfo getElementTypeInfo() — возвращает объект org.w3c.dom.TypeInfo, представляющий тип данных текущего элемента;

    – public abstract TypeInfo getAttributeTypeInfo(int index) — возвращает тип данных определенного атрибута текущего элемента;

    – public abstract boolean isIdAttribute(int index) — возвращает true, если атрибут является идентификатором;

    – public abstract boolean isSpecified(int index) — возвращает false, если атрибут был добавлен валидатором.

  • public void setFeature(String name, boolean value)

public boolean getFeature(String name)

public void setProperty(String name, Object object)

public Object getProperty(String name)

Первая пара методов устанавливает и возвращает режимы реализации, вторая пара методов — свойста реализации.

Объекты Validator и ValidatorHandler создаются с помощью методов public abstract Validator newValidator() и public abstract ValidatorHandler newValidatorHandler() класса javax.xml.validation.Schema, представляющего описание структуры XML-документа или его схему, созданную с использованием таких языков как Document Type Definition (DTD), W3C XML Schema (WXS), RELAX NG (RNG), Schematron и др.

Для создания объектов Schema пакет javax.xml.validation предоставляет класс-фабрику SchemaFactory, который имеет следующие методы.

  • public static final SchemaFactory newInstance(String schemaLanguage)

public static SchemaFactory newInstance(String schemaLanguage,
String factoryClassName, ClassLoader classLoader)

Создает объект SchemaFactory реализации с поддержкой указанного языка, например, XMLConstants.W3C_XML_SCHEMA_NS_URI или XMLConstants.RELAXNG_NS_URI.

  • public abstract boolean isSchemaLanguageSupported(String schemaLanguage)

Возвращает true, если объект SchemaFactory поддрживает указанный язык описания структуры XML-документа.

  • public boolean getFeature(String name)

public void setFeature(String name, boolean value)

public void setProperty(String name, Object object)

public Object getProperty(String name)

Первая пара методов устанавливает и возвращает режимы реализации, вторая пара методов — свойства реализации.

  • public abstract void setErrorHandler(ErrorHandler errorHandler)

public abstract ErrorHandler getErrorHandler()

Первый метод устанавливает, второй метод возвращает объект org.xml.sax.ErrorHandler, получающий уведомления об ошибках в процессе компиляции схемы XML-документа.

  • public abstract void setResourceResolver(LSResourceResolver
    resourceResolver)

public abstract LSResourceResolver getResourceResolver()

Первый метод устанавливает, второй метод возвращает объект org.w3c.dom.ls.LSResourceResolver, используемый для разрешения ссылок на внешние ресурсы в процессе компиляции схемы XML-документа.

  • public Schema newSchema(Source schema)

public Schema newSchema(File schema)

public Schema newSchema(URL schema)

public abstract Schema newSchema(Source[] schemas)

public abstract Schema newSchema()

Подготавливают схему XML-документа к использованию для проверки XML-документов путем создания объекта Schema.