org.xml.sax
インタフェース DTDHandler

既知のサブインタフェースの一覧:

TransformerHandler

既知の実装クラスの一覧:

DefaultHandler, HandlerBase, XMLFilterImpl

public interface DTDHandler

標準 DTD 関連イベントの通知を受け取ります。

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。

表記法や未構文解析のエンティティに関する情報が必要な場合、SAX アプリケーションはこのインタフェースを実装し、パーサの setDTDHandler メソッドを使ってインスタンスを SAX パーサに登録します。パーサはこのインスタンスを使って、表記法や未構文解析のエンティティの宣言をアプリケーションに報告します。

このインタフェースには、XML 勧告でプロセッサが報告しなければならないとされている DTD イベント (表記法と未構文解析エンティティの宣言) だけが含まれます。

SAX パーサは、これらのイベントを、表記法や未構文解析のエンティティが宣言された順序とは関係なく、任意の順序で報告します。ただし、すべての DTD イベントは、文書ハンドラの startDocument イベントのあとと最初の startElement イベントの前で報告されなければなりません。

将来使用できるように情報をハッシュテーブルやオブジェクトツリー内に格納するアプリケーションと、そうでないアプリケーションがあります。"NOTATION"、"ENTITY" または "ENTITIES" 型の属性が検出された場合、アプリケーションはこのインタフェースから取得した情報を使って属性値に対応するエンティティや表記法を検出できます。

導入されたバージョン:

SAX 1.0

関連項目:

Parser.setDTDHandler(org.xml.sax.DTDHandler), HandlerBase

メソッドの概要

void	notationDecl(String name, String publicId, String systemId) 表記法宣言イベントの通知を受け取ります。
void	unparsedEntityDecl(String name, String publicId, String systemId, String notationName) 未構文解析エンティティ宣言イベントの通知を受け取ります。

メソッドの詳細

notationDecl

public void notationDecl(String name,
                         String publicId,
                         String systemId)
                  throws SAXException

表記法宣言イベントの通知を受け取ります。

あとで参照できるように表記法を記録するアプリケーションと、記録しないアプリケーションがあります。

1 個以上の publicId および systemId が null 以外の値でなければなりません。システム識別子が存在し、これが URL である場合、SAX パーサはこの識別子をこのイベントからアプリケーションに渡す前に完全に解決する必要があります。

表記法宣言がこれを使用する未構文解析エンティティの前に報告されるかどうかは保証されていません。

パラメータ:

name - 表記法名

publicId - 表記法の公開識別子。指定されていない場合は null

systemId - 表記法のシステム識別子。指定されていない場合は null

例外:

SAXException - SAX 例外。ほかの例外をラップしている可能性がある

関連項目:

unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String), AttributeList

unparsedEntityDecl

public void unparsedEntityDecl(String name,
                               String publicId,
                               String systemId,
                               String notationName)
                        throws SAXException

未構文解析エンティティ宣言イベントの通知を受け取ります。

表記法名は、notationDecl イベントによって報告される表記法に一致しています。あとで参照できるようにエンティティを記録するアプリケーションと、記録しないアプリケーションがあります。

システム識別子が URL の場合、パーサはこれをアプリケーションに渡す前に完全に解決する必要があります。

パラメータ:

name - 未構文解析エンティティ名

publicId - エンティティの公開識別子。指定されていない場合は null

systemId - エンティティのシステム識別子

例外:

SAXException - SAX 例外。ほかの例外をラップしている可能性がある

関連項目:

notationDecl(java.lang.String, java.lang.String, java.lang.String), AttributeList