Интерфейс XMLEventReader
- Все суперинтерфейсы:
- Iterator
- Все известные реализующие классы:
- EventReaderDelegate
public interface XMLEventReader extends Iterator
Это интерфейс верхнего уровня для разбора событий XML. Он предоставляет возможность предварительного просмотра следующего события и возвращает информацию о конфигурации через интерфейс свойств.
- С момента:
- 1.6
- Версия:
- 1.0
- См. также:
-
XMLInputFactory,XMLEventWriter
Методы
| Модификатор и тип | Метод и описание |
|---|---|
void |
close() Освобождает все ресурсы, связанные с этим ридером. |
String |
getElementText() Читает содержимое элемента только с текстом. |
Object |
getProperty(String name) Получение значения функции/свойства от базовой реализации |
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
- Исключения:
-
XMLStreamException- если возникла ошибка в базовом XML. -
NoSuchElementException- итерация не имеет больше элементов. - См. также:
XMLEvent
hasNext
boolean hasNext()
Проверка наличия дополнительных событий. Возвращает true, если существуют дополнительные события, и false в противном случае.
- Определено в:
-
hasNextв интерфейсеIterator - Возвращает:
- true, если у ридера событий есть дополнительные события, в противном случае false
peek
XMLEvent peek()
throws XMLStreamException Проверка следующего XMLEvent без его чтения из потока. Возвращает null, если поток находится в состоянии EOF или больше нет XMLEvents. Вызов peek() будет равен следующему возврату next().
- Исключения:
XMLStreamException- См. также:
XMLEvent
getElementText
String getElementText()
throws XMLStreamException Читает содержимое элемента только с текстом. Предварительное условие: текущее событие — START_ELEMENT. Последующее условие: текущее событие — соответствующее END_ELEMENT.
- Исключения:
-
XMLStreamException- если текущее событие не START_ELEMENT или если встречен элемент, не являющийся текстовым
nextTag
XMLEvent nextTag()
throws XMLStreamException Пропускает любые незначительные пробельные события до тех пор, пока не будет достигнут START_ELEMENT или END_ELEMENT. Если встречен любой символ, кроме пробельных символов, выбрасывается исключение. Этот метод следует использовать при обработке содержимого только элементов, потому что анализатор не может распознать игнорируемые пробелы, если DTD отсутствует или не интерпретируется.
- Исключения:
-
XMLStreamException- если встречен любой символ, кроме пробельных символов
getProperty
Object getProperty(String name)
throws IllegalArgumentException Получение значения функции/свойства от базовой реализации
- Параметры:
-
name- Имя свойства - Возвращает:
- Значение свойства
- Исключения:
-
IllegalArgumentException- если свойство не поддерживается
close
void close()
throws XMLStreamException Освобождает все ресурсы, связанные с этим ридером. Этот метод не закрывает базовый источник ввода.
- Исключения:
-
XMLStreamException- если при освобождении связанных ресурсов возникли ошибки
© 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.