GXPARSE hosted by SourceForge.net Logo

ca.gorman.xml.parse
Interface CharacterListener<T extends Parser>

All Known Subinterfaces:
Listener<T>
All Known Implementing Classes:
AbstractErrorListener, AbstractListener, CoroutineCheckListener, DumpListener, SkipListener

public interface CharacterListener<T extends Parser>

Character listener interface for XML processing applications that are driven by an XML push Parser.


Method Summary
 void characters(T parser, CharSequence charSequence)
           Receive notification of characters.
 void ignorableWhitespace(T parser, CharSequence charSequence)
           Receive notification of ignorable whitespace characters.
 

Method Detail

characters

void characters(T parser,
                CharSequence charSequence)
                throws ListenerException,
                       IOException

Receive notification of characters.

In some implementations, charSequence may reference data that is not resident in memory. In such cases, the amount of data may be large enough to cause the CharSequence.toString() method to throw OutOfMemoryError.

Parameters:
parser - The Parser that invoked this method
charSequence - A CharSequence containing the character data from the XML document.
Throws:
ListenerException
IOException

ignorableWhitespace

void ignorableWhitespace(T parser,
                         CharSequence charSequence)
                         throws ListenerException,
                                IOException

Receive notification of ignorable whitespace characters.

In some implementations, charSequence may reference data that is not resident in memory. In such cases, the amount of data may be large enough to cause the CharSequence.toString() method to throw OutOfMemoryError.

Parameters:
parser - The Parser that invoked this method
charSequence - A CharSequence containing the whitespace from the XML document.
Throws:
ListenerException
IOException

GXPARSE download

GXPARSE Generic XML Stream Parser API and supporting tools.   Release $Name: gxparse-sf-alpha-2_0 $
Copyright 2003-2004 Ian E. Gorman
Released under GNU Lesser General Public License