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

クラスCatalogManager

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

    • メソッドの詳細

      • catalog

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

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

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

        XML Catalogs、 OASIS Standard V1.1で指定されているように、カタログ・エントリが無効な場合は無視されます。 すべてのエントリが無効な場合、結果のカタログ・オブジェクトにはカタログ要素が含まれません。 カタログを使用するすべての照合操作は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)
        指定された機能設定および1つ以上のカタログ・ファイルへのURIを使用して、CatalogResolverのインスタンスを作成します。

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

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

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

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