模块 java.xml
包 org.xml.sax

类 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
已弃用。
此类适用于已弃用的 DocumentHandler 接口。它已被 SAX2 DefaultHandler 类取代。
处理程序的默认基类。

此类实现了四个 SAX1 接口的默认行为：EntityResolver、DTDHandler、DocumentHandler 和 ErrorHandler。它现在已过时，但包含在 SAX2 中以支持遗留的 SAX1 应用程序。 SAX2 应用程序应该改用 DefaultHandler 类。

当应用程序编写者只需要实现接口的一部分时，他们可以扩展这个类；当应用程序没有提供自己的处理程序时，解析器编写者可以实例化此类以提供默认处理程序。

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

自从：
1.4, SAX 1.0
参见：

  • 构造方法详细信息

    • HandlerBase

      public HandlerBase()
      已弃用。
      创建一个 HandlerBase 。

  • 方法详情

    • resolveEntity

      public InputSource  resolveEntity(String  publicId, String  systemId) throws SAXException
      已弃用。
      解析外部实体。

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

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

    • notationDecl

      public void notationDecl(String  name, String  publicId, String  systemId)
      已弃用。
      接收符号声明的通知。

      默认情况下，什么也不做。如果应用程序编写者希望跟踪文档中声明的符号，则可以在子类中重写此方法。

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

    • unparsedEntityDecl

      public void unparsedEntityDecl(String  name, String  publicId, String  systemId, String  notationName)
      已弃用。
      接收未解析实体声明的通知。

      默认情况下，什么也不做。应用程序编写者可以在子类中重写此方法以跟踪文档中声明的未解析实体。

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

    • setDocumentLocator

      public void setDocumentLocator(Locator  locator)
      已弃用。
      接收文档事件的定位器对象。

      默认情况下，什么也不做。如果应用程序编写者希望存储定位器以用于其他文档事件，则他们可以在子类中重写此方法。

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

    • startDocument

      public void startDocument() throws SAXException
      已弃用。
      接收文档开始的通知。

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

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

    • endDocument

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

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

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

    • startElement

      public void startElement(String  name, AttributeList  attributes) throws SAXException
      已弃用。
      接收元素开始的通知。

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

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

    • endElement

      public void endElement(String  name) throws SAXException
      已弃用。
      接收元素结束的通知。

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

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

    • characters

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

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

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

    • ignorableWhitespace

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

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

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

    • processingInstruction

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

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

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

    • warning

      public void warning(SAXParseException  e) throws SAXException
      已弃用。
      接收解析器警告通知。

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

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

    • error

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

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

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

    • fatalError

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

      默认实现抛出 SAXParseException。如果应用程序编写者需要对每个致命错误采取特定操作（例如将所有错误收集到一个报告中），则他们可以在子类中重写此方法：无论如何，调用此方法时应用程序必须停止所有常规处理，因为文档不再可靠，解析器可能不再报告解析事件。

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