Интерфейс XMLEventAllocator

public interface XMLEventAllocator

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

Since:: 1.6
См. также:: XMLInputFactory, XMLEventFactory

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

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

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

newInstance

XMLEventAllocator newInstance()

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

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