public interface DTDHandler
org.xml.sax.DTDHandler |
Known Indirect Subclasses |
接收基本DTD相关事件的通知。
This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY. See http://www.saxproject.org for further information.
如果SAX应用程序需要关于记号和未分析实体的信息,那么应用程序将实现此接口,并使用解析器的setDTDHandler方法向SAX解析器注册一个实例。 解析器使用该实例向应用程序报告记法和未解析的实体声明。
请注意,此接口仅包含XML建议 要求处理器报告的DTD事件:符号和未分离的实体声明。
SAX解析器可以以任何顺序报告这些事件,而不管符号和未分析实体的声明顺序如何; 但是,必须在文档处理程序的startDocument事件之后和第一个startElement事件之前报告所有DTD事件。 (如果使用LexicalHandler
则必须在endDTD事件之前报告这些事件。)
这取决于应用程序存储信息以备将来使用(可能位于散列表或对象树中)。 如果应用程序遇到类型为“NOTATION”,“ENTITY”或“ENTITIES”的属性,它可以使用它通过此接口获得的信息来查找与属性值相对应的实体和/或符号。
也可以看看:
Public methods |
|
---|---|
abstract void |
notationDecl(String name, String publicId, String systemId) 接收记谱声明事件的通知。 |
abstract void |
unparsedEntityDecl(String name, String publicId, String systemId, String notationName) 接收未解析实体声明事件的通知。 |
void notationDecl (String name, String publicId, String systemId)
接收记谱声明事件的通知。
如有必要,应由记录记录符号供以后参考; 符号可能以属性值的形式出现在未解析的实体声明中,并且有时用于处理指令目标名称。
publicId和systemId中的至少一个必须是非空的。 如果系统标识符存在,并且它是一个URL,则在通过此事件将SAX解析器传递给应用程序之前,SAX解析器必须完全解析它。
无法保证在使用它的任何未分析的实体之前会报告符号声明。
Parameters | |
---|---|
name |
String : The notation name. |
publicId |
String : The notation's public identifier, or null if none was given. |
systemId |
String : The notation's system identifier, or null if none was given. |
Throws | |
---|---|
SAXException |
Any SAX exception, possibly wrapping another exception. |
void unparsedEntityDecl (String name, String publicId, String systemId, String notationName)
接收未解析实体声明事件的通知。
请注意,符号名称对应于notationDecl
事件报告的符号。 如有必要,由申请记录实体供日后参考; 未分析的实体可能会显示为属性值。
如果系统标识符是URL,则解析器必须在将其传递给应用程序之前将其完全解析。
Parameters | |
---|---|
name |
String : The unparsed entity's name. |
publicId |
String : The entity's public identifier, or null if none was given. |
systemId |
String : The entity's system identifier. |
notationName |
String : The name of the associated notation. |
Throws | |
---|---|
SAXException |
Any SAX exception, possibly wrapping another exception. |