org.apache.torque
Class TorqueRuntimeException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              org.apache.torque.TorqueRuntimeException

All Implemented Interfaces:

java.io.Serializable

public class TorqueRuntimeException
extends java.lang.RuntimeException

This is a base class of runtime exeptions thrown by Torque.

This class represents a non-checked type exception (see RuntimeException). 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 TorqueRuntimeException, 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.

Version:

$Id: TorqueRuntimeException.java 584524 2007-10-14 10:25:43Z tfischer $

Author:

Rafal Krzewski

See Also:

Serialized Form

Constructor Summary

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

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

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

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

Method Summary

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.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

TorqueRuntimeException

public TorqueRuntimeException()

Constructs a new TorqueRuntimeException without specified detail message.

TorqueRuntimeException

public TorqueRuntimeException(java.lang.String msg)

Constructs a new TorqueRuntimeException with specified detail message.

Parameters:

msg - the error message.

TorqueRuntimeException

public TorqueRuntimeException(java.lang.Throwable nested)

Constructs a new TorqueRuntimeException with specified nested Throwable.

Parameters:

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

TorqueRuntimeException

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

Constructs a new TorqueRuntimeException 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.