Класс CatalogFeatures

[1] Для функций, помеченных как "N/A", системного свойства не существует.

[2] Значение должно быть точно таким же, как указано в этой таблице, регистрозависимым. Любое не указанное значение приведёт к IllegalArgumentException.

[3] Спецификация каталога определяет сложные правила для атрибута prefer. Хотя prefer может быть public или system, спецификация фактически делает system предпочтительным вариантом, то есть независимо от варианта, системная запись всегда используется, если найдена. Общедоступные записи рассматриваются только в том случае, если prefer — public, и системные записи не найдены. Поэтому рекомендуется устанавливать атрибут prefer в значение public (по умолчанию).

[4] Хотя нестандартные атрибуты в спецификации OASIS Catalog, defer и resolve распознаются API Java Catalog так же, как prefer, как атрибут в записи каталога основного каталога. Обратите внимание, что будут использоваться только атрибуты, указанные для записи каталога основного файла каталога.

[5] Если цель состоит в совместном использовании всего каталога, целесообразно установить свойство javax.xml.catalog.defer в значение false, чтобы позволить предварительно загрузить весь каталог.

Область действия и порядок

Свойства, указанные в качестве атрибутов в файле каталога для записей каталога и групп, будут иметь приоритет перед любыми другими настройками. Например, если атрибут prefer задан в файле каталога, как в <catalog prefer="public">, любая другая информация для свойства "prefer" не требуется или будет проигнорирована.

Свойства, заданные через API каталога, переопределяют свойства, которые могли быть заданы системными свойствами и/или в jaxp.properties. В случае нескольких интерфейсов приоритет будет иметь последний в процедуре. Для CatalogFeatures.Feature.FILES это означает, что URI(и), указанные с помощью методов класса CatalogManager, переопределят любые, которые могли быть введены через CatalogFeatures.Builder.

Системные свойства, если они заданы, будут иметь приоритет над теми, которые находятся в jaxp.properties.

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

Экземпляр CatalogFeatures может быть создан с помощью своего конструктора, как показано в следующем фрагменте кода:

                CatalogFeatures f = CatalogFeatures.builder()
                        .with(Feature.FILES, "file:///etc/xml/catalog")
                        .with(Feature.PREFER, "public")
                        .with(Feature.DEFER, "true")
                        .with(Feature.RESOLVE, "ignore")
                        .build();
 

Поддержка JAXP XML-процессоров

      SAXParserFactory spf = SAXParserFactory.newInstance();
      spf.setFeature(XMLConstants.USE_CATALOG, true); [1]
      SAXParser parser = spf.newSAXParser();
      parser.setProperty(CatalogFeatures.Feature.FILES.getPropertyName(), "file:///etc/xml/catalog");
 

[1] Обратите внимание, что это утверждение не требуется, так как значение по умолчанию для USE_CATALOG равно true.

Поддержка каталога в процессорах JAXP зависит как от функции USE_CATALOG, так и от существования корректного(ых) файла(ов) каталога. Процессор JAXP будет использовать каталог только в том случае, если функция имеет значение true, и действительный(ые) файл(ы) каталога указаны через свойство javax.xml.catalog.files. Он не будет пытаться использовать каталог, если USE_CATALOG установлено в false, или файл каталога не указан.

Процессоры JAXP будут использовать настройки по умолчанию класса CatalogFeatures. Например, процессоры будут по умолчанию сообщать об исключении, если совпадение не найдено, так как значение по умолчанию свойства javax.xml.catalog.resolve равно strict.

Процессоры JAXP отдают предпочтение пользовательским настраиваемым разрешителям. Если такой разрешитель зарегистрирован, он будет использован вместо CatalogResolver. Однако, если он возвращает null, процессоры продолжат разрешение с CatalogResolver. Если он возвращает пустой источник, CatalogResolver не будет пытаться выполнить разрешение.

Поддержка каталога доступна для любого процесса в библиотеке JAXP, который поддерживает разрешитель. В следующей таблице перечислены все такие процессы.

Процессы с поддержкой каталога

   The following DTD reference:
   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

   Can be resolved using the following Catalog entry:
   <public publicId="-//W3C//DTD XHTML 1.0 Strict//EN" uri="catalog/xhtml1-strict.dtd"/>
   or
   <systemSuffix systemIdSuffix="html1-strict.dtd" uri="catalog/xhtml1-strict.dtd"/>
 

   The following XInclude element:
   <xi:include href="http://openjdk.java.net/xml/disclaimer.xml"/>

   can be resolved using a URI entry:
   <uri name="http://openjdk.java.net/xml/disclaimer.xml" uri="file:///pathto/local/disclaimer.xml"/>
   or
   <uriSuffix uriSuffix="disclaimer.xml" uri="file:///pathto/local/disclaimer.xml"/>
 

   The following import element:
    <xsd:import namespace="http://openjdk.java.net/xsd/XSDImport_person"
                schemaLocation="http://openjdk.java.net/xsd/XSDImport_person.xsd"/>

   can be resolved using a URI entry:
   <uri name="http://openjdk.java.net/xsd/XSDImport_person.xsd" uri="file:///pathto/local/XSDImport_person.xsd"/>
   or
   <uriSuffix uriSuffix="XSDImport_person.xsd" uri="file:///pathto/local/XSDImport_person.xsd"/>
   or
   <uriSuffix uriSuffix="http://openjdk.java.net/xsd/XSDImport_person" uri="file:///pathto/local/XSDImport_person.xsd"/>
 

   The following include element:
   <xsd:include schemaLocation="http://openjdk.java.net/xsd/XSDInclude_person.xsd"/>

   can be resolved using a URI entry:
   <uri name="http://openjdk.java.net/xsd/XSDInclude_person.xsd" uri="file:///pathto/local/XSDInclude_person.xsd"/>
   or
   <uriSuffix uriSuffix="XSDInclude_person.xsd" uri="file:///pathto/local/XSDInclude_person.xsd"/>
 

   The following include element:
   <xsl:include href="http://openjdk.java.net/xsl/include.xsl"/>

   can be resolved using a URI entry:
   <uri name="http://openjdk.java.net/xsl/include.xsl" uri="file:///pathto/local/include.xsl"/>
   or
   <uriSuffix uriSuffix="include.xsl" uri="file:///pathto/local/include.xsl"/>
 

   The document in the following element:
   <xsl:variable name="dummy" select="document('http://openjdk.java.net/xsl/list.xml')"/>

   can be resolved using a URI entry:
   <uri name="http://openjdk.java.net/xsl/list.xml" uri="file:///pathto/local/list.xml"/>
   or
   <uriSuffix uriSuffix="list.xml" uri="file:///pathto/local/list.xml"/>