-
public interface CatalogCatalogクラスは、XML Catalogs、 OASIS Standard V1.1、 7 October 2005で定義されているエンティティ・カタログを表します。カタログは、カタログ・エントリのリストを含むルート
catalogエントリを含むXMLファイルです。 エントリは、groupエントリでグループ化することもできます。 カタログ・エントリおよびグループ・エントリでは、preferおよびxml:base属性を指定できます。この属性は、相対URIを解決するために、パブリック・エントリまたはシステム・タイプのエントリとベースURIのプリファレンスを設定します。カタログは、次の2つの状況で使用できます。
- 公開識別子またはシステム識別子を持つ外部リソースを見つけます。
- URIを含む代替URI参照を見つけます。
ケース1では、標準で6つの外部識別子エントリが定義されています。
public, system, rewriteSystem, systemSuffix, delegatePublic, and delegateSystem。ケース2では、次の4つのURIエントリを定義します。
uri, rewriteURI, uriSuffix and delegateURI前述のエントリ・タイプに加えて、カタログではnextCatalogエントリを定義して、カタログ・エントリ・ファイルを追加できます。
- 導入されたバージョン:
- 9
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 Stream<Catalog>catalogs()現在のカタログのnextCatalogエントリを使用して指定された代替カタログの順次ストリームを返します。また、CatalogManagerによってカタログ・オブジェクトが作成されたときに、現在のカタログ(つまり、入力リストの先頭)を除くカタログ・ファイルの入力として返します。StringmatchPublic(String publicId)publicIdによって、カタログ内で一致するエントリを検索しようとします。StringmatchSystem(String systemId)systemIdによって、カタログ内で一致するエントリを検索しようとします。StringmatchURI(String uri)uri要素でカタログ内の一致するエントリを検索しようとしています。
-
-
-
メソッドの詳細
-
matchSystem
String matchSystem(String systemId)
systemIdによって、カタログ内で一致するエントリを検索しようとします。このメソッドは、一致を検索するために、現在のカタログ内の
system, rewriteSystem, systemSuffix, delegateSystemおよびgroupエントリを含むシステム・タイプのエントリを検索します。解決方法は、次に示すステップに従います。
- 一致する
systemエントリが存在する場合は、即時に返されます。 - 複数の
rewriteSystemエントリが一致する場合は、正規化されたsystemIdStartString値が最も長い一致するエントリが返されます。 - 複数の
systemSuffixエントリが一致する場合は、正規化されたsystemIdSuffix値が最も長い一致するエントリが返されます。 - 複数の
delegateSystemエントリが一致する場合は、一致するsystemIdStartString値が最も長い一致するエントリが返されます。
- パラメータ:
systemId- 照合されるエンティティのシステム識別子- 戻り値:
- マッピングが見つかった場合はURI文字列、それ以外の場合はnull
- 一致する
-
matchPublic
String matchPublic(String publicId)
publicIdによって、カタログ内で一致するエントリを検索しようとします。 このメソッドは、一致を検索するために、現在のカタログ内のpublic, delegatePublicおよびgroupエントリを含むパブリック・タイプのエントリを検索します。クラス
CatalogFeaturesの表カタログ機能の機能PREFERに関する説明を参照してください。 パブリック・エントリは、preferがpublicで、systemエントリが見つからない場合にのみ考慮されます。解決方法は、次に示すステップに従います。
- 一致する
publicエントリが見つかった場合は、すぐに返されます。 - 複数の
delegatePublicエントリが一致する場合は、一致するpublicIdStartString値が最も長い一致するエントリが返されます。
- パラメータ:
publicId- 照合されるエンティティの公開識別子- 戻り値:
- マッピングが見つかった場合はURI文字列、それ以外の場合はnull
- 関連項目:
CatalogFeatures.Feature
- 一致する
-
matchURI
String matchURI(String uri)
uri要素でカタログ内の一致するエントリを検索しようとしています。このメソッドは、一致を検索するために、現在のカタログ内の
uri, rewriteURI, uriSuffix, delegateURIおよびgroupエントリを含むURIタイプのエントリを検索します。解決方法は、次に示すステップに従います。
- 一致する
uriエントリが見つかった場合は、すぐに返されます。 - 複数の
rewriteURIエントリが一致する場合は、正規化されたuriStartString値が最も長い一致するエントリが返されます。 - 複数の
uriSuffixエントリが一致する場合は、正規化されたuriSuffix値が最も長い一致するエントリが返されます。 - 複数の
delegatePublicエントリが一致する場合は、一致するuriStartString値が最も長い一致するエントリが返されます。
- パラメータ:
uri- 照合されるエンティティのURI参照- 戻り値:
- マッピングが見つかった場合はURI文字列、それ以外の場合はnull
- 一致する
-
catalogs
Stream<Catalog> catalogs()
現在のカタログのnextCatalogエントリを使用して指定された代替カタログの順次ストリームを返します。また、CatalogManagerによってカタログ・オブジェクトが作成されたときに、現在のカタログ(つまり、入力リストの先頭)を除くカタログ・ファイルの入力として返します。返されたストリームのカタログの順序は、対応する
nextCatalogエントリが現在のカタログに表示される順序と同じです。 入力ファイル・リストの代替カタログは、入力された順序でストリームの最後に追加されます。- 戻り値:
- カタログの順次ストリーム
-
-