org.apache.turbine.util
Class TurbineException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          org.apache.commons.lang.exception.NestableException
              org.apache.turbine.util.TurbineException

All Implemented Interfaces:

org.apache.commons.lang.exception.Nestable, java.io.Serializable

Direct Known Subclasses:

InitializationException, IntakeException, TurbineSecurityException, VelocityEmailException

public class TurbineException

extends org.apache.commons.lang.exception.NestableException

The base class of all exceptions thrown by Turbine. It is intended to ease the debugging by carrying on the information about the exception which was caught and provoked throwing the current exception. Catching and rethrowing may occur multiple times, and provided that all exceptions except the first one are descendands of TurbineException, when the exception is finally printed out using any of the printStackTrace() methods, the stacktrace will contain the information about all exceptions thrown and caught on the way.

Running the following program

  1 import org.apache.turbine.util.TurbineException;
  2
  3 public class Test {
  4     public static void main( String[] args ) {
  5         try {
  6             a();
  7         } catch(Exception e) {
  8             e.printStackTrace();
  9         }
 10      }
 11
 12      public static void a() throws TurbineException {
 13          try {
 14              b();
 15          } catch(Exception e) {
 16              throw new TurbineException("foo", e);
 17          }
 18      }
 19
 20      public static void b() throws TurbineException {
 21          try {
 22              c();
 23          } catch(Exception e) {
 24              throw new TurbineException("bar", e);
 25          }
 26      }
 27
 28      public static void c() throws TurbineException {
 29          throw new Exception("baz");
 30      }
 31 }
 

Yields the following stacktrace:

 java.lang.Exception: baz: bar: foo
    at Test.c(Test.java:29)
    at Test.b(Test.java:22)
 rethrown as TurbineException: bar
    at Test.b(Test.java:24)
    at Test.a(Test.java:14)
 rethrown as TurbineException: foo
    at Test.a(Test.java:16)
    at Test.main(Test.java:6)
 

Version:

$Id: TurbineException.java 534527 2007-05-02 16:10:59Z tv $

Author:

Rafal Krzewski, Daniel Rall, Quinton McCombs

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.commons.lang.exception.NestableException

delegate

Constructor Summary

TurbineException()
Constructs a new TurbineException without specified detail message.

TurbineException(java.lang.String msg)
Constructs a new TurbineException with specified detail message.

TurbineException(java.lang.String msg, java.lang.Throwable nested)
Constructs a new TurbineException with specified detail message and nested Throwable.

TurbineException(java.lang.Throwable nested)
Constructs a new TurbineException with specified nested Throwable.

Methods inherited from class org.apache.commons.lang.exception.NestableException

getCause, getMessage, getMessage, getMessages, getThrowable, getThrowableCount, getThrowables, indexOfThrowable, indexOfThrowable, printPartialStackTrace, printStackTrace, printStackTrace, printStackTrace

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getStackTrace, initCause, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TurbineException

public TurbineException()

Constructs a new TurbineException without specified detail message.

TurbineException

public TurbineException(java.lang.String msg)

Constructs a new TurbineException with specified detail message.

Parameters:

msg - The error message.

TurbineException

public TurbineException(java.lang.Throwable nested)

Constructs a new TurbineException with specified nested Throwable.

Parameters:

nested - The exception or error that caused this exception to be thrown.

TurbineException

public TurbineException(java.lang.String msg,
                        java.lang.Throwable nested)

Constructs a new TurbineException with specified detail message and nested Throwable.

Parameters:

msg - The error message.

nested - The exception or error that caused this exception to be thrown.