<!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> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> | |
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ListingErrorHandler.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> | |
</TR> | |
</TABLE> | |
</TD> | |
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> | |
</EM> | |
</TD> | |
</TR> | |
<TR> | |
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> | |
<A HREF="../../../../org/apache/xml/utils/IntVector.html" title="class in org.apache.xml.utils"><B>PREV CLASS</B></A> | |
<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> | |
<A HREF="ListingErrorHandler.html" target="_top"><B>NO FRAMES</B></A> | |
<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: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> | |
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> | |
DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <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 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> | |
</TD> | |
</TR> | |
<TR BGCOLOR="white" CLASS="TableRowColor"> | |
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> | |
<CODE>protected boolean</CODE></FONT></TD> | |
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#throwOnError">throwOnError</A></B></CODE> | |
<BR> | |
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 boolean</CODE></FONT></TD> | |
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#throwOnFatalError">throwOnFatalError</A></B></CODE> | |
<BR> | |
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 boolean</CODE></FONT></TD> | |
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#throwOnWarning">throwOnWarning</A></B></CODE> | |
<BR> | |
If we should throw exception on warnings; default:false.</TD> | |
</TR> | |
</TABLE> | |
| |
<!-- ======== 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> | |
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 pw)</CODE> | |
<BR> | |
Constructor ListingErrorHandler; user-supplied PrintWriter.</TD> | |
</TR> | |
</TABLE> | |
| |
<!-- ========== 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> 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 exception)</CODE> | |
<BR> | |
Receive notification of a recoverable error.</TD> | |
</TR> | |
<TR BGCOLOR="white" CLASS="TableRowColor"> | |
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> | |
<CODE> 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 exception)</CODE> | |
<BR> | |
Receive notification of a recoverable error.</TD> | |
</TR> | |
<TR BGCOLOR="white" CLASS="TableRowColor"> | |
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> | |
<CODE> 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 exception)</CODE> | |
<BR> | |
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> 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 exception)</CODE> | |
<BR> | |
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 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 sourceUrl, | |
int lineNum)</CODE> | |
<BR> | |
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> boolean</CODE></FONT></TD> | |
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#getThrowOnError()">getThrowOnError</A></B>()</CODE> | |
<BR> | |
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> boolean</CODE></FONT></TD> | |
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#getThrowOnFatalError()">getThrowOnFatalError</A></B>()</CODE> | |
<BR> | |
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> boolean</CODE></FONT></TD> | |
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#getThrowOnWarning()">getThrowOnWarning</A></B>()</CODE> | |
<BR> | |
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 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 pw, | |
java.lang.Throwable exception)</CODE> | |
<BR> | |
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 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 pw, | |
javax.xml.transform.SourceLocator locator)</CODE> | |
<BR> | |
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> void</CODE></FONT></TD> | |
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#setThrowOnError(boolean)">setThrowOnError</A></B>(boolean b)</CODE> | |
<BR> | |
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> void</CODE></FONT></TD> | |
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#setThrowOnFatalError(boolean)">setThrowOnFatalError</A></B>(boolean b)</CODE> | |
<BR> | |
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> void</CODE></FONT></TD> | |
<TD><CODE><B><A HREF="../../../../org/apache/xml/utils/ListingErrorHandler.html#setThrowOnWarning(boolean)">setThrowOnWarning</A></B>(boolean b)</CODE> | |
<BR> | |
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> 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 exception)</CODE> | |
<BR> | |
Receive notification of a warning.</TD> | |
</TR> | |
<TR BGCOLOR="white" CLASS="TableRowColor"> | |
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> | |
<CODE> 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 exception)</CODE> | |
<BR> | |
Receive notification of a warning.</TD> | |
</TR> | |
</TABLE> | |
<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> | |
| |
<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 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 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 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 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 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 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 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 pw, | |
java.lang.Throwable 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 pw, | |
javax.xml.transform.SourceLocator 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 sourceUrl, | |
int 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 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 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 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> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> | |
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ListingErrorHandler.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> | |
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> | |
</TR> | |
</TABLE> | |
</TD> | |
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> | |
</EM> | |
</TD> | |
</TR> | |
<TR> | |
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> | |
<A HREF="../../../../org/apache/xml/utils/IntVector.html" title="class in org.apache.xml.utils"><B>PREV CLASS</B></A> | |
<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> | |
<A HREF="ListingErrorHandler.html" target="_top"><B>NO FRAMES</B></A> | |
<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: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> | |
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> | |
DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> | |
</TR> | |
</TABLE> | |
<A NAME="skip-navbar_bottom"></A> | |
<!-- ======== END OF BOTTOM NAVBAR ======= --> | |
<HR> | |
</BODY> | |
</HTML> |