Интерфейс Locator2
- Все суперинтерфейсы:
- Locator
- Все известные реализующие классы:
- Locator2Impl
public interface Locator2 extends Locator
Расширение SAX2 для дополнения информации об сущности, предоставляемой через Locator. Если реализация поддерживает это расширение, Locator, предоставленный в ContentHandler.setDocumentLocator() , будет реализовывать этот интерфейс, а флаг функции http://xml.org/sax/features/use-locator2 будет иметь значение true.
Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не имеет ГАРАНТИЙ.
Реализации XMLReader не обязаны поддерживать эту информацию, и она не является частью только базовых дистрибутивов SAX2.
- С тех пор:
- 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 Normalization Form C, перед обработкой. Такую нормализацию должны выполнять приложения, и она обычно будет вызвана на основе значения, возвращаемого этим методом.
Имена кодировок могут быть такими, которые используются базовой JVM, и сравнения должны быть регистронезависимыми.
- Возвращает:
- Имя используемой кодировки символов для интерпретации * текста сущности, или null, если оно не было предоставлено для * потока символов, переданного через InputSource, или иначе еще не доступно в текущем состоянии разбора.
© 1993, 2020, 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.
