|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface DTDHandler
標準 DTD 関連イベントの通知を受け取ります。
このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。詳細については、http://www.saxproject.org を参照してください。
表記法や解析対象外のエンティティーに関する情報が必要な場合、SAX アプリケーションはこのインタフェースを実装し、パーサーの setDTDHandler メソッドを使ってインスタンスを SAX パーサーに登録します。パーサーはこのインスタンスを使って、表記法や解析対象外のエンティティーの宣言をアプリケーションに報告します。
このインタフェースには、XML 勧告でプロセッサが報告しなければならないとされている DTD イベント (表記法と解析対象外エンティティーの宣言) だけが含まれます。
SAX パーサーは、これらのイベントを、表記法や解析対象外のエンティティーが宣言された順序とは関係なく、任意の順序で報告します。 ただし、すべての DTD イベントは、文書ハンドラの startDocument イベントのあとと最初の startElement イベントの前で報告されなければなりません。LexicalHandler
が使用されている場合、これらのイベントは endDTD event の前でも報告される必要があります。
将来使用できるように情報をハッシュテーブルやオブジェクトツリー内に格納するアプリケーションと、そうでないアプリケーションがあります。「NOTATION」、「ENTITY」または「ENTITIES」型の属性が検出された場合、アプリケーションはこのインタフェースから取得した情報を使って属性値に対応するエンティティーや表記法を検出できます。
XMLReader.setDTDHandler(org.xml.sax.DTDHandler)
メソッドの概要 | |
---|---|
void |
notationDecl(String name,
String publicId,
String systemId)
表記法宣言イベントの通知を受け取ります。 |
void |
unparsedEntityDecl(String name,
String publicId,
String systemId,
String notationName)
解析対象外エンティティー宣言イベントの通知を受け取ります。 |
メソッドの詳細 |
---|
void notationDecl(String name, String publicId, String systemId) throws SAXException
あとで参照できるように表記法を記録するアプリケーションと、記録しないアプリケーションがあります。 表記法は属性値として解析対象外エンティティーの宣言に表示されることがあり、処理命令のターゲット名で使用されることがあります。
1 個以上の publicId および systemId が null 以外の値でなければなりません。システム識別子が存在し、これが URL である場合、SAX パーサーはこの識別子をこのイベントからアプリケーションに渡す前に完全に解決する必要があります。
表記法宣言がこれを使用する解析対象外エンティティーの前に報告されるかどうかは保証されていません。
name
- 表記法名publicId
- 表記法の公開識別子。
指定されなかった場合は nullsystemId
- 表記法のシステム識別子。
指定されなかった場合は null
SAXException
- SAX 例外。
ほかの例外をラップしている可能性があるunparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)
,
Attributes
void unparsedEntityDecl(String name, String publicId, String systemId, String notationName) throws SAXException
表記法名は、notationDecl
イベントによって報告される表記法に一致しています。あとで参照できるようにエンティティーを記録するアプリケーションと、記録しないアプリケーションがあります。 解析対象外のエンティティーは属性値として表示されることがあります。
システム識別子が URL の場合、パーサーはこれをアプリケーションに渡す前に完全に解決する必要があります。
name
- 解析対象外エンティティー名publicId
- エンティティーの公開識別子。
指定されなかった場合は nullsystemId
- エンティティーのシステム識別子notationName
- 関連表記法名
SAXException
- SAX 例外。
ほかの例外をラップしている可能性があるnotationDecl(java.lang.String, java.lang.String, java.lang.String)
,
Attributes
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。