Module java.xml
Package javax.xml.stream.util

Interface XMLEventAllocator

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

  • Method Summary

    Modifier and Type
    Method
    Description
    XMLEvent
    allocate(XMLStreamReader reader)
    该方法根据XMLStreamReader的当前状态分配一个事件。
    void
    allocate(XMLStreamReader reader, XMLEventConsumer consumer)
    该方法根据XMLStreamReader的当前状态分配一个事件或一组事件，并将事件或事件集添加到传入的消费者中。
    XMLEventAllocator
    newInstance()
    该方法创建XMLEventAllocator的一个实例。

  • Method Details

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