Интерфейс XMLEventReader

Все суперинтерфейсы:: Iterator<Object>

Все известные реализующие классы:: EventReaderDelegate

public interface XMLEventReader
extends Iterator<Object>

Это интерфейс верхнего уровня для разбора событий XML. Он предоставляет возможность предварительного просмотра следующего события и возвращает информацию о конфигурации через интерфейс свойства.

С момента:: 1.6
См. также:: 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. Первоначальное событие — StartDocument.

Возвращает:: следующее XMLEvent
Исключения:: XMLStreamException - если возникла ошибка в базовом XML.; NoSuchElementException - итерация больше не имеет элементов.
См. также:: XMLEvent

hasNext

boolean hasNext()

Проверить наличие дополнительных событий. Возвращает true, если есть дополнительные события, и false в противном случае.

Определено в:: hasNext в интерфейсе Iterator<Object>
Возвращает:: true, если в ридере событий есть дополнительные события, false в противном случае

peek

XMLEvent peek()
       throws XMLStreamException

Проверить следующее XMLEvent, не читая его из потока. Возвращает null, если поток находится в конце файла (EOF) или больше нет XMLEvents. Вызов peek() эквивалентен следующему возврату next().

Возвращает:: следующее XMLEvent
Исключения:: XMLStreamException
См. также:: XMLEvent

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 - если возникли ошибки при освобождении связанных ресурсов