模块 java.xml
包 javax.xml.stream.util

接口 XMLEventAllocator

public interface XMLEventAllocator
此接口定义了一个类，允许用户注册一种方法来分配给定 XMLStreamReader 的事件。使用 XMLEventFactory 实现不需要实现，但建议这样做。可以使用属性“javax.xml.stream.allocator”在 XMLInputFactory 上设置 XMLEventAllocator
自从：
1.6
参见：

  • 方法总结

    修饰符和类型
    方法
    描述
    XMLEvent
    allocate(XMLStreamReader reader)
    此方法根据 XMLStreamReader 的当前状态分配一个事件。
    void
    allocate(XMLStreamReader reader, XMLEventConsumer consumer)
    此方法根据 XMLStreamReader 的当前状态分配一个事件或一组事件，并将该事件或一组事件添加到传入的使用者。
    XMLEventAllocator
    newInstance()
    此方法创建 XMLEventAllocator 的一个实例。

  • 方法详情

    • newInstance

      XMLEventAllocator  newInstance()
      此方法创建 XMLEventAllocator 的一个实例。这允许 XMLInputFactory 为每个读取器分配一个新实例。
      返回：
      XMLEventAllocator 的实例

    • 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 - 如果发生错误