Module java.xml

软件包 javax.xml.stream.util

Interface XMLEventAllocator

public interface XMLEventAllocator

该界面定义了一个类，允许用户注册一种分配给定XMLStreamReader的事件的方式。 不需要实现使用XMLEventFactory实现，但建议这样做。 可以使用属性“javax.xml.stream.allocator”在XMLInputFactory上设置XMLEventAllocator

从以下版本开始：

1.6

Version:

1.0

另请参见：

XMLInputFactory ， XMLEventFactory

方法摘要

Modifier and Type	方法	描述
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