XMLカタログ

XMLドキュメントは通常、外部エンティティを参照します。たとえば、ドキュメントタイプ定義のパブリック ID やシステム ID などです。これらの外部関係は、URI (通常は URL) を使用して表現されます。

ただし、絶対 URL はネットワークがアクセスできる場合にのみ機能します。リモートリソースに依存すると、XML 処理は計画されたネットワークダウンタイムと計画外のネットワークダウンタイムの両方の影響を受けやすくなります。

相対 URL は、最初に作成されたコンテキストでのみ役立ちます。たとえば、URL「../../xml/dtd/docbookx.xml」は通常、非常に限られた状況でのみ役立ちます。

これらの問題を回避する方法の 1 つは、エンティティリゾルバ ( SAXの標準機能) または URI リゾルバ ( JAXPの標準機能) を使用することです。リゾルバは、要求されているリソースの URI を調べ、その要求を満たす最善の方法を決定します。XMLカタログは、外部エンティティ参照とローカルにキャッシュされた同等のものとの間のマッピングを記述するドキュメントです。^[1]

Catalog.xml の例

次の簡単なカタログは、たとえば XHTML ページ検証ツールにローカルにキャッシュされた DTD を提供する方法を示しています。

 
  <?xml version="1.0"?> 
<!DOCTYPE catalog     PUBLIC "-//OASIS//DTD エンティティ解決 XML カタログ V1.0//EN"            "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">  



  <catalog xmlns= "urn:oasis:names:tc:entity:xmlns:xml:catalog" prefer= "public" > 
           

    <public publicId= "-//W3C//DTD XHTML 1.0 Strict//EN" uri= "dtd/xhtml1/xhtml1-strict.dtd" /> 
            

    <public publicId= "-//W3C//DTD XHTML 1.0 Transitional//EN" uri= "dtd/xhtml1/xhtml1-transitional.dtd" /> 
            

    <public publicId= "-//W3C//DTD XHTML 1.1//EN" uri= "dtd/xhtml11/xhtml11-flat.dtd" /> 
            

  </カタログ>

-//W3C//DTD XHTML 1.0 Strict//ENこのカタログにより、ローカル URI への解決が可能になりますdtd/xhtml1/xhtml1-strict.dtd。同様に、他の 2 つのパブリック ID のローカル URI も提供されます。

上記のドキュメントには DOCTYPE が含まれていることに注意してください。これにより、カタログリゾルバーが完全に機能する前に、パーサーが DOCTYPE のシステム ID URL (つまり ) にアクセスしようとする可能性がhttp://www.oasis-open.org/committees/entity/release/1.0/catalog.dtdありますが、これは望ましくない可能性があります。これを防ぐには、DOCTYPE 宣言を削除するだけです。

次の例はこれを示しており、宣言<system/>の代替として同等の宣言も示しています<public/>。

  <?xml version="1.0"?> 
<catalog xmlns= "urn:oasis:names:tc:entity:xmlns:xml:catalog" >   

    <システム システムID = "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" uri = "dtd/xhtml1/xhtml1-strict.dtd" /> 
            

    <システム システムID = "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" uri = "dtd/xhtml1/xhtml1-transitional.dtd" /> 
            

    <システム システムID = "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd" uri = "dtd/xhtml11/xhtml11-flat.dtd" /> 
            

  </カタログ>

カタログの使用 – Java SAX の例

カタログリゾルバは、さまざまなプログラミング言語で使用できます。次の例は、Java でSAXパーサを作成して、org.apache.xml.resolver.tools.CatalogResolver外部エンティティをローカルにキャッシュされたインスタンスに解決するために使用される入力ソースを解析する方法を示しています。このリゾルバはApache Xercesから派生したものですが、現在は Sun Java ランタイムに含まれています。

ファクトリを使用して標準的な方法でを作成する必要がありますSAXParser。XML リーダーエンティティリゾルバは、デフォルトまたはカスタムのものに設定する必要があります。

  最終的なSAXParser saxParser = SAXParserFactory.newInstance ( ) . newSAXParser ( ) ;最終的なXMLReader reader = saxParser.getXMLReader ();    
      

  最終的なContentHandlerハンドラー= ...;最終的なInputSource入力= ...;    
      

  reader.setEntityResolver ( new CatalogResolver ( ) ) ; reader.setContentHandler ( handler ) ; reader.parse ( input ) ;

SAX パーサーで はなくparse、リーダーでメソッドを呼び出すことが重要です。

参考文献

^ Walsh, Norman (2005年10月7日). 「XMLカタログOASIS標準V1.1」(PDF) . OASIS (pdf) . 2023年11月4日閲覧。

XML カタログ。OASIS 標準、バージョン 1.1。2005 年 10 月 7 日。
XML エンティティおよび URI リゾルバ、Sun
SourceForge の XML カタログマネージャープロジェクト

[1] Walsh, Norman (2005年10月7日). 「XMLカタログOASIS標準V1.1」(PDF) . OASIS (pdf) . 2023年11月4日閲覧。