org.apache.turbine.util

## Class TurbineException

- java.lang.Object
- - java.lang.Throwable
  - - java.lang.Exception
    - - org.apache.turbine.util.TurbineException

- All Implemented Interfaces:
    Serializable
  Direct Known Subclasses:
    InitializationException, VelocityEmailException

      public class TurbineException
      extends Exception

  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)

  Author:
    Rafal Krzewski, Daniel Rall, Quinton McCombs
  See Also:
    Serialized Form

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `TurbineException()` Constructs a new `TurbineException` without specified detail message.
    `TurbineException(String msg)` Constructs a new `TurbineException` with specified detail message.
    `TurbineException(String msg, Throwable nested)` Constructs a new `TurbineException` with specified detail message and nested `Throwable`.
    `TurbineException(Throwable nested)` Constructs a new `TurbineException` with specified nested `Throwable`.

  - ### Method Summary

    - ### Methods inherited from class java.lang.Throwable

      `addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, 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(String msg)

      Constructs a new `TurbineException` with specified detail message.
      Parameters:
        `msg` - The error message.

    - #### TurbineException

          public TurbineException(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(String msg,
                          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.

Copyright © 2000-2015 The Apache Software Foundation. All Rights Reserved.