Пакет javax.xml.validation

Этот пакет обеспечивает API для проверки допустимости XML-документов.

См.: Описание

Сводка класса

Класс	Описание
Схема	Неизменное представление в памяти грамматики.
SchemaFactory	Фабрика, которая создает Schema объекты. Точка входа к API проверки допустимости.
SchemaFactoryLoader	Фабрика, которая создает SchemaFactory.
TypeInfoProvider	Этот класс обеспечивает доступ к информации о типе, определенной ValidatorHandler.
Блок проверки допустимости	Процессор, который проверяет XML-документ по Schema.
ValidatorHandler	Потоковая передача блока проверки допустимости, который работает над потоком SAX.

Пакет javax.xml.validation Описание

Этот пакет обеспечивает API для проверки допустимости XML-документов. Проверка допустимости является процессом проверки, что XML-документ является экземпляром указанной XML-схемы. XML-схема определяет модель контента (также названный грамматикой или словарем), который представят его документы экземпляра.

Есть много популярных технологий, доступных для создания XML-схемы. Некоторые из самых популярных включают:

• Определение типа документа (DTD) - встроенный язык схемы XML.
• XML-схема W3C (WXS) - объектно-ориентированный язык XML-схемы. WXS также обеспечивает систему типов для того, чтобы она ограничила символьные данные XML-документа. WXS сохраняется Консорциумом World Wide Web (W3C) и является Рекомендацией W3C (то есть, ратифицированная спецификация стандарта W3C).
• ОСЛАБЬТЕ НАНОГРАММ (RNG) - основанный на образце, удобный для пользователя язык XML-схемы. Схемы RNG могут также использовать типы, чтобы ограничить данные символа XML. RNG сохраняется Организацией для Продвижения Стандартов Структурированной информации (ОАЗИС) и является и ОАЗИСОМ и ISO (Международная организация по стандартизации) стандарт.
• Schematron - основанный на правилах язык XML-схемы. Принимая во внимание, что DTD, WXS, и RNG разрабатываются, чтобы выразить структуру модели контента, Schematron разрабатывается, чтобы осуществить отдельные правила, которые являются трудными или невозможными выразить другими языками схемы. Schematron предназначается, чтобы добавить схему, записанную на структурном языке схемы такой как вышеупомянутое. Schematron находится в процессе становления стандартом ISO.

Предыдущие версии JAXP поддерживаемая проверка допустимости как функция синтаксического анализатора XML, представленного любым a SAXParser или DocumentBuilder экземпляр.

API проверки допустимости JAXP разъединяет проверку допустимости документа экземпляра от парсинга XML-документа. Это выгодно по нескольким причинам, некоторые из которых:

• Поддержка дополнительной схемы langauges. С JDK 1.5, две самых популярных реализации синтаксического анализатора JAXP, Crimson и Xerces, только поддерживают подмножество доступных языков XML-схемы. API Проверки допустимости обеспечивает стандартный механизм, через который приложения могут взять преимущества библиотек проверки допустимости специализации, которые поддерживают дополнительные языки схемы.
• Легкое время выполнения, связываясь экземпляра XML и схемы. Определение расположения схемы, чтобы использовать для проверки допустимости с синтаксическими анализаторами JAXP может сбить с толку. API Проверки допустимости делает этот процесс простым (см. пример ниже).

Пример использования. Следующий пример демонстрирует, как проверять XML-документа с API Проверки допустимости (для удобочитаемости, некоторую обработку исключений не показывают):

            
    // parse an XML document into a DOM tree
    DocumentBuilder parser = DocumentBuilderFactory.newInstance().newDocumentBuilder();
    Document document = parser.parse(new File("instance.xml"));

    // create a SchemaFactory capable of understanding WXS schemas
    SchemaFactory factory = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);

    // load a WXS schema, represented by a Schema instance
    Source schemaFile = new StreamSource(new File("mySchema.xsd"));
    Schema schema = factory.newSchema(schemaFile);

    // create a Validator instance, which can be used to validate an instance document
    Validator validator = schema.newValidator();

    // validate the DOM tree
    try {
        validator.validate(new DOMSource(document));
    } catch (SAXException e) {
        // instance document is invalid!
    }

JAXP парсинг API был интегрирован с API Проверки допустимости. Приложения могут создать a Schema с API проверки допустимости и партнером это с a DocumentBuilderFactory или a SAXParserFactory экземпляр при использовании DocumentBuilderFactory.setSchema(Schema) и SAXParserFactory.setSchema(Schema) методы. Недопустимо и установить схему и вызов setValidating(true) на фабрике синтаксического анализатора. Прежний метод заставит синтаксические анализаторы использовать новый API проверки допустимости; последний заставит синтаксические анализаторы использовать свои собственные внутренние средства проверки допустимости. Включение обеих из этих опций одновременно вызовет или избыточное поведение или состояния ошибки.