Модуль java.xml

• API JAXP
• Фабрики и процессоры
• Настройка
  • Свойства JAXP
  • Системные свойства
  • Файл конфигурации JAXP
    • jaxp.properties файл
    • Пользовательский файл конфигурации
  • Порядок приоритета свойств
• Механизм поиска JAXP
  • Процедура поиска
• Примечание по реализации

API JAXP

• Парсинга: основанный на JAXP Parsing API, Document Object Model (DOM) и Simple API for XML Parsing (SAX), а также Streaming API for XML (StAX);
• Сериализации: StAX и Extensible Stylesheet Language Transformations (XSLT);
• Валидации: JAXP Validation API, основанный на языке определения схем XML;
• Трансформации: JAXP Transformation API или XSLT (расширяемый язык стилей преобразований);
• Запроса и обхода XML-документов: XML XPath Language API (XPath);
• Разрешения внешних ресурсов: XML Catalog API;

Фабрики и процессоры

Процессоры являются агрегатами парсеров (или читателей), сериализаторов (или писателей), валидаторов и трансформаторов, которые контролируют и выполняют обработку в соответствующих областях. Они определены в соответствующих пакетах. Например, в пакете parsers находятся DocumentBuilder и SAXParser, представляющие процессоры DOM и SAX.

Процессоры настраиваются и создаются с помощью соответствующих фабрик. Например, DocumentBuilder и SAXParser создаются с помощью DocumentBuilderFactory и SAXParserFactory соответственно.

Настройка

Свойства JAXP

Системные свойства

Точное время чтения системных свойств не определено. Для обеспечения правильного применения желаемых значений приложения должны убедиться, что системные свойства установлены должным образом до создания первой фабрики JAXP и не изменяются после этого.

Файл конфигурации JAXP

Файлы конфигурации — это файлы Java Properties, которые содержат соответствия между системными свойствами и их значениями, определенными различными API или процессами. Следующие записи в файле конфигурации демонстрируют установку свойств javax.xml.parsers.DocumentBuilderFactory и CatalogFeatures.RESOLVE:

   javax.xml.parsers.DocumentBuilderFactory=packagename.DocumentBuilderFactoryImpl
   javax.xml.catalog.resolve=strict

jaxp.properties файл

Файл jaxp.properties будет читаться только один раз во время инициализации реализации JAXP и кэшироваться в памяти. Если возникнет ошибка доступа к файлу или его чтения, процесс конфигурации продолжится так, как если бы файла не существовало.

Пользовательский файл конфигурации

При указании java.xml.config.file, файл конфигурации будет прочитан, и включенные свойства переопределят те же свойства, которые были определены в файле jaxp.properties. Если свойство java.xml.config.file не установлено во время инициализации реализации JAXP, дальнейших попыток проверить его существование не будет.

Значение java.xml.config.file должно содержать допустимый путь к файлу конфигурации. Если путь не является абсолютным, он будет рассматриваться как относительный к рабочей директории JVM. Если при чтении файла конфигурации возникнет ошибка, процесс конфигурации продолжится так, как если бы свойство java.xml.config.file не было установлено. Реализации могут по желанию вывести сообщение об ошибке.

Порядок приоритета свойств

• API фабрик или процессоров

• Системное свойство

• Пользовательский файл конфигурации

• Файл конфигурации JAXP по умолчанию jaxp.properties

• Значения по умолчанию для свойств JAXP. Если FSP истинно, значения по умолчанию будут установлены для безопасной обработки XML.

• Свойства, указанные в методах фабрик или процессоров, имеют наивысший приоритет. Следующий код эффективно устанавливает свойство RESOLVE в strict, независимо от настроек в других источниках конфигурации.

     DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
     dbf.setAttribute(CatalogFeatures.Feature.RESOLVE.getPropertyName(), "strict");
  

• Если свойство не установлено в фабрике, как в коде выше, будет использоваться системное свойство.

      // in the following example, the RESOLVE property is set to 'continue'
      // for the entire application
      java -Djavax.xml.catalog.resolve=continue myApp
  

• Если свойство не установлено в фабрике или с помощью системного свойства, то установка в файле конфигурации вступит в силу. Следующая запись устанавливает свойство в 'continue'.

      javax.xml.catalog.resolve=continue
  

• Если свойство не установлено нигде, оно будет разрешено до значения по умолчанию, которое равно 'strict'.

Механизм поиска JAXP

[2] где uri — параметр метода newInstance(uri).

Процедура поиска

• Системное свойство, перечисленное в столбце "Системное свойство" таблицы JAXP-фабрики выше

• Файл конфигурации (Configuration File)

• Модуль загрузки поставщиков сервисов, определённый классом ServiceLoader, для поиска и загрузки реализации сервиса с использованием механизма по умолчанию: модуль загрузки использует класс загрузки контекста текущей нити, для поиска сервиса. Если класс загрузки контекста нити равен null, используется класс загрузки системы.

  SchemaFactory

  В случае с SchemaFactory, каждый потенциальный поставщик сервиса должен реализовывать метод isSchemaLanguageSupported(String schemaLanguage). Возвращается первый найденный поставщик, поддерживающий указанный язык схемы.

  XPathFactory

  В случае с XPathFactory, каждый потенциальный поставщик сервиса должен реализовывать метод isObjectModelSupported(String objectModel). Возвращается первый найденный поставщик, поддерживающий указанную модель объекта.

• В противном случае возвращается реализация system-default, что эквивалентно вызову метода newDefaultInstance() or newDefaultFactory() , как показано в столбце "Системное значение по умолчанию" таблицы JAXP-фабрики выше.

  SchemaFactory

  В случае с SchemaFactory, должен быть платформенный стандарт по умолчанию SchemaFactory для W3C XML Schema.

  XPathFactory

  В случае с XPathFactory, должен быть платформенный стандарт по умолчанию XPathFactory для W3C DOM, т.е. DEFAULT_OBJECT_MODEL_URI.