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

All Known Subinterfaces:

Listener<T>

All Known Implementing Classes:

AbstractErrorListener, AbstractListener, AbstractMessageListener, CoroutineCheckListener, DumpListener, SkipListener

public interface MessageListener<T extends Parser>

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

Method Summary

void	error(T parser, String description, Location location, Exception exception) Receive notification of a recoverable error.
void	fatalError(T parser, String description, Location location, Exception exception) Receive notification of a non-recoverable error.
void	warning(T parser, String description, Location location, Exception exception) Receive notification of a warning.

Method Detail

warning

void warning(T parser,
             String description,
             Location location,
             Exception exception)
             throws ListenerException,
                    IOException

Receive notification of a warning.

Parameters:

parser - The Parser that invoked this method

description - A summary of the warning information (may be an empty String).

location - Information about the location in the input

exception - Additional information from the underlying parser. The information will depend on the Parser implementation. The parameter may be null, and the underlying parser may not have actually thrown an exception.

Throws:

ListenerException

IOException

error

void error(T parser,
           String description,
           Location location,
           Exception exception)
           throws ListenerException,
                  IOException

Receive notification of a recoverable error.

Parameters:

parser - The Parser that invoked this method

description - A summary of the warning information (may be an empty String).

location - Information about the location in the input

exception - Additional information from the underlying parser. The information will depend on the Parser implementation. The parameter may be null, and the underlying parser may not have actually thrown an exception.

Throws:

ListenerException

IOException

fatalError

void fatalError(T parser,
                String description,
                Location location,
                Exception exception)
                throws ListenerException,
                       IOException

Receive notification of a non-recoverable error.

Parameters:

parser - The Parser that invoked this method

description - A summary of the warning information (may be an empty String).

location - Information about the location in the input

exception - Additional information from the underlying parser. The information will depend on the Parser implementation. The parameter may be null, and the underlying parser may not have actually thrown an exception.

Throws:

ListenerException

IOException