Module  java.xml
软件包  org.xml.sax.helpers

Class DefaultHandler

    • 构造方法详细信息

      • DefaultHandler

        public DefaultHandler​()

    • 方法详细信息

      • resolveEntity

        public InputSource resolveEntity​(String publicId,
                                 String systemId)
                          throws IOException,
                                 SAXException
        解决外部实体。

        始终返回null，以便解析器将使用XML文档中提供的系统标识符。 此方法实现SAX默认行为：应用程序编写者可以在子类中覆盖它，以执行特殊翻译，如目录查找或URI重定向。

        Specified by:
        resolveEntity在接口 EntityResolver
        参数
        publicId - 公共标识符，如果没有可用，则为null。
        systemId - XML文档中提供的系统标识符。
        结果
        新的输入源，或null，以要求默认行为。
        异常
        IOException - 如果设置新输入源时出现错误。
        SAXException - 任何SAX异常，可能包含另一个异常。
        另请参见：
        EntityResolver.resolveEntity(java.lang.String, java.lang.String)

      • 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