Интерфейс Locator2

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

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

public interface Locator2 extends Locator

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

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

С:: 1.5, SAX 2.0 (расширения 1.1 альфа)

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

Модификатор и тип	Метод	Описание
`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, и сравнения должны быть регистронезависимыми.

Возвращает:: Имя кодировки символов, используемой для интерпретации * текста сущности, или 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/xml/sax/ext/Locator2.html