diff options
Diffstat (limited to 'external/jaxp/source/javax/xml/transform/TransformerException.java')
| -rw-r--r-- | external/jaxp/source/javax/xml/transform/TransformerException.java | 183 |
1 files changed, 183 insertions, 0 deletions
diff --git a/external/jaxp/source/javax/xml/transform/TransformerException.java b/external/jaxp/source/javax/xml/transform/TransformerException.java new file mode 100644 index 000000000..b0ab61582 --- /dev/null +++ b/external/jaxp/source/javax/xml/transform/TransformerException.java @@ -0,0 +1,183 @@ +/* + * $Id: TransformerException.java,v 1.1 2003-02-01 02:10:28 cbj Exp $ + * Copyright (C) 2001 Andrew Selkirk + * Copyright (C) 2001 David Brownell + * + * This file is part of GNU JAXP, a library. + * + * GNU JAXP is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * GNU JAXP is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * + * As a special exception, if you link this library with other files to + * produce an executable, this library does not by itself cause the + * resulting executable to be covered by the GNU General Public License. + * This exception does not however invalidate any other reasons why the + * executable file might be covered by the GNU General Public License. + */ +package javax.xml.transform; + +// Imports +import java.io.*; + +/** + * Encapsulates a problem exposed during a transformation. + * @author Andrew Selkirk, David Brownell + * @version 1.0 + */ +public class TransformerException extends Exception { + + //------------------------------------------------------------- + // Variables -------------------------------------------------- + //------------------------------------------------------------- + + private SourceLocator locator = null; + private Throwable containedException = null; + private boolean causeKnown; + + + //------------------------------------------------------------- + // Initialization --------------------------------------------- + //------------------------------------------------------------- + + public TransformerException(String msg) { + super(msg); + } + + public TransformerException(Throwable cause) { + super(); + initCause (cause); + } + + public TransformerException(String msg, Throwable cause) { + super(msg); + initCause (cause); + } + + public TransformerException(String msg, SourceLocator locator) { + super(msg); + setLocator (locator); + } + + public TransformerException(String msg, SourceLocator locator, + Throwable cause) { + super(msg); + setLocator (locator); + initCause (cause); + } + + + //------------------------------------------------------------- + // Methods ---------------------------------------------------- + //------------------------------------------------------------- + + /** + * Returns the root cause of this exception, + * or null if none is known. + */ + public Throwable getCause() { + return containedException; + } + + /** + * Synonym for {@link #getCause}. + */ + public Throwable getException() { + return containedException; + } + + /** + * Returns a readable version of the locator info, or null + * if there is no locator. + */ + public String getLocationAsString() { + if (locator == null) + return null; + + StringBuffer retval = new StringBuffer (); + + if (locator.getPublicId () != null) { + retval.append ("public='"); + retval.append (locator.getPublicId ()); + retval.append ("' "); + } + if (locator.getSystemId () != null) { + retval.append ("uri='"); + retval.append (locator.getSystemId ()); + retval.append ("' "); + } + if (locator.getLineNumber () != -1) { + retval.append ("line="); + retval.append (locator.getLineNumber ()); + retval.append (" "); + } + if (locator.getColumnNumber () != -1) { + retval.append ("column="); + retval.append (locator.getColumnNumber ()); + //retval.append (" "); + } + return retval.toString (); + } + + public SourceLocator getLocator() { + return locator; + } + + /** + * Returns this exception's message, with readable location + * information appended if it is available. + */ + public String getMessageAndLocation() { + if (locator == null) + return getMessage (); + return getMessage () + ": " + getLocationAsString (); + } + + /** + * Records the root cause of this exception; may be + * called only once, normally during initialization. + */ + public synchronized Throwable initCause(Throwable cause) { + if (cause == this) + throw new IllegalArgumentException (); + if (containedException != null) + throw new IllegalStateException (); + containedException = cause; + causeKnown = true; +// FIXME: spec implies "this" may be the right value; another bug? + return cause; + } + + + public void printStackTrace() { + printStackTrace(System.out); + } + + public void printStackTrace(PrintStream stream) { + PrintWriter out = new PrintWriter( + new OutputStreamWriter(stream)); + printStackTrace(out); + out.flush (); + } + + public void printStackTrace(PrintWriter writer) { + if (containedException != null) { + containedException.printStackTrace(writer); + } + super.printStackTrace(writer); + } + + public void setLocator (SourceLocator location) { + locator = location; + } +} |