compact2, compact3

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发行版的一部分。

从以下版本开始：

SAX 2.0（扩展1.1 alpha）

方法摘要

Modifier and Type	Method and Description
String	getEncoding() 返回实体的字符编码的名称。
String	getXMLVersion() 返回实体使用的XML版本。

Methods inherited from interface org.xml.sax.Locator

getColumnNumber, getLineNumber, getPublicId, getSystemId

方法详细信息

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。