Class EventAllocatorImpl

java.lang.Object

org.codehaus.stax2.ri.evt.Stax2EventAllocatorImpl

com.fasterxml.aalto.evt.EventAllocatorImpl

All Implemented Interfaces:

XMLEventAllocator, XMLStreamConstants

public final class EventAllocatorImpl
extends org.codehaus.stax2.ri.evt.Stax2EventAllocatorImpl

Specialized event allocator implementation. Beyond additions needed to support DTD entities, implements non-location-preserving optimization.

Field Summary

Fields

Modifier and Type	Field	Description
protected final boolean	_cfgPreserveLocation
protected Location	_lastLocation	Last used location info; only relevant to non-accurate-location allocators.
(package private) static final EventAllocatorImpl	sStdInstance

Fields inherited from interface XMLStreamConstants

ATTRIBUTE, CDATA, CHARACTERS, COMMENT, DTD, END_DOCUMENT, END_ELEMENT, ENTITY_DECLARATION, ENTITY_REFERENCE, NAMESPACE, NOTATION_DECLARATION, PROCESSING_INSTRUCTION, SPACE, START_DOCUMENT, START_ELEMENT

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	EventAllocatorImpl(boolean preserveLocation)

Method Summary

Modifier and Type	Method	Description
XMLEvent	allocate(XMLStreamReader r)
static EventAllocatorImpl	getDefaultInstance()
static EventAllocatorImpl	getFastInstance()
protected Location	getLocation(XMLStreamReader r)	Method used to get the Location object to use for an event to create.
XMLEventAllocator	newInstance()	Default implementation assumes that the caller knows how to share instances, and so need not create new copies.

Methods inherited from class org.codehaus.stax2.ri.evt.Stax2EventAllocatorImpl

allocate, createDTD, createEntityReference, createStartElement

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

sStdInstance

static final EventAllocatorImpl sStdInstance

_cfgPreserveLocation

protected final boolean _cfgPreserveLocation

_lastLocation

protected Location _lastLocation

Last used location info; only relevant to non-accurate-location allocators.

Constructor Details

EventAllocatorImpl

protected EventAllocatorImpl(boolean preserveLocation)

Parameters:

preserveLocation - If true, allocator will construct instances that have accurate location information; if false, instances will only have some generic shared Location info. Latter option will reduce memory usage/thrashing a bit, and may improve speed.

Method Details

getDefaultInstance

public static EventAllocatorImpl getDefaultInstance()

getFastInstance

public static EventAllocatorImpl getFastInstance()

newInstance

public XMLEventAllocator newInstance()

Default implementation assumes that the caller knows how to share instances, and so need not create new copies.

Note: if this class is sub-classes, this method should be redefined if assumptions about shareability do not hold.

Specified by:

newInstance in interface XMLEventAllocator

Overrides:

newInstance in class org.codehaus.stax2.ri.evt.Stax2EventAllocatorImpl

allocate

public XMLEvent allocate(XMLStreamReader r)
                  throws XMLStreamException

Specified by:

allocate in interface XMLEventAllocator

Overrides:

allocate in class org.codehaus.stax2.ri.evt.Stax2EventAllocatorImpl

Throws:

XMLStreamException

getLocation

protected Location getLocation(XMLStreamReader r)

Method used to get the Location object to use for an event to create. Base implementation just calls stream reader's accessors, but sub-classes may choose to use other methods (esp. when not in "preserve location" mode).

Overrides:

getLocation in class org.codehaus.stax2.ri.evt.Stax2EventAllocatorImpl