クラス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を作成します。

    クラスオブジェクトで宣言されたメソッド

    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()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • メソッドの詳細

    • 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 - カタログの解析中にエラーが発生した場合

    • 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 - カタログの解析中にエラーが発生した場合