Интерфейс XMLEventAllocator

public interface XMLEventAllocator

Данный интерфейс определяет класс, позволяющий пользователю зарегистрировать способ выделения событий на основе XMLStreamReader. Реализация не обязана использовать XMLEventFactory, но это рекомендуется. XMLEventAllocator можно задать в XMLInputFactory с помощью свойства "javax.xml.stream.allocator"

Since:

1.6

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`XMLEvent`	`allocate(XMLStreamReader reader)`	Этот метод выделяет событие на основе текущего состояния XMLStreamReader.
`void`	`allocate(XMLStreamReader reader, XMLEventConsumer consumer)`	Этот метод выделяет событие или набор событий на основе текущего состояния XMLStreamReader и добавляет событие или набор событий к потребителю, переданному в качестве параметра.
`XMLEventAllocator`	`newInstance()`	Этот метод создает экземпляр XMLEventAllocator.

Подробное описание методов

newInstance

XMLEventAllocator newInstance()

Этот метод создает экземпляр XMLEventAllocator. Это позволяет XMLInputFactory выделять новый экземпляр на каждый ридер.

Возвращает:: экземпляр XMLEventAllocator

allocate

XMLEvent allocate(XMLStreamReader reader) throws XMLStreamException

Этот метод выделяет событие на основе текущего состояния XMLStreamReader. Если у этого XMLEventAllocator нет взаимно однозначного соответствия между состояниями ридера и событиями, этот метод вернет null. Этот метод не должен изменять состояние XMLStreamReader.

Параметры:: reader - XMLStreamReader для выделения
Возвращает:: событие, соответствующее текущему состоянию ридера
Исключение:: XMLStreamException - если произошла ошибка

allocate

void allocate(XMLStreamReader reader, XMLEventConsumer consumer) throws XMLStreamException

Этот метод выделяет событие или набор событий на основе текущего состояния XMLStreamReader и добавляет событие или набор событий к потребителю, переданному в качестве параметра. Этот метод может использоваться для расширения или сокращения состояний ридера в состояния событий. Этот метод может изменять состояние XMLStreamReader.

Параметры:: reader - XMLStreamReader для выделения; consumer - XMLEventConsumer для добавления.
Исключение:: XMLStreamException - если произошла ошибка

© 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/javax/xml/stream/util/XMLEventAllocator.html