Класс CatalogManager

java.lang.Object
- javax.xml.catalog.CatalogManager

public final class CatalogManager
extends Object

Менеджер каталога управляет созданием XML каталогов и разрешителей каталогов.

Since:: 9

Методы

Модификатор и тип	Метод	Описание
`static Catalog`	`catalog(CatalogFeatures features, URI... uris)`	Создает объект `Catalog` используя указанные параметры настроек и URI(s) к одному или нескольким файлам каталога.
`static CatalogResolver`	`catalogResolver(Catalog catalog)`	Создаёт экземпляр `CatalogResolver` используя указанный каталог.
`static CatalogResolver`	`catalogResolver(CatalogFeatures features, URI... uris)`	Создает экземпляр `CatalogResolver` используя указанные параметры настроек и uri(s) к одному или нескольким файлам каталога.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы

catalog

public static Catalog catalog(CatalogFeatures features,
                              URI... uris)

Создаёт объект Catalog используя указанные параметры настроек и uri(s) к одному или нескольким файлам каталога.

Если uris пустой, системная переменная javax.xml.catalog.files, как определено в CatalogFeatures, будет использована для определения начального списка файлов каталога.

Если несколько файлов каталога указаны через аргумент uris или системную переменную javax.xml.catalog.files, то первая запись считается основным каталогом, а другие — альтернативными каталогами после тех, на которые ссылаются элементы nextCatalog в основном каталоге.

Как указано в XML Catalogs, Стандарт OASIS V1.1, если запись каталога недействительна, она игнорируется. В случае, если все записи недействительны, результирующий объект Catalog не будет содержать элементов Catalog. Любая операция сопоставления, использующая каталог, вернёт null.

Parameters:: features — параметры каталога; uris — uri(s) к одному или нескольким каталогам.
Returns:: экземпляр Catalog
Throws:: IllegalArgumentException — если URI не абсолютные или не имеют обработчика протокола URL для схемы URI; CatalogException — если произошла ошибка при разборе каталога; SecurityException — если доступ к ресурсу запрещен менеджером безопасности

catalogResolver

public static CatalogResolver catalogResolver(Catalog catalog)

Создаёт экземпляр CatalogResolver используя указанный каталог.

Parameters:: catalog — экземпляр каталога
Returns:: экземпляр CatalogResolver

catalogResolver

public static CatalogResolver catalogResolver(CatalogFeatures features,
                                              URI... uris)

Создаёт экземпляр CatalogResolver используя указанные параметры настроек и uri(s) к одному или нескольким файлам каталога.

Если uris пустой, системная переменная javax.xml.catalog.files, как определено в CatalogFeatures, будет использована для определения начального списка файлов каталога.

Если несколько файлов каталога указаны через аргумент uris или системную переменную javax.xml.catalog.files, то первая запись считается основным каталогом, а другие — альтернативными каталогами после тех, на которые ссылаются элементы nextCatalog в основном каталоге.

Как указано в XML Catalogs, Стандарт OASIS V1.1, если запись каталога недействительна, она игнорируется. В случае, если все записи недействительны, результирующий объект CatalogResolver не будет содержать действительных каталогов. Любая операция разрешения, использующая разрешитель, вернёт результат о том, что сопоставление не найдено. См. CatalogResolver для поведения, когда сопоставление не найдено.

Parameters:: features — параметры каталога; uris — uri(s) к одному или нескольким каталогам
Returns:: экземпляр CatalogResolver
Throws:: IllegalArgumentException — если URI не абсолютные или не имеют обработчика протокола URL для схемы URI; CatalogException — если произошла ошибка при разборе каталога; SecurityException — если доступ к ресурсу запрещен менеджером безопасности