Package cdc.util.xml

Class AbstractStAXParser<R>

java.lang.Object

cdc.util.xml.AbstractStAXParser<R>

Type Parameters:

R - The result type.

public abstract class AbstractStAXParser<R>
extends java.lang.Object

Class that can facilitate the writing of an XML parser over an XMLStreamReader.

Author:

Damien Carbonne

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AbstractStAXParser.ElementParser<C>

Field Summary

Fields

Modifier and Type	Field	Description
protected org.apache.logging.log4j.Logger	logger
protected javax.xml.stream.XMLStreamReader	reader

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractStAXParser(javax.xml.stream.XMLStreamReader reader)

Method Summary

Modifier and Type	Method	Description
protected void	error(java.lang.String message)
protected void	expect(java.lang.String context, int eventType)	Checks that current event type is an expected one.
protected void	expectEndDocument(java.lang.String context)
protected void	expectEndElement(java.lang.String context, java.lang.String name)
protected void	expectStartDocument(java.lang.String context)
protected void	expectStartElement(java.lang.String context, java.lang.String name)
protected boolean	getAttributeAsBoolean(java.lang.String name, boolean def)
protected boolean	getAttributeAsBoolean(java.lang.String name, boolean def, FailureReaction missingReaction, FailureReaction errorReaction)
protected byte	getAttributeAsByte(java.lang.String name, byte def)
protected byte	getAttributeAsByte(java.lang.String name, byte def, FailureReaction missingReaction, FailureReaction errorReaction)
protected double	getAttributeAsDouble(java.lang.String name, double def)
protected double	getAttributeAsDouble(java.lang.String name, double def, FailureReaction missingReaction, FailureReaction errorReaction)
protected <E extends java.lang.Enum<E>> E	getAttributeAsEnum(java.lang.String name, java.lang.Class<E> enumClass, E def)
protected <E extends java.lang.Enum<E>> E	getAttributeAsEnum(java.lang.String name, java.lang.Class<E> enumClass, E def, FailureReaction missingReaction, FailureReaction errorReaction)
protected float	getAttributeAsFloat(java.lang.String name, float def)
protected float	getAttributeAsFloat(java.lang.String name, float def, FailureReaction missingReaction, FailureReaction errorReaction)
protected int	getAttributeAsInt(java.lang.String name, int def)
protected int	getAttributeAsInt(java.lang.String name, int def, FailureReaction missingReaction, FailureReaction errorReaction)
protected long	getAttributeAsLong(java.lang.String name, long def)
protected long	getAttributeAsLong(java.lang.String name, long def, FailureReaction missingReaction, FailureReaction errorReaction)
protected java.lang.Boolean	getAttributeAsOptionalBoolean(java.lang.String name, java.lang.Boolean def)
protected java.lang.Boolean	getAttributeAsOptionalBoolean(java.lang.String name, java.lang.Boolean def, FailureReaction errorReaction)
protected java.lang.Byte	getAttributeAsOptionalByte(java.lang.String name, java.lang.Byte def)
protected java.lang.Byte	getAttributeAsOptionalByte(java.lang.String name, java.lang.Byte def, FailureReaction errorReaction)
protected java.lang.Double	getAttributeAsOptionalDouble(java.lang.String name, java.lang.Double def)
protected java.lang.Double	getAttributeAsOptionalDouble(java.lang.String name, java.lang.Double def, FailureReaction errorReaction)
protected <E extends java.lang.Enum<E>> E	getAttributeAsOptionalEnum(java.lang.String name, java.lang.Class<E> enumClass, E def)
protected <E extends java.lang.Enum<E>> E	getAttributeAsOptionalEnum(java.lang.String name, java.lang.Class<E> enumClass, E def, FailureReaction errorReaction)
protected java.lang.Float	getAttributeAsOptionalFloat(java.lang.String name, java.lang.Float def)
protected java.lang.Float	getAttributeAsOptionalFloat(java.lang.String name, java.lang.Float def, FailureReaction errorReaction)
protected java.lang.Integer	getAttributeAsOptionalInt(java.lang.String name, java.lang.Integer def)
protected java.lang.Integer	getAttributeAsOptionalInt(java.lang.String name, java.lang.Integer def, FailureReaction errorReaction)
protected java.lang.Long	getAttributeAsOptionalLong(java.lang.String name, java.lang.Long def)
protected java.lang.Long	getAttributeAsOptionalLong(java.lang.String name, java.lang.Long def, FailureReaction errorReaction)
protected java.lang.Enum<?>	getAttributeAsOptionalRawEnum(java.lang.String name, java.lang.Class<? extends java.lang.Enum<?>> enumClass, java.lang.Enum<?> def)
protected java.lang.Enum<?>	getAttributeAsOptionalRawEnum(java.lang.String name, java.lang.Class<? extends java.lang.Enum<?>> enumClass, java.lang.Enum<?> def, FailureReaction errorReaction)
protected java.lang.Short	getAttributeAsOptionalShort(java.lang.String name, java.lang.Short def)
protected java.lang.Short	getAttributeAsOptionalShort(java.lang.String name, java.lang.Short def, FailureReaction errorReaction)
protected java.lang.Enum<?>	getAttributeAsRawEnum(java.lang.String name, java.lang.Class<? extends java.lang.Enum<?>> enumClass, java.lang.Enum<?> def)
protected java.lang.Enum<?>	getAttributeAsRawEnum(java.lang.String name, java.lang.Class<? extends java.lang.Enum<?>> enumClass, java.lang.Enum<?> def, FailureReaction missingReaction, FailureReaction errorReaction)
protected short	getAttributeAsShort(java.lang.String name, short def)
protected short	getAttributeAsShort(java.lang.String name, short def, FailureReaction missingReaction, FailureReaction errorReaction)
protected java.lang.String	getAttributeValue(java.lang.String name, java.lang.String def)
protected java.lang.String	getAttributeValue(java.lang.String name, java.lang.String def, FailureReaction missingReaction)	Returns an attribute value.
protected org.apache.logging.log4j.Logger	getLogger()
protected void	ignoreElement()	Must be called after a START_ELEMENT has been found.
protected boolean	isStartElement(java.lang.String name)	Returns true if reader is on a START_ELEMENT that has a given name.
protected void	next()
protected int	nextTag()
protected abstract R	parse()
protected <C> void	parseChildren(C context, java.lang.String name, AbstractStAXParser.ElementParser<C> childParser)
protected void	unexpectedEvent()

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.apache.logging.log4j.Logger logger

