com.xenonsoft.bridgetown.aop.transaction
Class TransactionException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              com.xenonsoft.bridgetown.aop.transaction.TransactionException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

HeuristicFailureException, NestedTransactionNotSupportedException, TransactionInvalidControlException, TransactionNotSupportedException, TransactionRolledbackException, TransactionSystemException

public class TransactionException

extends java.lang.RuntimeException

The base exception for an AOP transaction failure that occurs during the Bridgetown IoC Framework. The is a unchecked exception because sometimes developers do not want to write boilerplate code to catch SQLExceptions, or more specific JTA exceptions for the those transaction across data sources that are XA aware.

The best practice is to wrap the JTA Exception inside a TransactionException and rethrow. Normally one will not log the exception because such errors will be pick up in the application server general log. The worse thing you can do is to catch exception, log them to verbose, across all the tiers in a multi-layer architecture.

Version:

$Id: TransactionException.java,v 1.1 2004/10/27 02:13:16 peter_pilgrim Exp $

Author:

Peter Pilgrim, 20-Oct-2004

See Also:

Serialized Form

Constructor Summary

TransactionException()
Default constructor

TransactionException(java.lang.String message)
Standard constructor

TransactionException(java.lang.String message, java.lang.Throwable cause)
Standard constructor

TransactionException(java.lang.Throwable cause)
Standard constructor

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, 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

TransactionException

public TransactionException()

Default constructor

TransactionException

public TransactionException(java.lang.String message)

Standard constructor

Parameters:

message - the message to report

TransactionException

public TransactionException(java.lang.Throwable cause)

Standard constructor

Parameters:

cause - the root cause

TransactionException

public TransactionException(java.lang.String message,
                            java.lang.Throwable cause)

Standard constructor

Parameters:

message - the message to report

cause - the root cause