Интерфейс XMLEventAllocator

public interface XMLEventAllocator

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

Начиная с:

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, 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/util/XMLEventAllocator.html