Интерфейс 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

Модификатор и тип	Метод	Описание
`int`	`getColumnNumber()`	Возвращает номер столбца, на котором заканчивается текущее событие документа.
`int`	`getLineNumber()`	Возвращает номер строки, на которой заканчивается текущее событие документа.
`String`	`getPublicId()`	Возвращает публичный идентификатор текущего события документа.
`String`	`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.