XMLEventAllocator (Java EE 5 SDK)

Java

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


javax.xml.stream.util Interface XMLEventAllocator


public interface XMLEventAllocator

This interface defines a class that allows a user to register a way to allocate events given an XMLStreamReader. An implementation is not required to use the XMLEventFactory implementation but this is recommended. The XMLEventAllocator can be set on an XMLInputFactory using the property "javax.xml.stream.allocator"

版本:
1.0
作者:
Copyright (c) 2003 by BEA Systems. All Rights Reserved.
另请参见:
XMLInputFactory, XMLEventFactory

方法摘要
 XMLEvent allocate(XMLStreamReader reader)
          This method allocates an event given the current state of the XMLStreamReader.
 void allocate(XMLStreamReader reader, XMLEventConsumer consumer)
          This method allocates an event or set of events given the current state of the XMLStreamReader and adds the event or set of events to the consumer that was passed in.
 XMLEventAllocator newInstance()
          This method creates an instance of the XMLEventAllocator.
 

方法详细信息

newInstance

XMLEventAllocator newInstance()
This method creates an instance of the XMLEventAllocator. This allows the XMLInputFactory to allocate a new instance per reader.


allocate

XMLEvent allocate(XMLStreamReader reader)
                  throws XMLStreamException
This method allocates an event given the current state of the XMLStreamReader. If this XMLEventAllocator does not have a one-to-one mapping between reader states and events this method will return null. This method must not modify the state of the XMLStreamReader.

参数:
reader - The XMLStreamReader to allocate from
返回:
the event corresponding to the current reader state
抛出异常:
XMLStreamException

allocate

void allocate(XMLStreamReader reader,
              XMLEventConsumer consumer)
              throws XMLStreamException
This method allocates an event or set of events given the current state of the XMLStreamReader and adds the event or set of events to the consumer that was passed in. This method can be used to expand or contract reader states into event states. This method may modify the state of the XMLStreamReader.

参数:
reader - The XMLStreamReader to allocate from
consumer - The XMLEventConsumer to add to.
抛出异常:
XMLStreamException

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.