Интерфейс XMLEventReader
- Все суперинтерфейсы:
Iterator<Object>
- Все известные реализующие классы:
EventReaderDelegate
public interface XMLEventReader extends Iterator<Object>
Это интерфейс верхнего уровня для разбора событий XML. Он предоставляет возможность предварительного просмотра следующего события и возвращает информацию о конфигурации через интерфейс свойств.
- С тех пор:
- 1.6
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
close() |
Освобождает все ресурсы, связанные с этим ридером. |
String |
getElementText() |
Читает содержимое элемента, содержащего только текст. |
Object |
getProperty |
Получение значения свойства/функции из базовой реализации. |
boolean |
hasNext() |
Проверка наличия дополнительных событий. |
XMLEvent |
nextEvent() |
Получение следующего события XMLEvent. |
XMLEvent |
nextTag() |
Пропускает все незначительные пробельные события до тех пор, пока не будет достигнут START_ELEMENT или END_ELEMENT. |
XMLEvent |
peek() |
Проверка следующего события XMLEvent без его чтения из потока. |
Методы, объявленные в интерфейсе java.util.Iterator
forEachRemaining, next, remove
Подробное описание методов
nextEvent
XMLEvent nextEvent() throws XMLStreamException
Получение следующего события XMLEvent. Первоначальное событие —
StartDocument.- Возвращает:
- следующее событие XMLEvent
- Исключение:
-
XMLStreamException- если возникает ошибка в базовом XML. -
NoSuchElementException- итерация не содержит больше элементов. - См. также:
hasNext
peek
XMLEvent peek() throws XMLStreamException
Проверка следующего события XMLEvent без его чтения из потока. Возвращает null, если поток достиг EOF или больше нет XMLEvents. Вызов peek() будет эквивалентен следующему возврату next().
- Возвращает:
- следующее событие XMLEvent
- Исключение:
-
XMLStreamException- если произошла ошибка - См. также:
getElementText
String getElementText() throws XMLStreamException
Читает содержимое элемента, содержащего только текст. Предварительное условие: текущее событие — START_ELEMENT. Последующее условие: текущее событие — соответствующее END_ELEMENT.
- Возвращает:
- текст элемента
- Исключение:
-
XMLStreamException- если текущее событие не является START_ELEMENT или если встречен элемент, не содержащий текст
nextTag
XMLEvent nextTag() throws XMLStreamException
Пропускает все незначительные пробельные события до тех пор, пока не будет достигнут START_ELEMENT или END_ELEMENT. Если встречены другие символы, кроме пробельных, выбрасывается исключение. Этот метод следует использовать при обработке содержимого только элементов, поскольку анализатор не может распознать игнорируемые пробелы, если DTD отсутствует или не интерпретируется.
- Возвращает:
- START_ELEMENT или END_ELEMENT
- Исключение:
-
XMLStreamException- если встречены другие символы, кроме пробельных
getProperty
Object getProperty(String name) throws IllegalArgumentException
Получение значения свойства/функции из базовой реализации
- Параметры:
-
name- имя свойства - Возвращает:
- значение свойства
- Исключение:
-
IllegalArgumentException- если свойство не поддерживается
close
void close() throws XMLStreamException
Освобождает все ресурсы, связанные с этим ридером. Этот метод не закрывает базовый источник ввода.
- Исключение:
-
XMLStreamException- если при освобождении связанных ресурсов возникли ошибки
© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.xml/javax/xml/stream/XMLEventReader.html
