模块 java.xml
包 org.xml.sax.ext

接口 Locator2

所有父级接口：
Locator
所有已知的实现类：
Locator2Impl
public interface Locator2 extends Locator
SAX2 扩展以扩充通过 Locator 提供的实体信息。如果实现支持此扩展，则 ContentHandler.setDocumentLocator() 中提供的定位器将实现此接口，并且 http://xml.org/sax/features/use-locator2 功能标志的值为 true 。

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 Normalization Form C 对某些编码中的文本进行规范化。这种规范化必须由应用程序执行，并且通常会根据此方法返回的值触发。

      编码名称可能是底层 JVM 使用的名称，并且比较应该不区分大小写。

      返回：
      用于解释实体文本的字符编码的名称，如果没有为通过 InputSource 传递的字符流提供，或者在当前解析状态下尚不可用，则为 null。