Module java.xml
Package org.xml.sax

Class HandlerBase

java.lang.Object
org.xml.sax.HandlerBase
所有已实现的接口:
DocumentHandler, DTDHandler, EntityResolver, ErrorHandler
@Deprecated(since="1.5") public class HandlerBase extends Object implements EntityResolver, DTDHandler, DocumentHandler, ErrorHandler
Deprecated.
This class works with the deprecated DocumentHandler interface. It has been replaced by the SAX2 DefaultHandler class.
处理程序的默认基类。

该类实现了四个SAX1接口的默认行为: EntityResolver、DTDHandler、DocumentHandler和ErrorHandler。现在已经过时，但在SAX2中包含以支持传统的SAX1应用程序。SAX2应用程序应该使用DefaultHandler类。

应用程序编写者可以在需要实现接口的部分时扩展此类；解析器编写者可以实例化此类以在应用程序未提供自己的处理程序时提供默认处理程序。

请注意，使用此类是可选的。

自从:
1.4, SAX 1.0
参见:

  • Constructor Details

    • HandlerBase

      public HandlerBase()
      Deprecated.
      创建一个HandlerBase。

  • Method Details

    • resolveEntity

      public InputSource resolveEntity(String publicId, String systemId) throws SAXException
      Deprecated.
      解析外部实体。

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

      指定者:
      resolveEntity 在接口 EntityResolver
      参数:
      publicId - 公共标识符，如果没有可用则为null。
      systemId - XML文档中提供的系统标识符。
      返回:
      新的输入源，或null以要求默认行为。
      抛出:
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见:

    • notationDecl

      public void notationDecl(String name, String publicId, String systemId)
      Deprecated.
      接收符号声明通知。

      默认情况下，不执行任何操作。如果应用程序编写者希望跟踪文档中声明的符号，则可以在子类中重写此方法。

      指定者:
      notationDecl 在接口 DTDHandler
      参数:
      name - 符号名称。
      publicId - 符号公共标识符，如果不可用则为null。
      systemId - 符号系统标识符。
      参见:

    • unparsedEntityDecl

      public void unparsedEntityDecl(String name, String publicId, String systemId, String notationName)
      Deprecated.
      接收未解析实体声明通知。

      默认情况下，不执行任何操作。应用程序编写者可以在子类中重写此方法，以跟踪文档中声明的未解析实体。

      指定者:
      unparsedEntityDecl 在接口 DTDHandler
      参数:
      name - 实体名称。
      publicId - 实体公共标识符，如果不可用则为null。
      systemId - 实体系统标识符。
      notationName - 关联符号的名称。
      参见:

    • setDocumentLocator

      public void setDocumentLocator(Locator locator)
      Deprecated.
      接收文档事件的Locator对象。

      默认情况下，不执行任何操作。应用程序编写者可以在子类中重写此方法，以便将定位器存储以在其他文档事件中使用。

      指定者:
      setDocumentLocator 在接口 DocumentHandler
      参数:
      locator - 用于所有SAX文档事件的定位器。
      参见:

    • startDocument

      public void startDocument() throws SAXException
      Deprecated.
      接收文档开始通知。

      默认情况下，不执行任何操作。应用程序编写者可以在子类中重写此方法，以在文档开始时执行特定操作（例如分配树的根节点或创建输出文件）。

      指定者:
      startDocument 在接口 DocumentHandler
      抛出:
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见:

    • endDocument

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

      默认情况下，不执行任何操作。应用程序编写者可以在子类中重写此方法，以在文档结束时执行特定操作（例如完成树或关闭输出文件）。

      指定者:
      endDocument 在接口 DocumentHandler
      抛出:
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见:

    • startElement

      public void startElement(String name, AttributeList attributes) throws SAXException
      Deprecated.
      接收元素开始通知。

      默认情况下，不执行任何操作。应用程序编写者可以在子类中重写此方法，以在每个元素开始时执行特定操作（例如分配新的树节点或将输出写入文件）。

      指定者:
      startElement 在接口 DocumentHandler
      参数:
      name - 元素类型名称。
      attributes - 指定或默认的属性。
      抛出:
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见:

    • endElement

      public void endElement(String name) throws SAXException
      Deprecated.
      接收元素结束的通知。

      默认情况下不执行任何操作。应用程序编写者可以在子类中覆盖此方法，以在每个元素结束时执行特定操作（例如完成树节点或将输出写入文件）。

      指定者：
      endElement 在接口 DocumentHandler
      参数：
      name - 元素名称
      抛出：
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见：

    • characters

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

      默认情况下不执行任何操作。应用程序编写者可以覆盖此方法以针对每个字符数据块执行特定操作（例如将数据添加到节点或缓冲区，或将其打印到文件）。

      指定者：
      characters 在接口 DocumentHandler
      参数：
      ch - 字符。
      start - 字符数组中的起始位置。
      length - 从字符数组中使用的字符数。
      抛出：
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见：

    • ignorableWhitespace

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

      默认情况下不执行任何操作。应用程序编写者可以覆盖此方法以针对每个可忽略的空格块执行特定操作（例如将数据添加到节点或缓冲区，或将其打印到文件）。

      指定者：
      ignorableWhitespace 在接口 DocumentHandler
      参数：
      ch - 空格字符。
      start - 字符数组中的起始位置。
      length - 从字符数组中使用的字符数。
      抛出：
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见：

    • processingInstruction

      public void processingInstruction(String target, String data) throws SAXException
      Deprecated.
      接收处理指令的通知。

      默认情况下不执行任何操作。应用程序编写者可以在子类中覆盖此方法以针对每个处理指令执行特定操作，例如设置状态变量或调用其他方法。

      指定者：
      processingInstruction 在接口 DocumentHandler
      参数：
      target - 处理指令目标。
      data - 处理指令数据，如果没有提供则为null。
      抛出：
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见：

    • warning

      public void warning(SAXParseException e) throws SAXException
      Deprecated.
      接收解析器警告的通知。

      默认实现不执行任何操作。应用程序编写者可以在子类中覆盖此方法以针对每个警告执行特定操作，例如将消息插入日志文件或将其打印到控制台。

      指定者：
      warning 在接口 ErrorHandler
      参数：
      e - 作为异常编码的警告信息。
      抛出：
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见：

    • error

      public void error(SAXParseException e) throws SAXException
      Deprecated.
      接收可恢复的解析器错误的通知。

      默认实现不执行任何操作。应用程序编写者可以在子类中覆盖此方法以针对每个错误执行特定操作，例如将消息插入日志文件或将其打印到控制台。

      指定者：
      error 在接口 ErrorHandler
      参数：
      e - 作为异常编码的警告信息。
      抛出：
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见：

    • fatalError

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

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

      指定者：
      fatalError 在接口 ErrorHandler
      参数：
      e - 作为异常编码的错误信息。
      抛出：
      SAXException - 任何SAX异常，可能包装另一个异常。
      参见：