XMLEventAllocator - Java 11中文版 - API参考文档

API Reference Document

```
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为每个读取器分配一个新实例。
  - 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