-
public interface Catalog
Catalogクラスは、「XMLカタログ、OASIS標準V1.1、2005年10月7日」によって定義されたエンティティ・カタログを表します。カタログは、カタログ・エントリのリストを含むルート
catalog
エントリを含むXMLファイルです。 エントリは、group
エントリでグループ化することもできます。 catalogおよびgroupエントリは、パブリックまたはシステム型のエントリの優先度と相対URIを解決するためのベースURIを設定するprefer
およびxml:base
属性を指定できます。カタログは、次の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
によって作成されると、現在のカタログ(すなわち、入力リストの最初のもの)を除いたカタログ・ファイルの入力として返されます。String
matchPublic(String publicId)
publicIdによってカタログ内の一致するエントリを検索しようとします。String
matchSystem(String systemId)
systemIdによってカタログ内の一致するエントリを検索しようとします。String
matchURI(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
がpublic
であり、system
エントリが見つからない場合にのみ、公開エントリが検討されます。解像度は以下のステップに従います:
- 一致する
public
エントリが見つかった場合、直ちにそれが戻されます。 - 複数の
delegatePublic
エントリが一致する場合、最も長い一致するpublicIdStartString
値を持つ一致エントリが返されます。
- パラメータ:
publicId
- 一致するエンティティの公開識別子- 戻り値:
- マッピングが見つかった場合はURI文字列、そうでない場合はnull
- 関連項目:
CatalogFeatures.Feature
- 一致する
-
matchURI
String matchURI(String uri)
uri要素によってカタログ内の一致するエントリを検索しようとします。このメソッドは、一致するものを見つけるために、現在のカタログの
uri, rewriteURI, uriSuffix, delegateURI
とgroup
エントリを含むuri-typeエントリを検索します。解像度は以下のステップに従います:
- 一致する
uri
エントリが見つかった場合、直ちにそれが戻されます。 - 複数の
rewriteURI
エントリが一致する場合、最も長い正規化されたuriStartString
値を持つ一致するエントリが返されます。 - 複数の
uriSuffix
エントリが一致する場合、最も長い正規化されたuriSuffix
値を持つ一致するエントリが返されます。 - 複数の
delegatePublic
エントリが一致する場合、最も長い一致するuriStartString
値を持つ一致エントリが返されます。
- パラメータ:
uri
- 一致するエンティティのURI参照- 戻り値:
- マッピングが見つかった場合はURI文字列、そうでない場合はnull
- 一致する
-
catalogs
Stream<Catalog> catalogs()
現在のカタログのnextCatalog
エントリを使用して指定された代替カタログの連続ストリームを返します。カタログ・オブジェクトがCatalogManager
によって作成されると、現在のカタログ(すなわち、入力リストの最初のもの)を除いたカタログ・ファイルの入力として返されます。返されるストリーム内のカタログの順序は、対応する
nextCatalog
エントリが現在のカタログに表示される順序と同じです。 入力ファイル・リストの代替カタログは、入力された順にストリームの最後に追加されます。- 戻り値:
- カタログの連続ストリーム
-
-