com.xmlmill
Class JAXPErrorHandler

java.lang.Object
  |
  +--com.xmlmill.JAXPErrorHandler

All Implemented Interfaces:

org.xml.sax.ErrorHandler, javax.xml.transform.ErrorListener

public class JAXPErrorHandler

extends java.lang.Object

implements org.xml.sax.ErrorHandler, javax.xml.transform.ErrorListener

The JAXPErrorHandler instance knows if the transformation of a .pdf document should be aborted when a SAXParseException or javax.xml.transform.TransformerException warning or error occurs.

Since:

1.00

Version:

1.00

Author:

Stefan Geelen, support@xmlmill.com

Field Summary

static int	ABORT_ON_ERROR bit mask value for flag : abort on error message
static int	ABORT_ON_WARNING bit mask value for flag : abort on warning message

Constructor Summary

JAXPErrorHandler()
Zero argument default constructor.

JAXPErrorHandler(int flags)
Default constructor.

Method Summary

void	error(org.xml.sax.SAXParseException e) Receives notification of a recoverable parser error.
void	error(javax.xml.transform.TransformerException exception) Report a transformer error.
void	fatalError(org.xml.sax.SAXParseException e) Report a fatal parsing error.
void	fatalError(javax.xml.transform.TransformerException exception) Report a transformer fatalerror.
boolean	isAbortOnError() Returns if the transformation is aborted when a error has occured.
boolean	isAbortOnWarning() Returns if the transformation is aborted when a warning has occured.
void	warning(org.xml.sax.SAXParseException e) Report a parser warning.
void	warning(javax.xml.transform.TransformerException exception) Report a transformer warning.

Methods inherited from class java.lang.Object

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

Field Detail

ABORT_ON_ERROR

public static final int ABORT_ON_ERROR

bit mask value for flag : abort on error message

ABORT_ON_WARNING

public static final int ABORT_ON_WARNING

bit mask value for flag : abort on warning message

Constructor Detail

JAXPErrorHandler

public JAXPErrorHandler()

Zero argument default constructor.

The default errorhandler will stop parsing after a SAXParseException or javax.xml.transform.TransformerException fatal error has occured. This mimics the default behavior of a SAX2 compliant parser. A fatal error will always cause the parser to stop.

Since:

1.35

JAXPErrorHandler

public JAXPErrorHandler(int flags)

Default constructor.

The errorhandler can be constructed with a certain behavior concerning whether or not to abort when SAXParseException or javax.xml.transform.TransformerException warnings or errors occurs.

Parameters:

flags - int representing the behavior of the errorhandler regarding whether or not to abort when warnings or errors occurs.

Since:

1.35

See Also:

ABORT_ON_ERROR, ABORT_ON_WARNING

Method Detail

isAbortOnWarning

public boolean isAbortOnWarning()

Returns if the transformation is aborted when a warning has occured.

Since:

1.35

isAbortOnError

public boolean isAbortOnError()

Returns if the transformation is aborted when a error has occured.

Since:

1.35

error

public void error(org.xml.sax.SAXParseException e)
           throws org.xml.sax.SAXParseException

Receives notification of a recoverable parser error.

Depending on the flags set, this message will be written to the log file and the application may stop processing.

Specified by:

error in interface org.xml.sax.ErrorHandler

Parameters:

e - The warning information encoded as an exception.

Throws:

org.xml.sax.SAXParseException - Any SAX Parse exception.

Since:

1.35

See Also:

ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

fatalError

public void fatalError(org.xml.sax.SAXParseException e)
                throws org.xml.sax.SAXParseException

Report a fatal parsing error.

A fatal SAXParseException is always written to in the errorlog and the application will stop all processing when this method is invoked, since the document is no longer reliable, and the parser may no longer report parsing events.

Specified by:

fatalError in interface org.xml.sax.ErrorHandler

Parameters:

e - The error information encoded as an exception.

Throws:

org.xml.sax.SAXParseException - Any SAX Parse exception.

Since:

1.35

See Also:

ErrorHandler.fatalError(org.xml.sax.SAXParseException), SAXParseException

warning

public void warning(org.xml.sax.SAXParseException e)
             throws org.xml.sax.SAXParseException

Report a parser warning.

Depending on the flags set, this message will be written to the log file and the application may stop processing.

Specified by:

warning in interface org.xml.sax.ErrorHandler

Parameters:

e - The warning information encoded as an exception.

Throws:

org.xml.sax.SAXParseException - Any SAX Parse exception.

Since:

1.35

See Also:

ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

error

public void error(javax.xml.transform.TransformerException exception)
           throws javax.xml.transform.TransformerException

Report a transformer error.

Depending on the flags set, the application may stop processing.

Specified by:

error in interface javax.xml.transform.ErrorListener

Parameters:

exception - The fatalerror information encoded as an exception.

Throws:

javax.xml.transform.TransformerException -

Since:

1.50

fatalError

public void fatalError(javax.xml.transform.TransformerException exception)
                throws javax.xml.transform.TransformerException

Report a transformer fatalerror.

The application will stop processing.

Specified by:

fatalError in interface javax.xml.transform.ErrorListener

Parameters:

exception - The fatalerror information encoded as an exception.

Throws:

javax.xml.transform.TransformerException -

Since:

1.50

warning

public void warning(javax.xml.transform.TransformerException exception)
             throws javax.xml.transform.TransformerException

Report a transformer warning.

Depending on the flags set, the application may stop processing.

Specified by:

warning in interface javax.xml.transform.ErrorListener

Parameters:

exception - The warning information encoded as an exception.

Throws:

javax.xml.transform.TransformerException -

Since:

1.50