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