モジュール java.xml

パッケージ javax.xml.catalog

クラスCatalogManager

java.lang.Object

javax.xml.catalog.CatalogManager

public final class CatalogManager extends Object

カタログ・マネージャは、XMLカタログおよびカタログ・リゾルバの作成を管理します。

導入されたバージョン:

9

メソッドのサマリー

修飾子と型	メソッド	説明
static Catalog	catalog(CatalogFeatures features, URI... uris)	指定された機能設定anduri(s)を使用して、1つ以上のカタログ・ファイルにCatalogオブジェクトを作成します。
static CatalogResolver	catalogResolver(Catalog catalog)	指定されたカタログを使用して、CatalogResolverのインスタンスを作成します。
static CatalogResolver	catalogResolver(CatalogFeatures features, URI... uris)	指定された機能設定anduri(s)を使用して、1つ以上のカタログ・ファイルにCatalogResolverのインスタンスを作成します。
static CatalogResolver	catalogResolver(Catalog catalog, CatalogResolver.NotFoundAction action)	参照を解決できないときの動作を決定する、指定されたcatalogおよびaction型の外部参照を解決するCatalogResolverを作成します。

クラスjava.lang.Objectで宣言されたメソッド

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

メソッドの詳細

catalog

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

指定された機能設定anduri(s)を使用して、1つ以上のカタログ・ファイルにCatalogオブジェクトを作成します。

urisが空の場合、CatalogFeaturesで定義されているシステム・プロパティjavax.xml.catalog.filesが読み取られ、カタログ・ファイルの初期リストが検索されます。

uris引数またはjavax.xml.catalog.filesプロパティを使用して複数のカタログ・ファイルが指定されている場合、最初のエントリはメイン・カタログとみなされ、他のエントリはメイン・カタログのnextCatalog要素によって参照されるカタログの後に代替カタログとして扱われます。

「XMLカタログ、OASIS標準V1.1」で指定されているように、カタログ・エントリが無効な場合、無視されます。 すべてのエントリが無効な場合、結果のカタログ・オブジェクトにはカタログ要素が含まれません。 カタログを使用する照合操作はnullを返します。

パラメータ:

features - カタログ機能

uris - uri(s)から1つ以上のカタログ。

戻り値:

Catalogのインスタンス

例外:

IllegalArgumentException - URIが絶対的でないか、URIスキームのURLプロトコル・ハンドラを持たない場合

CatalogException - カタログの解析中にエラーが発生した場合

SecurityException - リソースへのアクセスがセキュリティ・マネージャによって拒否された場合

catalogResolver

public static CatalogResolver catalogResolver(Catalog catalog)

指定されたカタログを使用して、CatalogResolverのインスタンスを作成します。

APIのノート:

このメソッドによって作成されたCatalogResolverは、基礎となるcatalogのRESOLVEプロパティに委譲されます。 catalogResover(Catalog, CatalogResolver.NotFoundAction)によって作成されたCatalogResolverは、参照を解決できない場合、指定されたアクション・タイプに基づきます。

パラメータ:

catalog - カタログ・インスタンス

戻り値:

CatalogResolverのインスタンス

catalogResolver

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

参照を解決できないときの動作を決定する、指定されたcatalogおよびaction型の外部参照を解決するCatalogResolverを作成します。

action型は、RESOLVEプロパティの値にマップされます。

パラメータ:

catalog - カタログ・インスタンス

action - 参照を解決できない場合に実行するアクション

戻り値:

catalogおよびaction型のCatalogResolver

導入されたバージョン:

22

catalogResolver

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

指定された機能設定anduri(s)を使用して、1つ以上のカタログ・ファイルにCatalogResolverのインスタンスを作成します。

urisが空の場合、CatalogFeaturesで定義されているシステム・プロパティjavax.xml.catalog.filesが読み取られ、カタログ・ファイルの初期リストが検索されます。

uris引数またはjavax.xml.catalog.filesプロパティを使用して複数のカタログ・ファイルが指定されている場合、最初のエントリはメイン・カタログとみなされ、他のエントリはメイン・カタログのnextCatalog要素によって参照されるカタログの後に代替カタログとして扱われます。

「XMLカタログ、OASIS標準V1.1」で指定されているように、カタログ・エントリが無効な場合、無視されます。 すべてのエントリが無効な場合、結果のCatalogResolverオブジェクトには有効なカタログが含まれません。 したがって、リゾルバを使用する解決操作は、マッピングが見つからないときに返されます。 マッピングが見つからない場合の動作については、CatalogResolverを参照してください。

パラメータ:

features - カタログ機能

uris - theuri(s)から1つ以上のカタログ

戻り値:

CatalogResolverのインスタンス

例外:

IllegalArgumentException - URIが絶対的でないか、URIスキームのURLプロトコル・ハンドラを持たない場合

CatalogException - カタログの解析中にエラーが発生した場合

SecurityException - リソースへのアクセスがセキュリティ・マネージャによって拒否された場合