javax.xml.stream.util
接口 XMLEventAllocator

public interface XMLEventAllocator

此接口定义了一个类，该类允许用户注册给定 XMLStreamReader 的情况下分配事件的方式。实现不需要使用 XMLEventFactory 实现，但推荐这样做。可以使用属性 "javax.xml.stream.allocator" 在 XMLInputFactory 上设置 XMLEventAllocator。

从以下版本开始：

1.6

另请参见：

XMLInputFactory, XMLEventFactory

---

方法摘要
XMLEvent	allocate(XMLStreamReader reader)           此方法在给定 XMLStreamReader 当前状态的情况下分配事件。
void	allocate(XMLStreamReader reader, XMLEventConsumer consumer)           此方法在给定 XMLStreamReader 当前状态的情况下分配一个事件或一个事件组，并将该事件或事件组添加给传入的使用者。
XMLEventAllocator	newInstance()           此方法创建一个 XMLEventAllocator 实例。

 

方法详细信息

newInstance

XMLEventAllocator newInstance()

此方法创建一个 XMLEventAllocator 实例。它允许 XMLInputFactory 为每个 reader 分配一个新实例。

---

allocate

XMLEvent allocate(XMLStreamReader reader)
                  throws XMLStreamException

此方法在给定 XMLStreamReader 当前状态的情况下分配事件。如果此 XMLEventAllocator 在 reader 状态和事件之间不存在一对一的映射关系，则此方法将返回 null。此方法不能修改 XMLStreamReader 的状态。

参数：

reader - 作为分配根据的 XMLStreamReader

返回：

对应于当前 reader 状态的事件

抛出：

XMLStreamException

---

allocate

void allocate(XMLStreamReader reader,
              XMLEventConsumer consumer)
              throws XMLStreamException

此方法在给定 XMLStreamReader 当前状态的情况下分配一个事件或一个事件组，并将该事件或事件组添加给传入的使用者。此方法可将 reader 状态展开或联系到事件状态中。此方法可修改 XMLStreamReader 的状态。

参数：

reader - 作为分配根据的 XMLStreamReader

consumer - 要添加事件的 XMLEventConsumer。

抛出：

XMLStreamException