Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, «равен ли» этот объект другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

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. Поведение созданного методом catalogResover(Catalog, CatalogResolver.NotFoundAction) CatalogResolver определяется указанным типом действия, если ссылку невозможно разрешить.
Параметры:: 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.