org.apache.turbine.util
Class TurbineRuntimeException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--org.apache.turbine.util.TurbineRuntimeException
All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
InstantiationException

public class TurbineRuntimeException
extends java.lang.RuntimeException

This is a base class of runtime exeptions thrown by Turbine. This class represents a non-checked type exception (see {@see java.lang.RuntimeException}). It has the nested stack trace functionality found in the {@see TurbineException} class. It's sad that this class is a straight copy/paste of Turbine exception. I wish that Java supported NonCheckedException marker interface...

Author:
Rafal Krzewski
See Also:
Serialized Form

Field Summary
private  java.lang.Throwable nested
          Holds the reference to the exception or error that caused this exception to be thrown.
 
Fields inherited from class java.lang.Throwable
backtrace, detailMessage, serialVersionUID
 
Constructor Summary
TurbineRuntimeException()
          Constructs a new TurbineRuntimeException without specified detail message.
TurbineRuntimeException(java.lang.String msg)
          Constructs a new TurbineRuntimeException with specified detail message.
TurbineRuntimeException(java.lang.String msg, java.lang.Throwable nested)
          Constructs a new TurbineRuntimeException with specified detail message and nested Throwable.
TurbineRuntimeException(java.lang.Throwable nested)
          Constructs a new TurbineRuntimeException with specified nested Throwable.
 
Method Summary
private  java.lang.String[] captureStackTrace()
          Captures the stack trace associated with this exception.
private  java.lang.String[] captureStackTrace(java.lang.Throwable t)
          Captures the stack trace associated with a Throwable object.
 void printStackTrace()
          Prints the stack trace of this exception the the standar error stream.
 void printStackTrace(java.io.PrintStream out)
          Prints the stack trace of this exception to the specified print stream.
 void printStackTrace(java.io.PrintWriter out)
          Prints the stack trace of this exception to the specified print writer.
 void printStackTrace(java.io.PrintWriter out, int skip)
          Prints the stack trace of this exception skiping a specified number of stack frames.
private  java.lang.String[] splitStackTrace(java.lang.String stackTrace)
          Splits the stack trace given as a newline separated string into an array of stack frames.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace0, toString
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, wait, wait, wait
 

Field Detail

nested

private java.lang.Throwable nested
Holds the reference to the exception or error that caused this exception to be thrown.
Constructor Detail

TurbineRuntimeException

public TurbineRuntimeException()
Constructs a new TurbineRuntimeException without specified detail message.

TurbineRuntimeException

public TurbineRuntimeException(java.lang.String msg)
Constructs a new TurbineRuntimeException with specified detail message.
Parameters:
msg - the error message.

TurbineRuntimeException

public TurbineRuntimeException(java.lang.Throwable nested)
Constructs a new TurbineRuntimeException with specified nested Throwable.
Parameters:
nested - the exception or error that caused this exception to be thrown.

TurbineRuntimeException

public TurbineRuntimeException(java.lang.String msg,
                               java.lang.Throwable nested)
Constructs a new TurbineRuntimeException with specified detail message and nested Throwable.
Parameters:
msg - the error message.
nested - the exception or error that caused this exception to be thrown.
Method Detail

printStackTrace

public void printStackTrace()
Prints the stack trace of this exception the the standar error stream.
Overrides:
printStackTrace in class java.lang.Throwable

printStackTrace

public void printStackTrace(java.io.PrintStream out)
Prints the stack trace of this exception to the specified print stream.
Overrides:
printStackTrace in class java.lang.Throwable
Parameters:
out - PrintStream to use for output

printStackTrace

public void printStackTrace(java.io.PrintWriter out)
Prints the stack trace of this exception to the specified print writer.
Overrides:
printStackTrace in class java.lang.Throwable
Parameters:
out - PrintWriter to use for output.

printStackTrace

public void printStackTrace(java.io.PrintWriter out,
                            int skip)
Prints the stack trace of this exception skiping a specified number of stack frames.
Parameters:
out - PrintWriter to use for output.
skip - the numbere of stack frames to skip.

captureStackTrace

private java.lang.String[] captureStackTrace()
Captures the stack trace associated with this exception.
Returns:
an array of Strings describing stack frames.

captureStackTrace

private java.lang.String[] captureStackTrace(java.lang.Throwable t)
Captures the stack trace associated with a Throwable object.
Parameters:
t - the Throwable.
Returns:
an array of Strings describing stack frames.

splitStackTrace

private java.lang.String[] splitStackTrace(java.lang.String stackTrace)
Splits the stack trace given as a newline separated string into an array of stack frames.
Parameters:
stackTrace - the stack trace.
Returns:
an array of Strings describing stack frames.


Copyright © 2000-2002 Apache Software Foundation. All Rights Reserved.