Класс CatalogManager

java.lang.Object

javax.xml.catalog.CatalogManager

public final class CatalogManager extends Object

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

Начиная с:: 9

Краткое описание методов

Модификатор и тип	Метод	Описание
`static Catalog`	`catalog(CatalogFeatures features, URI... uris)`	Создает объект `Catalog` с указанными настройками функций и URI одного или нескольких файлов каталогов.
`static CatalogResolver`	`catalogResolver(Catalog catalog)`	Создает экземпляр `CatalogResolver` с использованием указанного каталога.
`static CatalogResolver`	`catalogResolver(CatalogFeatures features, URI... uris)`	Создает экземпляр `CatalogResolver` с указанными настройками функций и URI одного или нескольких файлов каталогов.
`static CatalogResolver`	`catalogResolver(Catalog catalog, CatalogResolver.NotFoundAction action)`	Создает `CatalogResolver`, который разрешает внешние ссылки с заданным `catalog` и типом `action`, определяющим поведение в случае невозможности разрешить ссылку.

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

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

Подробное описание методов

catalog

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

Создает объект Catalog с указанными настройками функций и URI одного или нескольких файлов каталогов.

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

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

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

Параметры:: features — функции каталога; uris — URI одного или нескольких каталогов.
Возвращает:: экземпляр Catalog
Вызывает исключение:: IllegalArgumentException — если URI не являются абсолютными или для схемы URI отсутствует обработчик протокола URL; CatalogException — если при разборе каталога произошла ошибка

catalogResolver

public static CatalogResolver catalogResolver(Catalog catalog)

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

Примечание API:: Объект CatalogResolver, созданный этим методом, делегирует разрешение базовому свойству RESOLVE объекта catalog. Поведение объекта CatalogResolver, созданного методом catalogResover(Catalog, CatalogResolver.NotFoundAction), при невозможности разрешить ссылку зависит от указанного типа действия.
Параметры:: catalog — экземпляр каталога
Возвращает:: экземпляр CatalogResolver

catalogResolver

public static CatalogResolver catalogResolver(Catalog catalog, CatalogResolver.NotFoundAction action)

Создает CatalogResolver, который разрешает внешние ссылки с заданным catalog и типом action, определяющим поведение в случае невозможности разрешить ссылку.

Типы action сопоставляются со значениями свойства RESOLVE.

Параметры:: catalog — экземпляр каталога; action — действие, которое следует выполнить, если ссылку не удается разрешить
Возвращает:: объект CatalogResolver с типом catalog и action
Начиная с:: 22

catalogResolver

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

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

Согласно спецификации XML Catalogs, стандарт OASIS, версия 1.1, недопустимая запись каталога игнорируется. Если все записи недопустимы, результирующий объект CatalogResolver не будет содержать допустимых каталогов. Поэтому при любой операции разрешения с использованием распознавателя будет возвращено отсутствие найденного соответствия. Поведение в случае отсутствия соответствия описано в CatalogResolver.

Параметры:: features — функции каталога; uris — URI одного или нескольких каталогов
Возвращает:: экземпляр CatalogResolver
Вызывает исключение:: IllegalArgumentException — если URI не являются абсолютными или для схемы URI отсутствует обработчик протокола URL; CatalogException — если при разборе каталога произошла ошибка

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml/javax/xml/catalog/CatalogManager.html