io.flamingock.internal.common.core.error

Class DatabaseTransactionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.flamingock.internal.common.core.error.FlamingockException

io.flamingock.internal.common.core.error.DatabaseTransactionException

All Implemented Interfaces:

java.io.Serializable

public class DatabaseTransactionException
extends FlamingockException

Exception thrown when database transaction operations fail.

This exception provides comprehensive context about transaction failures including:

• Transaction state and isolation level
• Timeout information and actual duration
• Rollback status and recovery actions taken
• Database connection and session details
• SQL statement or operation that caused the failure

This exception should be used for all transaction-related failures in target systems including commit failures, rollback failures, timeout errors, and connection issues.

Since:

6.0.0

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DatabaseTransactionException.RollbackStatus
static class	DatabaseTransactionException.TransactionState

Constructor Summary

Constructors

Constructor and Description
DatabaseTransactionException(java.lang.String message, DatabaseTransactionException.TransactionState transactionState, java.lang.String isolationLevel, java.time.Duration timeout, java.time.Duration actualDuration, DatabaseTransactionException.RollbackStatus rollbackStatus, java.lang.String databaseOperation, java.lang.String connectionInfo, java.lang.Throwable cause) Creates a new DatabaseTransactionException with complete transaction context.
DatabaseTransactionException(java.lang.String message, DatabaseTransactionException.TransactionState transactionState, java.lang.Throwable cause) Creates a DatabaseTransactionException with minimal context (for backward compatibility).

Method Summary

Modifier and Type	Method and Description
java.time.Duration	getActualDuration()
java.lang.String	getConnectionInfo()
java.lang.String	getDatabaseOperation()
java.lang.String	getIsolationLevel()
DatabaseTransactionException.RollbackStatus	getRollbackStatus()
java.time.Duration	getTimeout()
DatabaseTransactionException.TransactionState	getTransactionState()
static DatabaseTransactionException	rollbackFailed(java.lang.String message, java.lang.Throwable cause) Creates a DatabaseTransactionException for rollback failures.
static DatabaseTransactionException	timeout(java.lang.String message, java.time.Duration timeout, java.time.Duration actualDuration, java.lang.Throwable cause) Creates a DatabaseTransactionException for transaction timeouts.

Methods inherited from class io.flamingock.internal.common.core.error.FlamingockException

toFlamingockException

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

DatabaseTransactionException

public DatabaseTransactionException(java.lang.String message,
                                    DatabaseTransactionException.TransactionState transactionState,
                                    java.lang.String isolationLevel,
                                    java.time.Duration timeout,
                                    java.time.Duration actualDuration,
                                    DatabaseTransactionException.RollbackStatus rollbackStatus,
                                    java.lang.String databaseOperation,
                                    java.lang.String connectionInfo,
                                    java.lang.Throwable cause)

Creates a new DatabaseTransactionException with complete transaction context.

Parameters:

message - descriptive error message

transactionState - the state of the transaction when it failed

isolationLevel - the isolation level (e.g., "READ_COMMITTED", "SERIALIZABLE")

timeout - the configured transaction timeout

actualDuration - how long the transaction ran before failing

rollbackStatus - whether rollback was attempted and succeeded

databaseOperation - the SQL or operation that caused the failure

connectionInfo - connection pool or session information

cause - the underlying database exception

DatabaseTransactionException

public DatabaseTransactionException(java.lang.String message,
                                    DatabaseTransactionException.TransactionState transactionState,
                                    java.lang.Throwable cause)

Creates a DatabaseTransactionException with minimal context (for backward compatibility).

Parameters:

message - descriptive error message

transactionState - the state when the transaction failed

cause - the underlying exception

Method Detail

rollbackFailed

public static DatabaseTransactionException rollbackFailed(java.lang.String message,
                                                          java.lang.Throwable cause)

Creates a DatabaseTransactionException for rollback failures.

Parameters:

message - descriptive error message

cause - the underlying exception

timeout

public static DatabaseTransactionException timeout(java.lang.String message,
                                                   java.time.Duration timeout,
                                                   java.time.Duration actualDuration,
                                                   java.lang.Throwable cause)

Creates a DatabaseTransactionException for transaction timeouts.

Parameters:

message - descriptive error message

timeout - the configured timeout

actualDuration - how long it actually ran

cause - the underlying exception

getTransactionState

public DatabaseTransactionException.TransactionState getTransactionState()

getIsolationLevel

public java.lang.String getIsolationLevel()

getTimeout

public java.time.Duration getTimeout()

getActualDuration

public java.time.Duration getActualDuration()

getRollbackStatus

public DatabaseTransactionException.RollbackStatus getRollbackStatus()

getDatabaseOperation

public java.lang.String getDatabaseOperation()

getConnectionInfo

public java.lang.String getConnectionInfo()