APIdia Launch Partner
Top Description Fields Constructors Methods
com.sun.org.apache.xml.internal.utils

public Class DefaultErrorHandler

extends Object
implements ErrorHandler, ErrorListener
Class Inheritance
All Implemented Interfaces
javax.xml.transform.ErrorListener, org.xml.sax.ErrorHandler
Imports
java.io.PrintStream, .PrintWriter, javax.xml.transform.ErrorListener, .SourceLocator, .TransformerException, com.sun.org.apache.xml.internal.res.XMLErrorResources, .XMLMessages, org.xml.sax.ErrorHandler, .SAXException, .SAXParseException

Implement SAX error handler for default reporting.

Field Summary

Modifier and TypeField and Description
pack-priv PrintWriter
pack-priv boolean
m_throwExceptionOnError

if this flag is set to true, we will rethrow the exception on the error() and fatalError() methods.

Constructor Summary

AccessConstructor and Description
public
DefaultErrorHandler(PrintWriter pw)

Constructor DefaultErrorHandler

public
DefaultErrorHandler(PrintStream pw)

Constructor DefaultErrorHandler

public
DefaultErrorHandler()

Constructor DefaultErrorHandler

public
DefaultErrorHandler(boolean throwExceptionOnError)

Constructor DefaultErrorHandler

Method Summary

Modifier and TypeMethod and Description
public static void
public void
error(SAXParseException
The error information encapsulated in a SAX parse exception.
exception
)

Implements org.xml.sax.ErrorHandler.error.

Receive notification of a recoverable error.

public void
error(TransformerException
The error information encapsulated in a SAX parse exception.
exception
)

Implements javax.xml.transform.ErrorListener.error.

Receive notification of a recoverable error.

public void
fatalError(SAXParseException
The error information encapsulated in a SAX parse exception.
exception
)

Implements org.xml.sax.ErrorHandler.fatalError.

Receive notification of a non-recoverable error.

public void
fatalError(TransformerException
The error information encapsulated in a SAX parse exception.
exception
)

Implements javax.xml.transform.ErrorListener.fatalError.

Receive notification of a non-recoverable error.

public static void
public static void
public static void
public void
warning(SAXParseException
The warning information encapsulated in a SAX parse exception.
exception
)

Implements org.xml.sax.ErrorHandler.warning.

Receive notification of a warning.

public void
warning(TransformerException
The warning information encapsulated in a SAX parse exception.
exception
)

Implements javax.xml.transform.ErrorListener.warning.

Receive notification of a warning.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

m_pwback to summary
pack-priv PrintWriter m_pw
m_throwExceptionOnErrorback to summary
pack-priv boolean m_throwExceptionOnError

if this flag is set to true, we will rethrow the exception on the error() and fatalError() methods. If it is false, the errors are reported to System.err.

Constructor Detail

DefaultErrorHandlerback to summary
public DefaultErrorHandler(PrintWriter pw)

Constructor DefaultErrorHandler

DefaultErrorHandlerback to summary
public DefaultErrorHandler(PrintStream pw)

Constructor DefaultErrorHandler

DefaultErrorHandlerback to summary
public DefaultErrorHandler()

Constructor DefaultErrorHandler

DefaultErrorHandlerback to summary
public DefaultErrorHandler(boolean throwExceptionOnError)

Constructor DefaultErrorHandler

Method Detail

ensureLocationSetback to summary
public static void ensureLocationSet(TransformerException exception)
errorback to summary
public void error(SAXParseException exception) throws SAXException

Implements org.xml.sax.ErrorHandler.error.

Receive notification of a recoverable error.

This corresponds to the definition of "error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a validating parser would use this callback to report the violation of a validity constraint. The default behaviour is to take no action.

The SAX parser must continue to provide normal parsing events after invoking this method: it should still be possible for the application to process the document through to the end. If the application cannot do so, then the parser should report a fatal error even if the XML 1.0 recommendation does not require it to do so.

Parameters
exception:SAXParseException

The error information encapsulated in a SAX parse exception.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
errorback to summary
public void error(TransformerException exception) throws TransformerException

Implements javax.xml.transform.ErrorListener.error.

Receive notification of a recoverable error.

This corresponds to the definition of "error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a validating parser would use this callback to report the violation of a validity constraint. The default behaviour is to take no action.

The SAX parser must continue to provide normal parsing events after invoking this method: it should still be possible for the application to process the document through to the end. If the application cannot do so, then the parser should report a fatal error even if the XML 1.0 recommendation does not require it to do so.

Parameters
exception:TransformerException

The error information encapsulated in a SAX parse exception.

Exceptions
TransformerException:
Any SAX exception, possibly wrapping another exception.
See Also
javax.xml.transform.TransformerException
fatalErrorback to summary
public void fatalError(SAXParseException exception) throws SAXException

Implements org.xml.sax.ErrorHandler.fatalError.

Receive notification of a non-recoverable error.

This corresponds to the definition of "fatal error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a parser would use this callback to report the violation of a well-formedness constraint.

The application must assume that the document is unusable after the parser has invoked this method, and should continue (if at all) only for the sake of collecting addition error messages: in fact, SAX parsers are free to stop reporting any other events once this method has been invoked.

Parameters
exception:SAXParseException

The error information encapsulated in a SAX parse exception.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
fatalErrorback to summary
public void fatalError(TransformerException exception) throws TransformerException

Implements javax.xml.transform.ErrorListener.fatalError.

Receive notification of a non-recoverable error.

This corresponds to the definition of "fatal error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a parser would use this callback to report the violation of a well-formedness constraint.

The application must assume that the document is unusable after the parser has invoked this method, and should continue (if at all) only for the sake of collecting addition error messages: in fact, SAX parsers are free to stop reporting any other events once this method has been invoked.

Parameters
exception:TransformerException

The error information encapsulated in a SAX parse exception.

Exceptions
TransformerException:
Any SAX exception, possibly wrapping another exception.
See Also
javax.xml.transform.TransformerException
printLocationback to summary
public static void printLocation(PrintStream pw, TransformerException exception)
printLocationback to summary
public static void printLocation(PrintStream pw, SAXParseException exception)
printLocationback to summary
public static void printLocation(PrintWriter pw, Throwable exception)
warningback to summary
public void warning(SAXParseException exception) throws SAXException

Implements org.xml.sax.ErrorHandler.warning.

Receive notification of a warning.

SAX parsers will use this method to report conditions that are not errors or fatal errors as defined by the XML 1.0 recommendation. The default behaviour is to take no action.

The SAX parser must continue to provide normal parsing events after invoking this method: it should still be possible for the application to process the document through to the end.

Parameters
exception:SAXParseException

The warning information encapsulated in a SAX parse exception.

Exceptions
SAXException:
Any SAX exception, possibly wrapping another exception.
warningback to summary
public void warning(TransformerException exception) throws TransformerException

Implements javax.xml.transform.ErrorListener.warning.

Receive notification of a warning.

SAX parsers will use this method to report conditions that are not errors or fatal errors as defined by the XML 1.0 recommendation. The default behaviour is to take no action.

The SAX parser must continue to provide normal parsing events after invoking this method: it should still be possible for the application to process the document through to the end.

Parameters
exception:TransformerException

The warning information encapsulated in a SAX parse exception.

Exceptions
TransformerException:
Any SAX exception, possibly wrapping another exception.
See Also
javax.xml.transform.TransformerException