reader

protected final javax.xml.stream.XMLStreamReader reader

Constructor Detail

AbstractStAXParser

protected AbstractStAXParser(javax.xml.stream.XMLStreamReader reader)

Method Detail

getLogger

protected final org.apache.logging.log4j.Logger getLogger()

parse

protected abstract R parse()
                    throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

error

protected final void error(java.lang.String message)

unexpectedEvent

protected final void unexpectedEvent()

next

protected void next()
             throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

nextTag

protected int nextTag()
               throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

ignoreElement

protected void ignoreElement()
                      throws javax.xml.stream.XMLStreamException

Must be called after a START_ELEMENT has been found.

Skips all events till the corresponding END_ELEMENT is reached.

Throws:

javax.xml.stream.XMLStreamException - If there is a fatal error detecting the next states.

parseChildren

protected <C> void parseChildren(C context,
                                 java.lang.String name,
                                 AbstractStAXParser.ElementParser<C> childParser)
                          throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

expect

protected void expect(java.lang.String context,
                      int eventType)
               throws javax.xml.stream.XMLStreamException

Checks that current event type is an expected one.

If false, raises an exception.

Parameters:

context - Call context.

eventType - The expected event type.

Throws:

javax.xml.stream.XMLStreamException - When current event type is not the expected one.

