Интерфейс распознавания интерфейса
- Все известные подинтерфейсы:
Locator2
- Все известные реализующие классы:
-
Locator2Impl,LocatorImpl
public interface Locator
Если анализатор SAX предоставляет информацию о местоположении приложению SAX, он делает это, реализуя этот интерфейс и передавая экземпляр приложению с помощью метода обработчика содержимого setDocumentLocator. Приложение может использовать объект для получения местоположения любого другого события SAX в исходном документе XML.
Обратите внимание, что результаты, возвращаемые объектом, будут действительны только в рамках каждого метода обратного вызова: приложение получит непредсказуемые результаты, если попытается использовать локатор в другое время или после завершения парсинга.
Анализаторы SAX не обязаны предоставлять локатор, но их очень настоятельно рекомендуется делать это. Если анализатор предоставляет локатор, он должен сделать это до отчета о других событиях документа. Если локатор не был установлен к моменту, когда приложение получает событие startDocument, приложение должно предположить, что локатор недоступен.
- С:
- 1.4, SAX 1.0
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
int |
getColumnNumber() |
Возвращает номер столбца, где заканчивается текущее событие документа. |
int |
getLineNumber() |
Возвращает номер строки, где заканчивается текущее событие документа. |
String |
getPublicId() |
Возвращает общедоступный идентификатор для текущего события документа. |
String |
getSystemId() |
Возвращает системный идентификатор для текущего события документа. |
Подробное описание методов
getPublicId
String getPublicId()
Возвращаемое значение — общедоступный идентификатор сущности документа или внешней парсируемой сущности, в которой появляется метка, вызывающая событие.
- Возвращает:
- Строка, содержащая общедоступный идентификатор, или null, если он недоступен.
- См. также:
getSystemId
String getSystemId()
Возвращаемое значение — системный идентификатор сущности документа или внешней парсируемой сущности, в которой появляется метка, вызывающая событие.
Если системный идентификатор является URL-адресом, анализатор должен полностью разрешить его перед передачей его приложению. Например, имя файла всегда должно предоставляться в виде URL-адреса file:..., а другие виды относительных URI также разрешаются относительно своих баз.
- Возвращает:
- Строка, содержащая системный идентификатор, или null, если он недоступен.
- См. также:
getLineNumber
int getLineNumber()
Предупреждение: Возвращаемое значение метода предназначено только для приблизительной оценки для диагностических целей; оно не предназначено для предоставления достаточной информации для редактирования символьного содержимого исходного XML-документа. В некоторых случаях эти номера «строк» совпадают с тем, что отображается как столбцы, а в других они могут не совпадать с исходным текстом из-за внутренней расшифровки сущностей.
Возвращаемое значение — приблизительный номер строки в сущности документа или внешней парсируемой сущности, где появляется метка, вызывающая событие.
Если это возможно, драйвер SAX должен предоставить положение строки первого символа после текста, связанного с событием документа. Первая строка — строка 1.
- Возвращает:
- Номер строки или -1, если он недоступен.
- См. также:
getColumnNumber
int getColumnNumber()
char значений с момента последнего конца строки. Предупреждение: Возвращаемое значение метода предназначено только для приблизительной оценки для диагностических целей; оно не предназначено для предоставления достаточной информации для редактирования символьного содержимого исходного XML-документа. Например, когда строки содержат комбинации символов, широкие символы, пары суррогатов или текст с двунаправленной ориентацией, значение может не соответствовать столбцу в отображении текстового редактора.
Возвращаемое значение — приблизительный номер столбца в сущности документа или внешней парсируемой сущности, где появляется метка, вызывающая событие.
Если это возможно, драйвер SAX должен предоставить положение строки первого символа после текста, связанного с событием документа. Первый столбец в каждой строке — столбец 1.
- Возвращает:
- Номер столбца или -1, если он недоступен.
- См. также:
© 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/Locator.html
