Класс CatalogFeatures

• java.lang.Object
• • javax.xml.catalog.CatalogFeatures

public class CatalogFeatures
extends Object

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

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

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

[4] Несмотря на то, что нестандартные атрибуты в спецификации OASIS Catalog, defer и resolve, распознаются API каталога Java так же, как 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"/>

С момента:

9