モジュール java.xml
パッケージ javax.xml.catalog

クラスCatalogManager

  • public final class CatalogManager
extends Object
    カタログ・マネージャは、XMLカタログとカタログ・リゾルバの作成を管理します。
    導入されたバージョン:
    9

    • メソッドの詳細

      • catalog

        public static Catalog catalog​(CatalogFeatures features,
                              URI... uris)
        指定された機能設定を使用してCatalogオブジェクトを作成し、1つ以上のカタログ・ファイルにuriを作成します。

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

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

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

        パラメータ:
        features - カタログ機能
        uris - 1つまたは複数のカタログへのURI。
        戻り値:
        Catalogのインスタンス
        例外:
        IllegalArgumentException - URIが絶対的でないか、URIスキームのURLプロトコル・ハンドラを持たない場合
        CatalogException - カタログの解析中にエラーが発生した場合
        SecurityException - リソースへのアクセスがセキュリティ・マネージャによって拒否された場合

      • catalogResolver

        public static CatalogResolver catalogResolver​(Catalog catalog)
        指定されたカタログを使用してCatalogResolverのインスタンスを作成します。
        パラメータ:
        catalog - カタログ・インスタンス
        戻り値:
        CatalogResolverのインスタンス

      • catalogResolver

        public static CatalogResolver catalogResolver​(CatalogFeatures features,
                                              URI... uris)
        指定された機能設定を使用してCatalogResolverのインスタンスを作成し、1つ以上のカタログ・ファイルにuriを作成します。

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

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

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

        パラメータ:
        features - カタログ機能
        uris - 1つ以上のカタログへのURI
        戻り値:
        CatalogResolverのインスタンス
        例外:
        IllegalArgumentException - URIが絶対的でないか、URIスキームのURLプロトコル・ハンドラを持たない場合
        CatalogException - カタログの解析中にエラーが発生した場合
        SecurityException - リソースへのアクセスがセキュリティ・マネージャによって拒否された場合