Интерфейс 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/javax/xml/stream/util/XMLEventAllocator.html