OpenJDK 27 · com.sun.org.apache.xml.internal.utils.ListingErrorHandler

Modifier and Type	Field and Description
protected PrintWriter	m_pw
protected boolean	throwOnError If we should throw exception on errors; default:true.
protected boolean	throwOnFatalError If we should throw exception on fatalErrors; default:true.
protected boolean	throwOnWarning If we should throw exception on warnings; default:false.

Access	Constructor and Description
public	ListingErrorHandler(PrintWriter pw) Constructor ListingErrorHandler; user-supplied PrintWriter.
public	ListingErrorHandler() Constructor ListingErrorHandler; uses System.err.

Method Summary

Modifier and Type	Method and Description
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 transformer 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 transformer exception. exception) Implements javax.xml.transform.ErrorListener.fatalError. Receive notification of a non-recoverable error.
protected static String	getSourceLine(String sourceUrl, int lineNum) Return the specific source line that caused the exception, if possible to load it; allow exceptions to be thrown.
public boolean	Returns: if we throw an exception on errors getThrowOnError() User-settable behavior: when to re-throw exceptions.
public boolean	Returns: if we throw an exception on fatalErrors getThrowOnFatalError() User-settable behavior: when to re-throw exceptions.
public boolean	Returns: if we throw an exception on warnings getThrowOnWarning() User-settable behavior: when to re-throw exceptions.
public static void	logExceptionLocation(PrintWriter PrintWriter to send output to pw, Throwable TransformerException or SAXParseException to log information about exception) Print out location information about the exception.
public static void	logSourceLine(PrintWriter PrintWriter to send output to pw, SourceLocator Xalan wrapper for either a JAXP or a SAX source location object locator) Print out the specific source line that caused the exception, if possible to load it.
private static URL	newURL(String spec)
public void	setThrowOnError(boolean if we should throw an exception on errors b) User-settable behavior: when to re-throw exceptions.
public void	setThrowOnFatalError(boolean if we should throw an exception on fatalErrors b) User-settable behavior: when to re-throw exceptions.
public void	setThrowOnWarning(boolean if we should throw an exception on warnings b) User-settable behavior: when to re-throw exceptions.
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 transformer exception. exception) Implements javax.xml.transform.ErrorListener.warning. Receive notification of a warning.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

m_pw	back to summary
protected PrintWriter m_pw

throwOnError	back to summary
protected boolean throwOnError If we should throw exception on errors; default:true.

throwOnFatalError	back to summary
protected boolean throwOnFatalError If we should throw exception on fatalErrors; default:true.

throwOnWarning	back to summary
protected boolean throwOnWarning If we should throw exception on warnings; default:false.

ListingErrorHandler	back to summary
public ListingErrorHandler(PrintWriter pw) Constructor ListingErrorHandler; user-supplied PrintWriter.

ListingErrorHandler	back to summary
public ListingErrorHandler() Constructor ListingErrorHandler; uses System.err.

Method Detail

error back to summary

error	back 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. Filters may use this method to report other, non-XML errors as well. Parameters exception:SAXParseException The error information encapsulated in a SAX parse exception. Exceptions SAXException: Any SAX exception, possibly wrapping another exception; only if setThrowOnErroris true. See Also `org.xml.sax.SAXParseException`

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.

Filters may use this method to report other, non-XML errors as well.

Parameters

exception:SAXParseException: The error information encapsulated in a SAX parse exception.

Exceptions

SAXException:: Any SAX exception, possibly wrapping another exception; only if setThrowOnErroris true.

See Also

org.xml.sax.SAXParseException

error back to summary

error	back to summary
public void error(TransformerException exception) throws TransformerException Implements javax.xml.transform.ErrorListener.error. Receive notification of a recoverable error. The transformer must continue to try and provide normal transformation after invoking this method. It should still be possible for the application to process the document through to the end if no other errors are encountered. Parameters exception:TransformerException The error information encapsulated in a transformer exception. Exceptions TransformerException: only if setThrowOnError is true. See Also `javax.xml.transform.TransformerException`

