Интерфейс 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, не считывая его из потока. |
Методы, объявленные в интерфейсе Iterator
forEachRemaining, next, remove
Подробное описание методов
nextEvent
XMLEvent nextEvent() throws XMLStreamException
Получает следующее событие XMLEvent. Начальным событием является
StartDocument.- Возвращает:
- следующее событие XMLEvent
- Вызывает исключение:
-
XMLStreamException— если произошла ошибка в базовом XML. -
NoSuchElementException— если в последовательности больше нет элементов. - См. также:
hasNext
peek
XMLEvent peek() throws XMLStreamException
Проверяет следующее событие XMLEvent, не считывая его из потока. Возвращает null, если поток достиг EOF или больше не содержит событий XMLEvent. Результат вызова 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/javax/xml/stream/XMLEventReader.html
