Модуль java.xml

• API 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 и не изменяются после этого.

Конфигурационный файл

Конфигурационные файлы — это файлы 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, для попытки найти и загрузить реализацию сервиса, используя механизм загрузки по умолчанию: модуль загрузки поставщиков услуг будет использовать текущий контекстный загрузчик классов потока current thread's context class loader для попытки загрузить сервис. Если контекстный загрузчик классов потока равен 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.