public void error(TransformerException exception) throws TransformerException

Implements javax.xml.transform.ErrorListener.error.

Receive notification of a recoverable error.

The transformer must continue to try and provide normal transformation after invoking this method. It should still be possible for the application to process the document through to the end if no other errors are encountered.

Parameters

exception:TransformerException: The error information encapsulated in a transformer exception.

Exceptions

TransformerException:: only if setThrowOnError is true.

fatalError back to summary

fatalError	back 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; only if setThrowOnFatalError is true. See Also `org.xml.sax.SAXParseException`

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; only if setThrowOnFatalError is true.

See Also

org.xml.sax.SAXParseException

fatalError back to summary

fatalError	back to summary
public void fatalError(TransformerException exception) throws TransformerException Implements javax.xml.transform.ErrorListener.fatalError. Receive notification of a non-recoverable error. The transformer must continue to try and provide normal transformation after invoking this method. It should still be possible for the application to process the document through to the end if no other errors are encountered, but there is no guarantee that the output will be useable. Parameters exception:TransformerException The error information encapsulated in a transformer exception. Exceptions TransformerException: only if setThrowOnError is true. See Also `javax.xml.transform.TransformerException`

public void fatalError(TransformerException exception) throws TransformerException

Implements javax.xml.transform.ErrorListener.fatalError.

Receive notification of a non-recoverable error.

Parameters

exception:TransformerException: The error information encapsulated in a transformer exception.

Exceptions

TransformerException:: only if setThrowOnError is true.

getSourceLine	back to summary
protected static String getSourceLine(String sourceUrl, int lineNum) throws Exception Return the specific source line that caused the exception, if possible to load it; allow exceptions to be thrown. Author [email protected]

getSourceLine

back to summary

protected static String getSourceLine(String sourceUrl, int lineNum) throws Exception

Return the specific source line that caused the exception, if possible to load it; allow exceptions to be thrown.

Author: [email protected]

getThrowOnError	back to summary
public boolean getThrowOnError() User-settable behavior: when to re-throw exceptions. Returns:boolean if we throw an exception on errors

getThrowOnError

back to summary

public boolean getThrowOnError()

User-settable behavior: when to re-throw exceptions.

Returns:boolean: if we throw an exception on errors

getThrowOnFatalError	back to summary
public boolean getThrowOnFatalError() User-settable behavior: when to re-throw exceptions. Returns:boolean if we throw an exception on fatalErrors

getThrowOnFatalError

back to summary

public boolean getThrowOnFatalError()

User-settable behavior: when to re-throw exceptions.

Returns:boolean: if we throw an exception on fatalErrors

getThrowOnWarning	back to summary
public boolean getThrowOnWarning() User-settable behavior: when to re-throw exceptions. Returns:boolean if we throw an exception on warnings

getThrowOnWarning

back to summary

public boolean getThrowOnWarning()

User-settable behavior: when to re-throw exceptions.

Returns:boolean: if we throw an exception on warnings

logExceptionLocation	back to summary
public static void logExceptionLocation(PrintWriter pw, Throwable exception) Print out location information about the exception. Cribbed from DefaultErrorHandler.printLocation() Parameters pw:PrintWriter PrintWriter to send output to exception:Throwable TransformerException or SAXParseException to log information about

logExceptionLocation

back to summary

public static void logExceptionLocation(PrintWriter pw, Throwable exception)

Print out location information about the exception. Cribbed from DefaultErrorHandler.printLocation()

Parameters

pw:PrintWriter: PrintWriter to send output to
exception:Throwable: TransformerException or SAXParseException to log information about

logSourceLine	back to summary
public static void logSourceLine(PrintWriter pw, SourceLocator locator) Print out the specific source line that caused the exception, if possible to load it. Parameters pw:PrintWriter PrintWriter to send output to locator:SourceLocator Xalan wrapper for either a JAXP or a SAX source location object

logSourceLine

back to summary

public static void logSourceLine(PrintWriter pw, SourceLocator locator)

