Интерфейс 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, 2021, 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/17/docs/api/java.xml/org/xml/sax/ext/Locator2.html