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

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

© 1993, 2023, 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/21/docs/api/java.xml/org/xml/sax/ext/Locator2.html