Print out the specific source line that caused the exception, if possible to load it.

Parameters

pw:PrintWriter: PrintWriter to send output to
locator:SourceLocator: Xalan wrapper for either a JAXP or a SAX source location object

newURL	back to summary
private static URL newURL(String spec) throws MalformedURLException Annotations @SuppressWarnings:deprecation

setThrowOnError	back to summary
public void setThrowOnError(boolean b) User-settable behavior: when to re-throw exceptions. This allows per-instance configuration of ListingErrorHandlers. You can ask us to either throw an exception when we're called for various warning / error / fatalErrors, or simply log them and continue. Note that the behavior of many parsers/transformers after an error is not necessarily defined! Parameters b:boolean if we should throw an exception on errors

setThrowOnError

back to summary

public void setThrowOnError(boolean b)

User-settable behavior: when to re-throw exceptions.

This allows per-instance configuration of ListingErrorHandlers. You can ask us to either throw an exception when we're called for various warning / error / fatalErrors, or simply log them and continue.

Note that the behavior of many parsers/transformers after an error is not necessarily defined!

Parameters

b:boolean: if we should throw an exception on errors

setThrowOnFatalError	back to summary
public void setThrowOnFatalError(boolean b) User-settable behavior: when to re-throw exceptions. This allows per-instance configuration of ListingErrorHandlers. You can ask us to either throw an exception when we're called for various warning / error / fatalErrors, or simply log them and continue. Note that the behavior of many parsers/transformers after a fatalError is not necessarily defined, most products will probably barf if you continue. Parameters b:boolean if we should throw an exception on fatalErrors

setThrowOnFatalError

back to summary

public void setThrowOnFatalError(boolean b)

User-settable behavior: when to re-throw exceptions.

Note that the behavior of many parsers/transformers after a fatalError is not necessarily defined, most products will probably barf if you continue.

Parameters

b:boolean: if we should throw an exception on fatalErrors

setThrowOnWarning	back to summary
public void setThrowOnWarning(boolean b) User-settable behavior: when to re-throw exceptions. This allows per-instance configuration of ListingErrorHandlers. You can ask us to either throw an exception when we're called for various warning / error / fatalErrors, or simply log them and continue. Parameters b:boolean if we should throw an exception on warnings

setThrowOnWarning

back to summary

public void setThrowOnWarning(boolean b)

User-settable behavior: when to re-throw exceptions.

Parameters

b:boolean: if we should throw an exception on warnings

warning back to summary

warning	back 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. Filters may use this method to report other, non-XML warnings as well. Parameters exception:SAXParseException The warning information encapsulated in a SAX parse exception. Exceptions SAXException: Any SAX exception, possibly wrapping another exception; only if setThrowOnWarning is true. See Also `org.xml.sax.SAXParseException`

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.

Filters may use this method to report other, non-XML warnings as well.

Parameters

exception:SAXParseException: The warning information encapsulated in a SAX parse exception.

Exceptions

SAXException:: Any SAX exception, possibly wrapping another exception; only if setThrowOnWarning is true.

See Also

org.xml.sax.SAXParseException

warning back to summary

warning	back to summary
public void warning(TransformerException exception) throws TransformerException Implements javax.xml.transform.ErrorListener.warning. Receive notification of a warning. `javax.xml.transform.Transformer` can use this method to report conditions that are not errors or fatal errors. The default behaviour is to take no action. After invoking this method, the Transformer must continue with the transformation. 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 transformer exception. Exceptions TransformerException: only if setThrowOnWarning is true. See Also `javax.xml.transform.TransformerException`

public void warning(TransformerException exception) throws TransformerException

Implements javax.xml.transform.ErrorListener.warning.

Receive notification of a warning.

javax.xml.transform.Transformer can use this method to report conditions that are not errors or fatal errors. The default behaviour is to take no action.

After invoking this method, the Transformer must continue with the transformation. 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 transformer exception.

Exceptions

TransformerException:: only if setThrowOnWarning is true.

public Class ListingErrorHandler

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail