blob: a582b3da9ff050f3440ccdb339d6074c380a64a0 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.5.0_18) on Sun Apr 01 21:18:38 PDT 2012 -->
<TITLE>
ListingErrorHandler
</TITLE>
<META NAME="keywords" CONTENT="org.apache.xml.utils.ListingErrorHandler class">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
parent.document.title="ListingErrorHandler";
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ListingErrorHandler.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../org/apache/xml/utils/IntVector.html" title="class in org.apache.xml.utils"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../../org/apache/xml/utils/LocaleUtility.html" title="class in org.apache.xml.utils"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?org/apache/xml/utils/ListingErrorHandler.html" target="_top"><B>FRAMES</B></A> &nbsp;
&nbsp;<A HREF="ListingErrorHandler.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
&nbsp;<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
org.apache.xml.utils</FONT>
<BR>
Class ListingErrorHandler</H2>
<PRE>
java.lang.Object
<IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>org.apache.xml.utils.ListingErrorHandler</B>
</PRE>
<DL>
<DT><B>All Implemented Interfaces:</B> <DD>javax.xml.transform.ErrorListener, org.xml.sax.ErrorHandler</DD>
</DL>
<HR>
<DL>
<DT><PRE>public class <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.54"><B>ListingErrorHandler</B></A><DT>extends java.lang.Object<DT>implements org.xml.sax.ErrorHandler, javax.xml.transform.ErrorListener</DL>
</PRE>
<P>
Sample implementation of similar SAX ErrorHandler and JAXP ErrorListener.
<p>This implementation is suitable for various use cases, and
provides some basic configuration API's as well to control
when we re-throw errors, etc.</p>
<P>
<P>
<HR>
<P>
<!-- =========== FIELD SUMMARY =========== -->
<A NAME="field_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Field Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;java.io.PrintWriter</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#m_pw">m_pw</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#throwOnError">throwOnError</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If we should throw exception on errors; default:true.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#throwOnFatalError">throwOnFatalError</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If we should throw exception on fatalErrors; default:true.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#throwOnWarning">throwOnWarning</A></B></CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If we should throw exception on warnings; default:false.</TD>
</TR>
</TABLE>
&nbsp;
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#ListingErrorHandler()">ListingErrorHandler</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructor ListingErrorHandler; uses System.err.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#ListingErrorHandler(java.io.PrintWriter)">ListingErrorHandler</A></B>(java.io.PrintWriter&nbsp;pw)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructor ListingErrorHandler; user-supplied PrintWriter.</TD>
</TR>
</TABLE>
&nbsp;
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#error(org.xml.sax.SAXParseException)">error</A></B>(org.xml.sax.SAXParseException&nbsp;exception)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Receive notification of a recoverable error.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#error(javax.xml.transform.TransformerException)">error</A></B>(javax.xml.transform.TransformerException&nbsp;exception)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Receive notification of a recoverable error.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#fatalError(org.xml.sax.SAXParseException)">fatalError</A></B>(org.xml.sax.SAXParseException&nbsp;exception)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Receive notification of a non-recoverable error.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#fatalError(javax.xml.transform.TransformerException)">fatalError</A></B>(javax.xml.transform.TransformerException&nbsp;exception)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Receive notification of a non-recoverable error.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected static&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#getSourceLine(java.lang.String, int)">getSourceLine</A></B>(java.lang.String&nbsp;sourceUrl,
int&nbsp;lineNum)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the specific source line that caused the exception,
if possible to load it; allow exceptions to be thrown.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#getThrowOnError()">getThrowOnError</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;User-settable behavior: when to re-throw exceptions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#getThrowOnFatalError()">getThrowOnFatalError</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;User-settable behavior: when to re-throw exceptions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#getThrowOnWarning()">getThrowOnWarning</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;User-settable behavior: when to re-throw exceptions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#logExceptionLocation(java.io.PrintWriter, java.lang.Throwable)">logExceptionLocation</A></B>(java.io.PrintWriter&nbsp;pw,
java.lang.Throwable&nbsp;exception)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print out location information about the exception.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#logSourceLine(java.io.PrintWriter, javax.xml.transform.SourceLocator)">logSourceLine</A></B>(java.io.PrintWriter&nbsp;pw,
javax.xml.transform.SourceLocator&nbsp;locator)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print out the specific source line that caused the exception,
if possible to load it.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#setThrowOnError(boolean)">setThrowOnError</A></B>(boolean&nbsp;b)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;User-settable behavior: when to re-throw exceptions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#setThrowOnFatalError(boolean)">setThrowOnFatalError</A></B>(boolean&nbsp;b)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;User-settable behavior: when to re-throw exceptions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#setThrowOnWarning(boolean)">setThrowOnWarning</A></B>(boolean&nbsp;b)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;User-settable behavior: when to re-throw exceptions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#warning(org.xml.sax.SAXParseException)">warning</A></B>(org.xml.sax.SAXParseException&nbsp;exception)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Receive notification of a warning.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#warning(javax.xml.transform.TransformerException)">warning</A></B>(javax.xml.transform.TransformerException&nbsp;exception)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Receive notification of a warning.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>
<!-- ============ FIELD DETAIL =========== -->
<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Field Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="m_pw"><!-- --></A><H3>
m_pw</H3>
<PRE>
protected java.io.PrintWriter <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.56"><B>m_pw</B></A></PRE>
<DL>
<DL>
</DL>
</DL>
<HR>
<A NAME="throwOnWarning"><!-- --></A><H3>
throwOnWarning</H3>
<PRE>
protected boolean <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.499"><B>throwOnWarning</B></A></PRE>
<DL>
<DD>If we should throw exception on warnings; default:false.
<P>
<DL>
</DL>
</DL>
<HR>
<A NAME="throwOnError"><!-- --></A><H3>
throwOnError</H3>
<PRE>
protected boolean <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.531"><B>throwOnError</B></A></PRE>
<DL>
<DD>If we should throw exception on errors; default:true.
<P>
<DL>
</DL>
</DL>
<HR>
<A NAME="throwOnFatalError"><!-- --></A><H3>
throwOnFatalError</H3>
<PRE>
protected boolean <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.564"><B>throwOnFatalError</B></A></PRE>
<DL>
<DD>If we should throw exception on fatalErrors; default:true.
<P>
<DL>
</DL>
</DL>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="ListingErrorHandler(java.io.PrintWriter)"><!-- --></A><H3>
ListingErrorHandler</H3>
<PRE>
public <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.62"><B>ListingErrorHandler</B></A>(java.io.PrintWriter&nbsp;pw)</PRE>
<DL>
<DD>Constructor ListingErrorHandler; user-supplied PrintWriter.
<P>
</DL>
<HR>
<A NAME="ListingErrorHandler()"><!-- --></A><H3>
ListingErrorHandler</H3>
<PRE>
public <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.74"><B>ListingErrorHandler</B></A>()</PRE>
<DL>
<DD>Constructor ListingErrorHandler; uses System.err.
<P>
</DL>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="warning(org.xml.sax.SAXParseException)"><!-- --></A><H3>
warning</H3>
<PRE>
public void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.101"><B>warning</B></A>(org.xml.sax.SAXParseException&nbsp;exception)
throws org.xml.sax.SAXException</PRE>
<DL>
<DD>Receive notification of a warning.
<p>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.</p>
<p>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.</p>
<p>Filters may use this method to report other, non-XML warnings
as well.</p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>warning</CODE> in interface <CODE>org.xml.sax.ErrorHandler</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>exception</CODE> - The warning information encapsulated in a
SAX parse exception.
<DT><B>Throws:</B>
<DD><CODE>org.xml.sax.SAXException</CODE> - Any SAX exception, possibly
wrapping another exception; only if setThrowOnWarning is true.<DT><B>See Also:</B><DD><CODE>SAXParseException</CODE></DL>
</DD>
</DL>
<HR>
<A NAME="error(org.xml.sax.SAXParseException)"><!-- --></A><H3>
error</H3>
<PRE>
public void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.140"><B>error</B></A>(org.xml.sax.SAXParseException&nbsp;exception)
throws org.xml.sax.SAXException</PRE>
<DL>
<DD>Receive notification of a recoverable error.
<p>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.</p>
<p>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.</p>
<p>Filters may use this method to report other, non-XML errors
as well.</p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>error</CODE> in interface <CODE>org.xml.sax.ErrorHandler</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>exception</CODE> - The error information encapsulated in a
SAX parse exception.
<DT><B>Throws:</B>
<DD><CODE>org.xml.sax.SAXException</CODE> - Any SAX exception, possibly
wrapping another exception; only if setThrowOnErroris true.<DT><B>See Also:</B><DD><CODE>SAXParseException</CODE></DL>
</DD>
</DL>
<HR>
<A NAME="fatalError(org.xml.sax.SAXParseException)"><!-- --></A><H3>
fatalError</H3>
<PRE>
public void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.172"><B>fatalError</B></A>(org.xml.sax.SAXParseException&nbsp;exception)
throws org.xml.sax.SAXException</PRE>
<DL>
<DD>Receive notification of a non-recoverable error.
<p>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.</p>
<p>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.</p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>fatalError</CODE> in interface <CODE>org.xml.sax.ErrorHandler</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>exception</CODE> - The error information encapsulated in a
SAX parse exception.
<DT><B>Throws:</B>
<DD><CODE>org.xml.sax.SAXException</CODE> - Any SAX exception, possibly
wrapping another exception; only if setThrowOnFatalError is true.<DT><B>See Also:</B><DD><CODE>SAXParseException</CODE></DL>
</DD>
</DL>
<HR>
<A NAME="warning(javax.xml.transform.TransformerException)"><!-- --></A><H3>
warning</H3>
<PRE>
public void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.205"><B>warning</B></A>(javax.xml.transform.TransformerException&nbsp;exception)
throws javax.xml.transform.TransformerException</PRE>
<DL>
<DD>Receive notification of a warning.
<p><CODE>Transformer</CODE> can use this method to report
conditions that are not errors or fatal errors. The default behaviour
is to take no action.</p>
<p>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.</p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>warning</CODE> in interface <CODE>javax.xml.transform.ErrorListener</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>exception</CODE> - The warning information encapsulated in a
transformer exception.
<DT><B>Throws:</B>
<DD><CODE>javax.xml.transform.TransformerException</CODE> - only if
setThrowOnWarning is true.<DT><B>See Also:</B><DD><CODE>TransformerException</CODE></DL>
</DD>
</DL>
<HR>
<A NAME="error(javax.xml.transform.TransformerException)"><!-- --></A><H3>
error</H3>
<PRE>
public void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.232"><B>error</B></A>(javax.xml.transform.TransformerException&nbsp;exception)
throws javax.xml.transform.TransformerException</PRE>
<DL>
<DD>Receive notification of a recoverable error.
<p>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.</p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>error</CODE> in interface <CODE>javax.xml.transform.ErrorListener</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>exception</CODE> - The error information encapsulated in a
transformer exception.
<DT><B>Throws:</B>
<DD><CODE>javax.xml.transform.TransformerException</CODE> - only if
setThrowOnError is true.<DT><B>See Also:</B><DD><CODE>TransformerException</CODE></DL>
</DD>
</DL>
<HR>
<A NAME="fatalError(javax.xml.transform.TransformerException)"><!-- --></A><H3>
fatalError</H3>
<PRE>
public void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.260"><B>fatalError</B></A>(javax.xml.transform.TransformerException&nbsp;exception)
throws javax.xml.transform.TransformerException</PRE>
<DL>
<DD>Receive notification of a non-recoverable error.
<p>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.</p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>fatalError</CODE> in interface <CODE>javax.xml.transform.ErrorListener</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>exception</CODE> - The error information encapsulated in a
transformer exception.
<DT><B>Throws:</B>
<DD><CODE>javax.xml.transform.TransformerException</CODE> - only if
setThrowOnError is true.<DT><B>See Also:</B><DD><CODE>TransformerException</CODE></DL>
</DD>
</DL>
<HR>
<A NAME="logExceptionLocation(java.io.PrintWriter, java.lang.Throwable)"><!-- --></A><H3>
logExceptionLocation</H3>
<PRE>
public static void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.284"><B>logExceptionLocation</B></A>(java.io.PrintWriter&nbsp;pw,
java.lang.Throwable&nbsp;exception)</PRE>
<DL>
<DD>Print out location information about the exception.
Cribbed from DefaultErrorHandler.printLocation()
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pw</CODE> - PrintWriter to send output to<DD><CODE>exception</CODE> - TransformerException or SAXParseException
to log information about</DL>
</DD>
</DL>
<HR>
<A NAME="logSourceLine(java.io.PrintWriter, javax.xml.transform.SourceLocator)"><!-- --></A><H3>
logSourceLine</H3>
<PRE>
public static void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.361"><B>logSourceLine</B></A>(java.io.PrintWriter&nbsp;pw,
javax.xml.transform.SourceLocator&nbsp;locator)</PRE>
<DL>
<DD>Print out the specific source line that caused the exception,
if possible to load it.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pw</CODE> - PrintWriter to send output to<DD><CODE>locator</CODE> - Xalan wrapper for either a JAXP or a SAX
source location object</DL>
</DD>
</DL>
<HR>
<A NAME="getSourceLine(java.lang.String, int)"><!-- --></A><H3>
getSourceLine</H3>
<PRE>
protected static java.lang.String <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.409"><B>getSourceLine</B></A>(java.lang.String&nbsp;sourceUrl,
int&nbsp;lineNum)
throws java.lang.Exception</PRE>
<DL>
<DD>Return the specific source line that caused the exception,
if possible to load it; allow exceptions to be thrown.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Throws:</B>
<DD><CODE>java.lang.Exception</CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setThrowOnWarning(boolean)"><!-- --></A><H3>
setThrowOnWarning</H3>
<PRE>
public void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.483"><B>setThrowOnWarning</B></A>(boolean&nbsp;b)</PRE>
<DL>
<DD>User-settable behavior: when to re-throw exceptions.
<p>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.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>b</CODE> - if we should throw an exception on warnings</DL>
</DD>
</DL>
<HR>
<A NAME="getThrowOnWarning()"><!-- --></A><H3>
getThrowOnWarning</H3>
<PRE>
public boolean <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.493"><B>getThrowOnWarning</B></A>()</PRE>
<DL>
<DD>User-settable behavior: when to re-throw exceptions.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>if we throw an exception on warnings</DL>
</DD>
</DL>
<HR>
<A NAME="setThrowOnError(boolean)"><!-- --></A><H3>
setThrowOnError</H3>
<PRE>
public void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.515"><B>setThrowOnError</B></A>(boolean&nbsp;b)</PRE>
<DL>
<DD>User-settable behavior: when to re-throw exceptions.
<p>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.</p>
<p>Note that the behavior of many parsers/transformers
after an error is not necessarily defined!</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>b</CODE> - if we should throw an exception on errors</DL>
</DD>
</DL>
<HR>
<A NAME="getThrowOnError()"><!-- --></A><H3>
getThrowOnError</H3>
<PRE>
public boolean <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.525"><B>getThrowOnError</B></A>()</PRE>
<DL>
<DD>User-settable behavior: when to re-throw exceptions.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>if we throw an exception on errors</DL>
</DD>
</DL>
<HR>
<A NAME="setThrowOnFatalError(boolean)"><!-- --></A><H3>
setThrowOnFatalError</H3>
<PRE>
public void <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.548"><B>setThrowOnFatalError</B></A>(boolean&nbsp;b)</PRE>
<DL>
<DD>User-settable behavior: when to re-throw exceptions.
<p>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.</p>
<p>Note that the behavior of many parsers/transformers
after a fatalError is not necessarily defined, most
products will probably barf if you continue.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>b</CODE> - if we should throw an exception on fatalErrors</DL>
</DD>
</DL>
<HR>
<A NAME="getThrowOnFatalError()"><!-- --></A><H3>
getThrowOnFatalError</H3>
<PRE>
public boolean <A HREF="../../../../src-html/org/apache/xml/utils/ListingErrorHandler.html#line.558"><B>getThrowOnFatalError</B></A>()</PRE>
<DL>
<DD>User-settable behavior: when to re-throw exceptions.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>if we throw an exception on fatalErrors</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ListingErrorHandler.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../org/apache/xml/utils/IntVector.html" title="class in org.apache.xml.utils"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../../org/apache/xml/utils/LocaleUtility.html" title="class in org.apache.xml.utils"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?org/apache/xml/utils/ListingErrorHandler.html" target="_top"><B>FRAMES</B></A> &nbsp;
&nbsp;<A HREF="ListingErrorHandler.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
&nbsp;<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
</BODY>
</HTML>