compact2, compact3

org.xml.sax.ext

Interface Locator2

All Superinterfaces:

Locator

所有已知实现类：

Locator2Impl

public interface Locator2
extends Locator

SAX2扩展增强实体提供的信息虽然 Locator。如果一个执行支持这个扩展，定位器提供 ContentHandler.setDocumentLocator() 将实现这个接口，和http://xml.org/sax/features/use-locator2特征标志将有价值的真实。

This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY.

XmlReader实现不要求支持这一信息，而不是部分核心SAX2分布。

从以下版本开始：

萨克斯2（扩展1.1α）

方法摘要

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 版本= '…' …？>宣言，或是默认的解析。

结果

用于解释实体的文本的XML版本的标识符，如果该信息尚未在当前解析状态中可用，则用于解释该实体的文本或null。

getEncoding

String getEncoding()

返回实体的字符编码的名称。如果编码声明（例如，在一个MIME内容类型标头），将返回的名称。否则，如果有一个<？XML …编码= '…'？在文档开始时的声明，将返回编码名。否则将被推断编码（通常是UTF-8，UTF-16或一些变种），和推断的名字将被退回。

当一个InputSource是用来提供一个实体的字符流，此方法返回的编码，输入流提供。

值得注意的是，近期一些W3C规范要求在一些编码的文本进行标准化，使用的Unicode范式C、前处理。这种规范化必须由应用程序执行，通常会根据该方法返回的值触发。

编码名称可能是由底层的JVM使用，比较是区分大小写的。

结果

编码被用来解释*实体的文本字符的名称，或null如果这不是为*字符流通过一个inputsource或者尚未在当前分析状态。