JavaTM Platform
Standard Ed. 6

javax.xml.stream.util
接口 XMLEventAllocator


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 为每个 reader 分配一个新实例。


allocate

XMLEvent allocate(XMLStreamReader reader)
                  throws XMLStreamException
此方法在给定 XMLStreamReader 当前状态的情况下分配事件。如果此 XMLEventAllocator 在 reader 状态和事件之间不存在一对一的映射关系,则此方法将返回 null。此方法不能修改 XMLStreamReader 的状态。

参数:
reader - 作为分配根据的 XMLStreamReader
返回:
对应于当前 reader 状态的事件
抛出:
XMLStreamException

allocate

void allocate(XMLStreamReader reader,
              XMLEventConsumer consumer)
              throws XMLStreamException
此方法在给定 XMLStreamReader 当前状态的情况下分配一个事件或一个事件组,并将该事件或事件组添加给传入的使用者。此方法可将 reader 状态展开或联系到事件状态中。此方法可修改 XMLStreamReader 的状态。

参数:
reader - 作为分配根据的 XMLStreamReader
consumer - 要添加事件的 XMLEventConsumer。
抛出:
XMLStreamException

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策