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

Interface Locator2

  • All Superinterfaces:
    Locator
    所有已知实现类:
    Locator2Impl


    public interface Locator2
    extends Locator
    SAX2扩展,以增加通过Locator提供的实体信息。 如果实现支持此扩展,则ContentHandler.setDocumentLocator() 提供的Locator将实现此接口,并且http://xml.org/sax/features/use-locator2功能标志的值为true
    This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY.

    XMLReader实现不需要支持此信息,它不是仅核心的SAX2发行版的一部分。

    从以下版本开始:
    1.5,SAX 2.0(扩展1.1 alpha)
    • 方法详细信息

      • getXMLVersion

        String getXMLVersion​()
        返回实体使用的XML版本。 这通常是当前实体的<?xml version =' ...'... ?>声明的标识符,或者由解析器默认。
        结果
        用于解释实体文本的XML版本的标识符,如果该信息在当前解析状态尚不可用,则为null。
      • getEncoding

        String getEncoding​()
        返回实体的字符编码的名称。 如果编码被外部声明(例如,在MIME Content-Type头文件中),那将返回该名称。 否则,如果文档开头有<?xml ... encoding ='...'?>声明,则会返回该编码名称。 否则将推断编码(通常为UTF-8或一些UTF-16变体),并且将返回推断的名称。

        当使用InputSource提供实体的字符流时,此方法返回该输入流中提供的编码。

        请注意,最近的一些W3C规范要求在处理之前,使用Unicode归一化表格C对某些编码中的文本进行归一化。 这种归一化必须由应用执行,通常会根据此方法返回的值触发。

        编码名称可能是基础JVM使用的名称,比较应该是不区分大小写的。

        结果
        用于解释*实体文本的字符编码的名称,如果未为通过InputSource传递的*字符流提供null或在当前解析状态下尚未提供,则为null。