Class StAXParser<T>

java.lang.Object

org.tquadrat.foundation.xml.parse.spi.StAXParserBase<T>

org.tquadrat.foundation.xml.parse.StAXParser<T>

Type Parameters:

T - The type of the target data structure.

@ClassVersion(sourceVersion="$Id: StAXParser.java 1152 2025-12-25 09:51:42Z tquadrat $")
@API(status=EXPERIMENTAL,
     since="0.0.5")
public final class StAXParser<T>
extends StAXParserBase<T>

Parses an XML stream to an object of type T; that object is either provided with the constructor StAXParser(Object) or will be created by an instance of XMLParseEventHandler.

To start the parsing process, call StAXParserBase.parse(XMLEventReader) on the instance of StAXParser.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: StAXParser.java 1152 2025-12-25 09:51:42Z tquadrat $

Since:

0.0.5

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.xml.parse.StAXParser"

⁠

Field Summary

Fields inherited from class StAXParserBase

MSG_NoHandler, MSG_UnexpectedTag

Constructor Summary

Constructors

Constructor	Description
StAXParser()	Creates a new StAXParser instance.
StAXParser(T target)	Creates a new StAXParser instance.

Method Summary

Modifier and Type	Method	Description
final void	addDocumentHandler(String elementName, XMLParseEventHandler<T> handler)	Adds the document handler.
final void	addElementHandler(String elementName, XMLParseEventHandler<?> handler)	Adds an element handler.

Methods inherited from class StAXParserBase

parse, registerElementHandler, reportUnexpectedTag

Methods inherited from class Object

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

Constructor Details

StAXParser

public StAXParser()

Creates a new StAXParser instance.

StAXParser

public StAXParser(T target)

Creates a new StAXParser instance.

Parameters:

target - The target data structure.

Method Details

addDocumentHandler

public final void addDocumentHandler(String elementName,
 XMLParseEventHandler<T> handler)

Adds the document handler.

This handler must create or update the target data structure.

Parameters:

elementName - The element name for the document.

handler - The parse event handler.

addElementHandler

public final void addElementHandler(String elementName,
 XMLParseEventHandler<?> handler)

Adds an element handler.

These handlers will be called from inside another parse event handler.

Parameters:

elementName - The element name.

handler - The parse event handler.