org.springframework.transaction
Class TransactionTimedOutException

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjava.lang.RuntimeException
              extended byorg.springframework.core.NestedRuntimeException
                  extended byorg.springframework.transaction.TransactionException
                      extended byorg.springframework.transaction.TransactionTimedOutException
All Implemented Interfaces:
Serializable

public class TransactionTimedOutException
extends TransactionException

Exception to be thrown when a transaction has timed out.

Thrown by Spring's local transaction strategies if the deadline for a transaction has been reached when an operation is attempted, according to the timeout specified for the given transaction.

Beyond such checks before each transactional operation, Spring's local transaction strategies will also pass appropriate timeout values to resource operations (for example to JDBC Statements, letting the JDBC driver respect the timeout). Such operations will usually throw native resource exceptions (for example, JDBC SQLExceptions) if their operation timeout has been exceeded, to be converted to Spring's DataAccessException in the respective DAO (which might use Spring's JdbcTemplate, for example).

In a JTA environment, it is up to the JTA transaction coordinator to apply transaction timeouts. Usually, the corresponding JTA-aware connection pool will perform timeout checks and throw corresponding native resource exceptions (for example, JDBC SQLExceptions).

Since:
1.1.5
Author:
Juergen Hoeller
See Also:
ResourceHolderSupport.getTimeToLiveInMillis(), Statement.setQueryTimeout(int), SQLException, Serialized Form

Field Summary
 
Fields inherited from class java.lang.RuntimeException
 
Constructor Summary
TransactionTimedOutException(String msg)
          Constructor for TransactionTimedOutException.
TransactionTimedOutException(String msg, Throwable ex)
          Constructor for TransactionTimedOutException.
 
Methods inherited from class org.springframework.core.NestedRuntimeException
contains, getCause, getMessage, printStackTrace, printStackTrace
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getStackTrace, initCause, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

TransactionTimedOutException

public TransactionTimedOutException(String msg)
Constructor for TransactionTimedOutException.

Parameters:
msg - message

TransactionTimedOutException

public TransactionTimedOutException(String msg,
                                    Throwable ex)
Constructor for TransactionTimedOutException.

Parameters:
msg - message
ex - root cause from transaction API in use


Copyright (C) 2003-2004 The Spring Framework Project.