文字
分享


JavaTM 2 Platform
Standard Ed. 6

javax.xml.stream.util
接口 XMLEventAllocator


1

public interface <b>XMLEventAllocator</b>

此接口定义了一个类,该类允许用户注册给定 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

1

XMLEventAllocator <b>newInstance</b>()

此方法创建一个 XMLEventAllocator 实例。它允许 XMLInputFactory 为每个 reader 分配一个新实例。


allocate

1

2

XMLEvent <b>allocate</b>(XMLStreamReader reader)

                  throws XMLStreamException

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

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

allocate

1

2

3

void <b>allocate</b>(XMLStreamReader reader,

              XMLEventConsumer consumer)

              throws XMLStreamException

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

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

JavaTM 2 Platform
Standard Ed. 6

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

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

上一篇:StreamReaderDelegate下一篇:XMLEventConsumer