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

Interface XMLEventAllocator


  • public interface XMLEventAllocator
    此接口定义了一个类,该类允许用户在给定XMLStreamReader的情况下注册分配事件的方法。 使用XMLEventFactory实现不需要实现,但建议这样做。 可以使用属性“javax.xml.stream.allocator”在XMLInputFactory上设置XMLEventAllocator
    从以下版本开始:
    1.6
    另请参见:
    XMLInputFactoryXMLEventFactory
    • 方法详细信息

      • 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