expectStartElement

protected void expectStartElement(java.lang.String context,
                                  java.lang.String name)
                           throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

expectEndElement

protected void expectEndElement(java.lang.String context,
                                java.lang.String name)
                         throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

expectStartDocument

protected void expectStartDocument(java.lang.String context)
                            throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

expectEndDocument

protected void expectEndDocument(java.lang.String context)
                          throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

isStartElement

protected boolean isStartElement(java.lang.String name)

Returns true if reader is on a START_ELEMENT that has a given name.

Parameters:

name - The element name.

Returns:

true if reader is on a START_ELEMENT named name.

getAttributeValue

protected java.lang.String getAttributeValue(java.lang.String name,
                                             java.lang.String def,
                                             FailureReaction missingReaction)

Returns an attribute value.

Parameters:

name - The attribute name.

def - The default value.

missingReaction - The reaction to adopt when no attribute named name is found.

Returns:

The attribute value, or def.

Throws:

NotFoundException - When missingReaction is FAIL and no attribute is found.

getAttributeValue

protected java.lang.String getAttributeValue(java.lang.String name,
                                             java.lang.String def)

getAttributeAsBoolean

protected boolean getAttributeAsBoolean(java.lang.String name,
                                        boolean def,
                                        FailureReaction missingReaction,
                                        FailureReaction errorReaction)

getAttributeAsBoolean

protected boolean getAttributeAsBoolean(java.lang.String name,
                                        boolean def)

getAttributeAsOptionalBoolean

protected java.lang.Boolean getAttributeAsOptionalBoolean(java.lang.String name,
                                                          java.lang.Boolean def,
                                                          FailureReaction errorReaction)

getAttributeAsOptionalBoolean

protected java.lang.Boolean getAttributeAsOptionalBoolean(java.lang.String name,
                                                          java.lang.Boolean def)

getAttributeAsLong

protected long getAttributeAsLong(java.lang.String name,
                                  long def,
                                  FailureReaction missingReaction,
                                  FailureReaction errorReaction)

getAttributeAsLong

protected long getAttributeAsLong(java.lang.String name,
                                  long def)

getAttributeAsOptionalLong

protected java.lang.Long getAttributeAsOptionalLong(java.lang.String name,
                                                    java.lang.Long def,
                                                    FailureReaction errorReaction)

getAttributeAsOptionalLong

protected java.lang.Long getAttributeAsOptionalLong(java.lang.String name,
                                                    java.lang.Long def)

getAttributeAsInt

protected int getAttributeAsInt(java.lang.String name,
                                int def,
                                FailureReaction missingReaction,
                                FailureReaction errorReaction)

getAttributeAsInt

protected int getAttributeAsInt(java.lang.String name,
                                int def)

getAttributeAsOptionalInt

protected java.lang.Integer getAttributeAsOptionalInt(java.lang.String name,
                                                      java.lang.Integer def,
                                                      FailureReaction errorReaction)

getAttributeAsOptionalInt

protected java.lang.Integer getAttributeAsOptionalInt(java.lang.String name,
                                                      java.lang.Integer def)

getAttributeAsShort

protected short getAttributeAsShort(java.lang.String name,
                                    short def,
                                    FailureReaction missingReaction,
                                    FailureReaction errorReaction)

getAttributeAsShort

protected short getAttributeAsShort(java.lang.String name,
                                    short def)

getAttributeAsOptionalShort

protected java.lang.Short getAttributeAsOptionalShort(java.lang.String name,
                                                      java.lang.Short def,
                                                      FailureReaction errorReaction)

getAttributeAsOptionalShort

protected java.lang.Short getAttributeAsOptionalShort(java.lang.String name,
                                                      java.lang.Short def)

getAttributeAsByte

protected byte getAttributeAsByte(java.lang.String name,
                                  byte def,
                                  FailureReaction missingReaction,
                                  FailureReaction errorReaction)

