org.conqat.lib.commons.xml

Class ElementEnumSaxHandler<ELEMENT extends java.lang.Enum<ELEMENT> & ElementEnumSaxHandler.IElementEnum<ELEMENT>>

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.conqat.lib.commons.xml.ElementEnumSaxHandler<ELEMENT>

All Implemented Interfaces:

org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

public class ElementEnumSaxHandler<ELEMENT extends java.lang.Enum<ELEMENT> & ElementEnumSaxHandler.IElementEnum<ELEMENT>>
extends org.xml.sax.helpers.DefaultHandler

SAX XML Parser DefaultHandler implementation that matches XML elements to enumeration values using the enumeration name. The enumeration has to implement the interface ElementEnumSaxHandler.IElementEnum and thus defines a state graph of an XML element sequence for parsing the document.

The parser offers registration of ElementEnumSaxHandler.ElementHandlers for each of the enumeration elements that will be called for the start and end of the element. If capturing the inner text of elements is desired a ElementEnumSaxHandler.TextElementHandler has to be registered.

Resolving element names to enum constants is performed using a ElementEnumSaxHandler.JavaConstantResolver but can be altered using setElementResolver(IElementResolver).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ElementEnumSaxHandler.ElementHandler<ELEMENT> Handler for start and element callbacks.
static interface	ElementEnumSaxHandler.IElementEnum<E extends java.lang.Enum<E>> Interface that defines methods for getting the next elements for parsing the document.
static interface	ElementEnumSaxHandler.IElementResolver Resolver from XML element names to enumeration names.
static class	ElementEnumSaxHandler.JavaConstantResolver Resolver that normalizes XML element names to valid Java identifiers.
static class	ElementEnumSaxHandler.TextElementHandler<ELEMENT> Handler for text callbacks in addition to the callbacks defined in ElementEnumSaxHandler.ElementHandler.

Constructor Summary

Constructors

Constructor and Description
ElementEnumSaxHandler(ELEMENT initialElement) Constructor.

Method Summary

Modifier and Type	Method and Description
void	characters(char[] ch, int start, int length)
void	endElement(java.lang.String uri, java.lang.String localName, java.lang.String qName)
void	setElementHandler(ELEMENT element, ElementEnumSaxHandler.ElementHandler<ELEMENT> handler) Sets (or overrides) the element handler for a given element.
void	setElementResolver(ElementEnumSaxHandler.IElementResolver resolver)
void	startElement(java.lang.String uri, java.lang.String localName, java.lang.String qName, org.xml.sax.Attributes attributes)

Methods inherited from class org.xml.sax.helpers.DefaultHandler

endDocument, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

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

Constructor Detail

ElementEnumSaxHandler

public ElementEnumSaxHandler(ELEMENT initialElement)

Constructor.

Method Detail

setElementHandler

public void setElementHandler(ELEMENT element,
                              ElementEnumSaxHandler.ElementHandler<ELEMENT> handler)

Sets (or overrides) the element handler for a given element.

setElementResolver

public void setElementResolver(ElementEnumSaxHandler.IElementResolver resolver)

See Also:

resolver

startElement

public void startElement(java.lang.String uri,
                         java.lang.String localName,
                         java.lang.String qName,
                         org.xml.sax.Attributes attributes)
                  throws org.xml.sax.SAXException

Specified by:

startElement in interface org.xml.sax.ContentHandler

Overrides:

startElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

characters

public void characters(char[] ch,
                       int start,
                       int length)

Specified by:

characters in interface org.xml.sax.ContentHandler

Overrides:

characters in class org.xml.sax.helpers.DefaultHandler

endElement

public void endElement(java.lang.String uri,
                       java.lang.String localName,
                       java.lang.String qName)
                throws org.xml.sax.SAXException

Specified by:

endElement in interface org.xml.sax.ContentHandler

Overrides:

endElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException