模块  java.xml
软件包  org.xml.sax.helpers

Class DefaultHandler

    • 构造方法详细信息

      • DefaultHandler

        public DefaultHandler()
    • 方法详细信息

      • startDocument

        public void startDocument()                   throws SAXException
        接收文档开头的通知。

        默认情况下,什么也不做。 应用程序编写者可以在子类中重写此方法,以在文档的开头采取特定操作(例如,分配树的根节点或创建输出文件)。

        Specified by:
        startDocument接口 ContentHandler
        异常
        SAXException - 任何SAX异常,可能包含另一个异常。
        另请参见:
        ContentHandler.startDocument()
      • endDocument

        public void endDocument()                 throws SAXException
        接收文档结束的通知。

        默认情况下,什么也不做。 应用程序编写者可以在子类中重写此方法,以在文档末尾执行特定操作(例如,完成树或关闭输出文件)。

        Specified by:
        endDocument接口 ContentHandler
        异常
        SAXException - 任何SAX异常,可能包含另一个异常。
        另请参见:
        ContentHandler.endDocument()
      • startElement

        public void startElement​(String uri,                         String localName,                         String qName,                         Attributes attributes)                  throws SAXException
        接收元素开始的通知。

        默认情况下,什么也不做。 应用程序编写者可以在子类中重写此方法,以在每个元素的开头采取特定操作(例如,分配新的树节点或将输出写入文件)。

        Specified by:
        startElement接口 ContentHandler
        参数
        uri - 名称空间URI,如果元素没有名称空间URI或者未执行名称空间处理,则为空字符串。
        localName - 本地名称(不带前缀),如果未执行命名空间处理,则为空字符串。
        qName - 限定名称(带前缀),如果限定名称不可用,则为空字符串。
        attributes - 附加到元素的属性。 如果没有属性,则它应为空的Attributes对象。
        异常
        SAXException - 任何SAX异常,可能包含另一个异常。
        另请参见:
        ContentHandler.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)
      • endElement

        public void endElement​(String uri,                       String localName,                       String qName)                throws SAXException
        接收元素结束的通知。

        默认情况下,什么也不做。 应用程序编写者可以在子类中重写此方法,以在每个元素的末尾执行特定操作(例如,最终确定树节点或将输出写入文件)。

        Specified by:
        endElement接口 ContentHandler
        参数
        uri - 名称空间URI,如果元素没有名称空间URI或者未执行名称空间处理,则为空字符串。
        localName - 本地名称(不带前缀),如果未执行命名空间处理,则为空字符串。
        qName - 限定名称(带前缀),如果限定名称不可用,则为空字符串。
        异常
        SAXException - 任何SAX异常,可能包含另一个异常。
        另请参见:
        ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)
      • characters

        public void characters​(char[] ch,                       int start,                       int length)                throws SAXException
        接收元素内的字符数据通知。

        默认情况下,什么也不做。 应用程序编写者可以覆盖此方法,以对每个字符数据块执行特定操作(例如将数据添加到节点或缓冲区,或将其打印到文件中)。

        Specified by:
        characters接口 ContentHandler
        参数
        ch - 人物。
        start - 字符数组中的起始位置。
        length - 字符数组中使用的字符数。
        异常
        SAXException - 任何SAX异常,可能包含另一个异常。
        另请参见:
        ContentHandler.characters(char[], int, int)
      • ignorableWhitespace

        public void ignorableWhitespace​(char[] ch,                                int start,                                int length)                         throws SAXException
        接收元素内容中可忽略空白的通知。

        默认情况下,什么也不做。 应用程序编写者可以重写此方法,以便为每个可忽略的空白块采取特定操作(例如将数据添加到节点或缓冲区,或将其打印到文件中)。

        Specified by:
        ignorableWhitespace在界面 ContentHandler
        参数
        ch - 空格字符。
        start - 字符数组中的起始位置。
        length - 字符数组中要使用的字符数。
        异常
        SAXException - 任何SAX异常,可能包含另一个异常。
        另请参见:
        ContentHandler.ignorableWhitespace(char[], int, int)
      • fatalError

        public void fatalError​(SAXParseException e)                throws SAXException
        报告致命的XML解析错误。

        默认实现抛出SAXParseException。 如果需要针对每个致命错误采取特定操作(例如将所有错误收集到单个报告中),应用程序编写者可以在子类中覆盖此方法:在任何情况下,应用程序必须在调用此方法时停止所有常规处理,因为文档不再可靠,并且解析器可能不再报告解析事件。

        Specified by:
        fatalError接口 ErrorHandler
        参数
        e - 编码为异常的错误信息。
        异常
        SAXException - 任何SAX异常,可能包含另一个异常。
        另请参见:
        ErrorHandler.fatalError(org.xml.sax.SAXParseException)SAXParseException