Интерфейс Locator2

Все суперинтерфейсы:: Locator

Все известные реализующие классы:: Locator2Impl

public interface Locator2 extends Locator

Расширение SAX2, дополняющее информацию о сущности, предоставляемую через Locator. Если реализация поддерживает это расширение, объект Locator, предоставленный в ContentHandler.setDocumentLocator() , будет реализовывать этот интерфейс, а флаг функции http://xml.org/sax/features/use-locator2 будет иметь значение true.

Реализации XMLReader не обязаны поддерживать эту информацию, и она не входит в дистрибутивы SAX2, содержащие только ядро.

Начиная с версии:: 1.5, SAX 2.0 (расширения 1.1 alpha)

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`getEncoding()`	Возвращает название кодировки символов сущности.
`String`	`getXMLVersion()`	Возвращает версию XML, используемую для сущности.

Методы, объявленные в интерфейсе 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; сравнение должно выполняться без учёта регистра.

Возвращает:: Название кодировки символов, используемой для интерпретации текста сущности, или null, если кодировка не была указана для потока символов, переданного через InputSource, либо пока недоступна в текущем состоянии разбора.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/xml/sax/ext/Locator2.html