com.ctc.wstx.evt

Class DefaultEventAllocator

java.lang.Object

com.ctc.wstx.sr.ElemCallback

com.ctc.wstx.evt.DefaultEventAllocator

All Implemented Interfaces:

XMLEventAllocator, XMLStreamConstants

public class DefaultEventAllocator
extends ElemCallback
implements XMLEventAllocator, XMLStreamConstants

Straight-forward implementation of XMLEventAllocator, to be used with Woodstox' event reader.

One of few complications here is the way start elements are constructed. The pattern used is double-indirection, needed to get a callback from the stream reader, with data we need for constructing even Object... but without stream reader having any understanding of event Objects per se.

03-Dec-2004, TSa: One additional twist is that it's now possible to create slightly faster event handling, by indicating that the fully accurate Location information is not necessary. If so, allocator will just use one shared Location object passed to all event objects constructed.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	mAccurateLocation
protected Location	mLastLocation Last used location info; only relevant to non-accurate-location allocators.

Fields inherited from interface javax.xml.stream.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 and Description
protected	DefaultEventAllocator(boolean accurateLocation)

Method Summary

Methods

Modifier and Type	Method and Description
XMLEvent	allocate(XMLStreamReader r)
void	allocate(XMLStreamReader r, XMLEventConsumer consumer)
static DefaultEventAllocator	getDefaultInstance()
static DefaultEventAllocator	getFastInstance()
XMLEventAllocator	newInstance()
Object	withStartElement(Location loc, QName name, BaseNsContext nsCtxt, ElemAttrs attrs, boolean wasEmpty)

Methods inherited from class java.lang.Object

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

Field Detail

mAccurateLocation

protected final boolean mAccurateLocation

mLastLocation

protected Location mLastLocation

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

Constructor Detail

DefaultEventAllocator

protected DefaultEventAllocator(boolean accurateLocation)

Parameters:

accurateLocation - 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 Detail

getDefaultInstance

public static DefaultEventAllocator getDefaultInstance()

getFastInstance

public static DefaultEventAllocator getFastInstance()

allocate

public XMLEvent allocate(XMLStreamReader r)
                  throws XMLStreamException

Specified by:

allocate in interface XMLEventAllocator

Throws:

XMLStreamException

allocate

public void allocate(XMLStreamReader r,
            XMLEventConsumer consumer)
              throws XMLStreamException

Specified by:

allocate in interface XMLEventAllocator

Throws:

XMLStreamException

newInstance

public XMLEventAllocator newInstance()

Specified by:

newInstance in interface XMLEventAllocator

withStartElement

public Object withStartElement(Location loc,
                      QName name,
                      BaseNsContext nsCtxt,
                      ElemAttrs attrs,
                      boolean wasEmpty)

Specified by:

withStartElement in class ElemCallback