Frames | No Frames |
1: /* ======================================================================== 2: * JCommon : a free general purpose class library for the Java(tm) platform 3: * ======================================================================== 4: * 5: * (C) Copyright 2000-2005, by Object Refinery Limited and Contributors. 6: * 7: * Project Info: http://www.jfree.org/jcommon/index.html 8: * 9: * This library is free software; you can redistribute it and/or modify it 10: * under the terms of the GNU Lesser General Public License as published by 11: * the Free Software Foundation; either version 2.1 of the License, or 12: * (at your option) any later version. 13: * 14: * This library is distributed in the hope that it will be useful, but 15: * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 16: * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public 17: * License for more details. 18: * 19: * You should have received a copy of the GNU Lesser General Public 20: * License along with this library; if not, write to the Free Software 21: * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 22: * USA. 23: * 24: * [Java is a trademark or registered trademark of Sun Microsystems, Inc. 25: * in the United States and other countries.] 26: * 27: * ------------------------------ 28: * ElementDefinitionException.java 29: * ------------------------------ 30: * (C)opyright 2002-2004, by Object Refinery Limited. 31: * 32: * $Id: ElementDefinitionException.java,v 1.3 2005/10/18 13:25:44 mungady Exp $ 33: * 34: * Changes 35: * ------- 36: * 24-Apr-2002 : Initial version 37: * 31-Aug-2002 : Documentation; changed PrintStackTrace for better tracing 38: * 29-Apr-2003 : Distilled from the JFreeReport project and moved into JCommon 39: */ 40: package org.jfree.xml; 41: 42: import java.io.PrintStream; 43: import java.io.PrintWriter; 44: 45: import org.xml.sax.Locator; 46: 47: /** 48: * A reportdefinition exception is thrown when the parsing of the report definition 49: * failed because invalid or missing attributes are encountered. 50: * 51: * @author Thomas Morgner 52: */ 53: public class ElementDefinitionException extends ParseException { 54: 55: /** The parent exception. */ 56: private Exception parent; 57: 58: /** 59: * Creates a new ElementDefinitionException without an parent exception and with the given 60: * message as explanation. 61: * 62: * @param message a detail message explaining the reasons for this exception. 63: */ 64: public ElementDefinitionException(final String message) { 65: super(message); 66: } 67: 68: /** 69: * Creates a new ElementDefinitionException with an parent exception and with the parents 70: * message as explaination. 71: * 72: * @param e the parentException that caused this exception 73: */ 74: public ElementDefinitionException(final Exception e) { 75: this(e, e.getMessage()); 76: } 77: 78: /** 79: * Creates a new ElementDefinitionException with an parent exception and with the given 80: * message as explaination. 81: * 82: * @param e the parentException that caused this exception 83: * @param message a detail message explaining the reasons for this exception 84: */ 85: public ElementDefinitionException(final Exception e, final String message) { 86: this(message); 87: this.parent = e; 88: } 89: 90: /** 91: * Creates a new ParseException with the given root exception 92: * and the locator. 93: * 94: * @param e the exception 95: * @param locator the locator of the parser 96: */ 97: public ElementDefinitionException(final Exception e, final Locator locator) { 98: super(e, locator); 99: this.parent = e; 100: } 101: 102: /** 103: * Creates a new ParseException with the given message and the locator. 104: * 105: * @param message the message 106: * @param locator the locator of the parser 107: */ 108: public ElementDefinitionException(final String message, final Locator locator) { 109: super(message, locator); 110: } 111: 112: /** 113: * Creates a new ParseException with the given message, root exception 114: * and the locator. 115: * 116: * @param s the message 117: * @param e the exception 118: * @param locator the locator of the parser 119: */ 120: public ElementDefinitionException(final String s, final Exception e, final Locator locator) { 121: super(s, e, locator); 122: this.parent = e; 123: } 124: 125: /** 126: * Returns the parent exception. 127: * 128: * @return the parent exception. 129: */ 130: public Exception getParentException() { 131: return this.parent; 132: } 133: 134: /** 135: * Prints the stack trace. If an inner exception exists, use 136: * its stack trace. 137: * 138: * @param s the stream for writing to. 139: */ 140: public void printStackTrace(final PrintStream s) { 141: super.printStackTrace(s); 142: if (this.parent != null) { 143: s.print("ParentException:"); 144: this.parent.printStackTrace(s); 145: } 146: else { 147: s.println("ParentException: <null>"); 148: } 149: } 150: 151: /** 152: * Prints the stack trace. If an inner exception exists, use 153: * its stack trace. 154: * 155: * @param s the stream for writing to. 156: */ 157: public void printStackTrace(final PrintWriter s) { 158: super.printStackTrace(s); 159: if (this.parent != null) { 160: s.print("ParentException:"); 161: this.parent.printStackTrace(s); 162: } 163: else { 164: s.println("ParentException: <null>"); 165: } 166: } 167: 168: }