001: /*
002: * The original version of this class was published in an article by professor Heinz Kabutz.
003: * Read http://www.javaspecialists.co.za/archive/newsletter.do?issue=033&print=yes&locale=en_US
004: * "This material from The Java(tm) Specialists' Newsletter by Maximum Solutions (South Africa).
005: * Please contact Maximum Solutions for more information."
006: */
007:
008: /*
009: * The contents of this file are subject to the Mozilla Public License Version 1.1
010: * (the "License"); you may not use this file except in compliance with the License.
011: * You may obtain a copy of the License at http://www.mozilla.org/MPL/
012: *
013: * Software distributed under the License is distributed on an "AS IS" basis,
014: * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
015: * for the specific language governing rights and limitations under the License.
016: *
017: * The Original Code is 'iText, a free JAVA-PDF library'.
018: *
019: * The Initial Developer of the Original Code is Bruno Lowagie. Portions created by
020: * the Initial Developer are Copyright (C) 1999, 2000, 2001, 2002 by Bruno Lowagie.
021: * All Rights Reserved.
022: * Co-Developer of the code is Paulo Soares. Portions created by the Co-Developer
023: * are Copyright (C) 2000, 2001, 2002 by Paulo Soares. All Rights Reserved.
024: *
025: * Contributor(s): all the names of the contributors are added in the source code
026: * where applicable.
027: *
028: * Alternatively, the contents of this file may be used under the terms of the
029: * LGPL license (the "GNU LIBRARY GENERAL PUBLIC LICENSE"), in which case the
030: * provisions of LGPL are applicable instead of those above. If you wish to
031: * allow use of your version of this file only under the terms of the LGPL
032: * License and not to allow others to use your version of this file under
033: * the MPL, indicate your decision by deleting the provisions above and
034: * replace them with the notice and other provisions required by the LGPL.
035: * If you do not delete the provisions above, a recipient may use your version
036: * of this file under either the MPL or the GNU LIBRARY GENERAL PUBLIC LICENSE.
037: *
038: * This library is free software; you can redistribute it and/or modify it
039: * under the terms of the MPL as stated above or under the terms of the GNU
040: * Library General Public License as published by the Free Software Foundation;
041: * either version 2 of the License, or any later version.
042: *
043: * This library is distributed in the hope that it will be useful, but WITHOUT
044: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
045: * FOR A PARTICULAR PURPOSE. See the GNU Library general Public License for more
046: * details.
047: *
048: * If you didn't download this code from the following link, you should check if
049: * you aren't using an obsolete version:
050: * http://www.lowagie.com/iText/
051: */
052: package com.lowagie.text;
053:
054: /**
055: * The ExceptionConverter changes a checked exception into an
056: * unchecked exception.
057: */
058: public class ExceptionConverter extends RuntimeException {
059: private static final long serialVersionUID = 8657630363395849399L;
060: /** we keep a handle to the wrapped exception */
061: private Exception ex;
062: /** prefix for the exception */
063: private String prefix;
064:
065: /**
066: * Construct a RuntimeException based on another Exception
067: * @param ex the exception that has to be turned into a RuntimeException
068: */
069: public ExceptionConverter(Exception ex) {
070: this .ex = ex;
071: prefix = (ex instanceof RuntimeException) ? ""
072: : "ExceptionConverter: ";
073: }
074:
075: /**
076: * and allow the user of ExceptionConverter to get a handle to it.
077: * @return the original exception
078: */
079: public Exception getException() {
080: return ex;
081: }
082:
083: /**
084: * We print the message of the checked exception
085: * @return message of the original exception
086: */
087: public String getMessage() {
088: return ex.getMessage();
089: }
090:
091: /**
092: * and make sure we also produce a localized version
093: * @return localized version of the message
094: */
095: public String getLocalizedMessage() {
096: return ex.getLocalizedMessage();
097: }
098:
099: /**
100: * The toString() is changed to be prefixed with ExceptionConverter
101: * @return Stringversion of the exception
102: */
103: public String toString() {
104: return prefix + ex;
105: }
106:
107: /** we have to override this as well */
108: public void printStackTrace() {
109: printStackTrace(System.err);
110: }
111:
112: /**
113: * here we prefix, with s.print(), not s.println(), the stack
114: * trace with "ExceptionConverter:"
115: * @param s
116: */
117: public void printStackTrace(java.io.PrintStream s) {
118: synchronized (s) {
119: s.print(prefix);
120: ex.printStackTrace(s);
121: }
122: }
123:
124: /**
125: * Again, we prefix the stack trace with "ExceptionConverter:"
126: * @param s
127: */
128: public void printStackTrace(java.io.PrintWriter s) {
129: synchronized (s) {
130: s.print(prefix);
131: ex.printStackTrace(s);
132: }
133: }
134:
135: /**
136: * requests to fill in the stack trace we will have to ignore.
137: * We can't throw an exception here, because this method
138: * is called by the constructor of Throwable
139: * @return a Throwable
140: */
141: public Throwable fillInStackTrace() {
142: return this;
143: }
144: }
|