getAttributeAsByte

protected byte getAttributeAsByte(java.lang.String name,
                                  byte def)

getAttributeAsOptionalByte

protected java.lang.Byte getAttributeAsOptionalByte(java.lang.String name,
                                                    java.lang.Byte def,
                                                    FailureReaction errorReaction)

getAttributeAsOptionalByte

protected java.lang.Byte getAttributeAsOptionalByte(java.lang.String name,
                                                    java.lang.Byte def)

getAttributeAsDouble

protected double getAttributeAsDouble(java.lang.String name,
                                      double def,
                                      FailureReaction missingReaction,
                                      FailureReaction errorReaction)

getAttributeAsDouble

protected double getAttributeAsDouble(java.lang.String name,
                                      double def)

getAttributeAsOptionalDouble

protected java.lang.Double getAttributeAsOptionalDouble(java.lang.String name,
                                                        java.lang.Double def,
                                                        FailureReaction errorReaction)

getAttributeAsOptionalDouble

protected java.lang.Double getAttributeAsOptionalDouble(java.lang.String name,
                                                        java.lang.Double def)

getAttributeAsFloat

protected float getAttributeAsFloat(java.lang.String name,
                                    float def,
                                    FailureReaction missingReaction,
                                    FailureReaction errorReaction)

getAttributeAsFloat

protected float getAttributeAsFloat(java.lang.String name,
                                    float def)

getAttributeAsOptionalFloat

protected java.lang.Float getAttributeAsOptionalFloat(java.lang.String name,
                                                      java.lang.Float def,
                                                      FailureReaction errorReaction)

getAttributeAsOptionalFloat

protected java.lang.Float getAttributeAsOptionalFloat(java.lang.String name,
                                                      java.lang.Float def)

getAttributeAsRawEnum

protected java.lang.Enum<?> getAttributeAsRawEnum(java.lang.String name,
                                                  java.lang.Class<? extends java.lang.Enum<?>> enumClass,
                                                  java.lang.Enum<?> def,
                                                  FailureReaction missingReaction,
                                                  FailureReaction errorReaction)

getAttributeAsRawEnum

protected java.lang.Enum<?> getAttributeAsRawEnum(java.lang.String name,
                                                  java.lang.Class<? extends java.lang.Enum<?>> enumClass,
                                                  java.lang.Enum<?> def)

getAttributeAsOptionalRawEnum

protected java.lang.Enum<?> getAttributeAsOptionalRawEnum(java.lang.String name,
                                                          java.lang.Class<? extends java.lang.Enum<?>> enumClass,
                                                          java.lang.Enum<?> def,
                                                          FailureReaction errorReaction)

getAttributeAsOptionalRawEnum

protected java.lang.Enum<?> getAttributeAsOptionalRawEnum(java.lang.String name,
                                                          java.lang.Class<? extends java.lang.Enum<?>> enumClass,
                                                          java.lang.Enum<?> def)

getAttributeAsEnum

protected <E extends java.lang.Enum<E>> E getAttributeAsEnum(java.lang.String name,
                                                             java.lang.Class<E> enumClass,
                                                             E def,
                                                             FailureReaction missingReaction,
                                                             FailureReaction errorReaction)

getAttributeAsEnum

protected <E extends java.lang.Enum<E>> E getAttributeAsEnum(java.lang.String name,
                                                             java.lang.Class<E> enumClass,
                                                             E def)

getAttributeAsOptionalEnum

protected <E extends java.lang.Enum<E>> E getAttributeAsOptionalEnum(java.lang.String name,
                                                                     java.lang.Class<E> enumClass,
                                                                     E def,
                                                                     FailureReaction errorReaction)

getAttributeAsOptionalEnum

protected <E extends java.lang.Enum<E>> E getAttributeAsOptionalEnum(java.lang.String name,
                                                                     java.lang.Class<E> enumClass,
                                                                     E def)