Locator2 - Java 11中文版 - API参考文档

API Reference Document

All Superinterfaces:

Locator

所有已知实现类：

Locator2Impl
```
public interface Locator2
extends Locator
```
SAX2扩展以增加通过Locator提供的实体信息。如果实现支持此扩展，则ContentHandler.setDocumentLocator() 中提供的定位器将实现此接口，并且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）

方法摘要

所有方法实例方法抽象方法
变量和类型	方法	描述
`String`	`getEncoding()`	返回实体的字符编码名称。
`String`	`getXMLVersion()`	返回用于实体的XML版本。

声明方法的接口 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。