de.intarsys.tools.sax

Class DelegatingElementHandler

java.lang.Object

de.intarsys.tools.sax.SAXAbstractElementHandler

de.intarsys.tools.sax.DelegatingElementHandler

All Implemented Interfaces:

ISAXElementHandler

public class DelegatingElementHandler
extends SAXAbstractElementHandler

An ISAXElementHandler that delegates to another handler that is explicitly mentioned in an attribute in an element attribute. This allows the use of generic containers that do not necessarily know about their content. The default attribute to be used is "deserializer"

Constructor Summary

Constructors

Constructor and Description
DelegatingElementHandler()
DelegatingElementHandler(String handlerAttribute)

Method Summary

Methods

Modifier and Type	Method and Description
void	characters(char[] ch, int start, int length) this message is sent when characters are available to the receiver
void	endChildElement(ISAXElementHandler element) this message is sent when a child element has been terminated
void	endElement(String pUri, String local, String name) this message is sent when the receiver is about to end
String	getHandlerAttribute()
Object	getResult() An optional result object to be returned when this element is finished.
void	initialize(String pUri, String local, String name, Attributes attrs) docme
void	processAttributes(Attributes attrs) this message is sent - after is is initialized()
void	registerAlias(String alias, String name)
void	startChildElement(ISAXElementHandler element) this message is sent when a child element has been created
void	started() this message is sent - after all houskeeping with the element is done - before any other SAX event can reach the receiver
ISAXElementHandler	startElement(String pUri, String local, String name, Attributes attrs) this message is sent - when the receiver is requested to create a child element
void	unregisterAlias(String alias)

Methods inherited from class de.intarsys.tools.sax.SAXAbstractElementHandler

endDocumentElement, getChars, getColumn, getContextHandler, getData, getEndColumn, getEndLine, getLine, getLocalName, getLocator, getNesting, getParameters, getParent, getPath, getURI, ignorableWhitespace, initializeDocumentElement, isCharacterDataAllowed, isDocumentHandler, isLeaf, isRootElementHandler, isWhitespaceAllowed, markEndLocation, markStartLocation, processAttribute, reset, setChars, setColumn, setContextHandler, setLine, setLocalName, setParent, setURI

Methods inherited from class java.lang.Object

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

Constructor Detail

DelegatingElementHandler

public DelegatingElementHandler()

DelegatingElementHandler

public DelegatingElementHandler(String handlerAttribute)

Method Detail

characters

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

Description copied from interface: ISAXElementHandler

this message is sent when characters are available to the receiver

Specified by:

characters in interface ISAXElementHandler

Overrides:

characters in class SAXAbstractElementHandler

Parameters:

ch - the array of characters

start - start index of first char to read

length - number of chars to read

Throws:

SAXException - if error

See Also:

endChildElement

public void endChildElement(ISAXElementHandler element)
                     throws SAXException

Description copied from interface: ISAXElementHandler

this message is sent when a child element has been terminated

Specified by:

endChildElement in interface ISAXElementHandler

Overrides:

endChildElement in class SAXAbstractElementHandler

Parameters:

element - the child element previously created by the receiver that is terminated now

Throws:

SAXException - if error

See Also:

endElement

public void endElement(String pUri,
              String local,
              String name)
                throws SAXException

Description copied from interface: ISAXElementHandler

this message is sent when the receiver is about to end

Specified by:

endElement in interface ISAXElementHandler

Overrides:

endElement in class SAXAbstractElementHandler

Parameters:

pUri - the SAX namspace uri

local - the SAX local name

name - the SAX qualified name

Throws:

SAXException - if error

See Also:

org.xml.sax

getHandlerAttribute

public String getHandlerAttribute()

getResult

public Object getResult()

Description copied from interface: ISAXElementHandler

An optional result object to be returned when this element is finished.

Specified by:

getResult in interface ISAXElementHandler

Overrides:

getResult in class SAXAbstractElementHandler

Returns:

An optional result object:

initialize

public void initialize(String pUri,
              String local,
              String name,
              Attributes attrs)
                throws SAXException

Description copied from class: SAXAbstractElementHandler

docme

Specified by:

initialize in interface ISAXElementHandler

Overrides:

initialize in class SAXAbstractElementHandler

local - docme

name - docme

attrs - docme

Throws:

SAXException - docme

processAttributes

public void processAttributes(Attributes attrs)
                       throws SAXException

Description copied from interface: ISAXElementHandler

this message is sent - after is is initialized()

Specified by:

processAttributes in interface ISAXElementHandler

Overrides:

processAttributes in class SAXAbstractElementHandler

Throws:

SAXException

registerAlias

public void registerAlias(String alias,
                 String name)

startChildElement

public void startChildElement(ISAXElementHandler element)
                       throws SAXException

Description copied from interface: ISAXElementHandler

this message is sent when a child element has been created

Specified by:

startChildElement in interface ISAXElementHandler

Overrides:

startChildElement in class SAXAbstractElementHandler

Parameters:

element - the child element created

Throws:

SAXException - if error

started

public void started()
             throws SAXException

Description copied from interface: ISAXElementHandler

this message is sent - after all houskeeping with the element is done - before any other SAX event can reach the receiver

Specified by:

started in interface ISAXElementHandler

Overrides:

started in class SAXAbstractElementHandler

Throws:

SAXException

startElement

public ISAXElementHandler startElement(String pUri,
                              String local,
                              String name,
                              Attributes attrs)
                                throws SAXException

Description copied from interface: ISAXElementHandler

this message is sent - when the receiver is requested to create a child element

Specified by:

startElement in interface ISAXElementHandler

Overrides:

startElement in class SAXAbstractElementHandler

Returns:

docme

Throws:

SAXException

unregisterAlias

public void unregisterAlias(String alias)