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 分發的一部分。

從以下版本開始：

SAX 2.0 (extensions 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 Normalization Form C 標準化一些編碼中的文本。應用程序必須執行此類別標準化，並且通常基於此方法返回的值觸發它。

編碼名稱可以是基礎 JVM 使用的編碼名稱，並且比較時應區分大小寫。

返回：

用於解釋 * 實體的文本的字元編碼的名稱，如果不向通過 InputSource 傳遞的 * 字元串流提供該名稱，或者在當前解析狀態中不可用，則為 null。