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>	Interface used by parseChildren(C, java.lang.String, cdc.util.xml.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)	Throws an InvcaliudDataExeption.
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)	Checks that current event type is END_DOCUMENT.
protected void	expectEndElement(java.lang.String context, java.lang.String name)	Checks that current event type is END_ELEMNT.
protected void	expectStartDocument(java.lang.String context)	Checks that current event type is START_DOCUMENT.
protected void	expectStartElement(java.lang.String context, java.lang.String name)	Checks that current event type is START_ELEMNT.
protected boolean	getAttributeAsBoolean(java.lang.String name, boolean def)
protected boolean	getAttributeAsBoolean(java.lang.String name, boolean def, cdc.util.lang.FailureReaction missingReaction, cdc.util.lang.FailureReaction errorReaction)
protected byte	getAttributeAsByte(java.lang.String name, byte def)
protected byte	getAttributeAsByte(java.lang.String name, byte def, cdc.util.lang.FailureReaction missingReaction, cdc.util.lang.FailureReaction errorReaction)
protected double	getAttributeAsDouble(java.lang.String name, double def)
protected double	getAttributeAsDouble(java.lang.String name, double def, cdc.util.lang.FailureReaction missingReaction, cdc.util.lang.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, cdc.util.lang.FailureReaction missingReaction, cdc.util.lang.FailureReaction errorReaction)
protected float	getAttributeAsFloat(java.lang.String name, float def)
protected float	getAttributeAsFloat(java.lang.String name, float def, cdc.util.lang.FailureReaction missingReaction, cdc.util.lang.FailureReaction errorReaction)
protected int	getAttributeAsInt(java.lang.String name, int def)
protected int	getAttributeAsInt(java.lang.String name, int def, cdc.util.lang.FailureReaction missingReaction, cdc.util.lang.FailureReaction errorReaction)
protected long	getAttributeAsLong(java.lang.String name, long def)
protected long	getAttributeAsLong(java.lang.String name, long def, cdc.util.lang.FailureReaction missingReaction, cdc.util.lang.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, cdc.util.lang.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, cdc.util.lang.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, cdc.util.lang.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, cdc.util.lang.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, cdc.util.lang.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, cdc.util.lang.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, cdc.util.lang.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, cdc.util.lang.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, cdc.util.lang.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, cdc.util.lang.FailureReaction missingReaction, cdc.util.lang.FailureReaction errorReaction)
protected short	getAttributeAsShort(java.lang.String name, short def)
protected short	getAttributeAsShort(java.lang.String name, short def, cdc.util.lang.FailureReaction missingReaction, cdc.util.lang.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, cdc.util.lang.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 int	next()	Gets the next parsing event.
protected int	nextTag()	Skips any white space (isWhiteSpace() returns true), COMMENT, or PROCESSING_INSTRUCTION, until a START_ELEMENT or END_ELEMENT is reached.
protected abstract R	parse()	Base method called to parse the stream.
protected <C> void	parseChildren(C context, java.lang.String name, AbstractStAXParser.ElementParser<C> childParser)	Utility used to parse an element and all its children.
protected void	unexpectedEvent()	Throws an InvalidDataException to indcate an event is unexpected.

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

Base method called to parse the stream.

Returns:

The parsed result.

Throws:

javax.xml.stream.XMLStreamException - When there is an error parsing the underlying XML source.

error

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

Throws an InvcaliudDataExeption.

Parameters:

message - The exception message.

Throws:

cdc.util.lang.InvalidDataException - In all cases.

unexpectedEvent

protected final void unexpectedEvent()

Throws an InvalidDataException to indcate an event is unexpected.

Throws:

cdc.util.lang.InvalidDataException - In all cases.

next

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

Gets the next parsing event.

It is a simple wrapper of XMLStreamReader.next().

Returns:

The integer code corresponding to the current parse event.

Throws:

javax.xml.stream.XMLStreamException - When there is an error parsing the underlying XML source.

nextTag

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

Skips any white space (isWhiteSpace() returns true), COMMENT, or PROCESSING_INSTRUCTION, until a START_ELEMENT or END_ELEMENT is reached.

It is a simple wrapper of XMLStreamReader.nextTag().

If other than white space characters, COMMENT, PROCESSING_INSTRUCTION, START_ELEMENT, END_ELEMENT are encountered, an exception is thrown. This method should be used when processing element-only content separeted by white space.

Returns:

The event type of the element read (START_ELEMENT or END_ELEMENT).

Throws:

javax.xml.stream.XMLStreamException - When the current event is not white space, PROCESSING_INSTRUCTION, START_ELEMENT or END_ELEMENT.

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

Utility used to parse an element and all its children.

Type Parameters:

C - The context type.

Parameters:

context - The context to pass to childPareser.

name - The element name.

childParser - The child parser.

Throws:

javax.xml.stream.XMLStreamException - When there is an error parsing the underlying XML source.

expect

protected void expect(java.lang.String context,
                      int eventType)

Checks that current event type is an expected one.

If false, raises an exception.

Parameters:

context - The call context.

eventType - The expected event type.

Throws:

cdc.util.lang.InvalidDataException - When current event type is not the expected one.

expectStartElement

protected void expectStartElement(java.lang.String context,
                                  java.lang.String name)

Checks that current event type is START_ELEMNT.

If false, raises an exception.

Parameters:

context - The call context.

name - The expected element name.

Throws:

cdc.util.lang.InvalidDataException - When current event type is not START_ELEMENT or name does not match.

expectEndElement

protected void expectEndElement(java.lang.String context,
                                java.lang.String name)

Checks that current event type is END_ELEMNT.

If false, raises an exception.

Parameters:

context - The call context.

name - The expected element name.

Throws:

cdc.util.lang.InvalidDataException - When current event type is not END_ELEMENT or name does not match.

expectStartDocument

protected void expectStartDocument(java.lang.String context)

Checks that current event type is START_DOCUMENT.

If false, raises an exception.

Parameters:

context - The call context.

Throws:

cdc.util.lang.InvalidDataException - When current event type is not START_DOCUMENT.

expectEndDocument

protected void expectEndDocument(java.lang.String context)

Checks that current event type is END_DOCUMENT.

If false, raises an exception.

Parameters:

context - The call context.

Throws:

cdc.util.lang.InvalidDataException - When current event type is not END_DOCUMENT.

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,
                                             cdc.util.lang.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:

cdc.util.lang.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,
                                        cdc.util.lang.FailureReaction missingReaction,
                                        cdc.util.lang.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,
                                                          cdc.util.lang.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,
                                  cdc.util.lang.FailureReaction missingReaction,
                                  cdc.util.lang.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,
                                                    cdc.util.lang.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,
                                cdc.util.lang.FailureReaction missingReaction,
                                cdc.util.lang.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,
                                                      cdc.util.lang.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,
                                    cdc.util.lang.FailureReaction missingReaction,
                                    cdc.util.lang.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,
                                                      cdc.util.lang.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,
                                  cdc.util.lang.FailureReaction missingReaction,
                                  cdc.util.lang.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,
                                                    cdc.util.lang.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,
                                      cdc.util.lang.FailureReaction missingReaction,
                                      cdc.util.lang.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,
                                                        cdc.util.lang.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,
                                    cdc.util.lang.FailureReaction missingReaction,
                                    cdc.util.lang.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,
                                                      cdc.util.lang.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,
                                                  cdc.util.lang.FailureReaction missingReaction,
                                                  cdc.util.lang.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,
                                                          cdc.util.lang.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,
                                                             cdc.util.lang.FailureReaction missingReaction,
                                                             cdc.util.lang.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,
                                                                     cdc.util.lang.FailureReaction errorReaction)

getAttributeAsOptionalEnum

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