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

从以下版本开始：

1.6

Version:

1.0

另请参见：

XMLInputFactory ， XMLEventFactory

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`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