SQLTransactionRollbackException (Java SE 14 & JDK 14)
Description: declaration: module: java.sql, package: java.sql, class: SQLTransactionRollbackException
Keywords: java.sql.SQLTransactionRollbackException class

Module java.sql
Package java.sql

# Class SQLTransactionRollbackException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.sql.SQLException
java.sql.SQLTransientException
java.sql.SQLTransactionRollbackException

All Implemented Interfaces:
  `Serializable`, `Iterable<Throwable>`

    public class SQLTransactionRollbackException
    extends SQLTransientException

The subclass of `SQLException` thrown when the SQLState class value is '40', or under vendor-specified conditions. This indicates that the current statement was automatically rolled back by the database because of deadlock or other transaction serialization failures.

Please consult your driver vendor documentation for the vendor-specified conditions for which this `Exception` may be thrown.

Since:
  1.6
See Also:
  Serialized Form

- ## Constructor Summary

  Constructors
  Constructor | Description
  --- | ---
  `SQLTransactionRollbackException()` | Constructs a `SQLTransactionRollbackException` object.
  `SQLTransactionRollbackException​(String reason)` | Constructs a `SQLTransactionRollbackException` object with a given `reason`.
  `SQLTransactionRollbackException​(String reason, String SQLState)` | Constructs a `SQLTransactionRollbackException` object with a given `reason` and `SQLState`.
  `SQLTransactionRollbackException​(String reason, String SQLState, int vendorCode)` | Constructs a `SQLTransactionRollbackException` object with a given `reason`, `SQLState` and `vendorCode`.
  `SQLTransactionRollbackException​(String reason, String SQLState, int vendorCode, Throwable cause)` | Constructs a `SQLTransactionRollbackException` object with a given `reason`, `SQLState`, `vendorCode` and `cause`.
  `SQLTransactionRollbackException​(String reason, String SQLState, Throwable cause)` | Constructs a `SQLTransactionRollbackException` object with a given `reason`, `SQLState` and `cause`.
  `SQLTransactionRollbackException​(String reason, Throwable cause)` | Constructs a `SQLTransactionRollbackException` object with a given `reason` and `cause`.
  `SQLTransactionRollbackException​(Throwable cause)` | Constructs a `SQLTransactionRollbackException` object with a given `cause`.

- ## Method Summary

  ### Methods declared in class java.sql.SQLException

  `getErrorCode, getNextException, getSQLState, iterator, setNextException`

  ### Methods declared in class java.lang.Throwable

  `addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString`

  ### Methods declared in class java.lang.Object

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

  ### Methods declared in interface java.lang.Iterable

  `forEach, spliterator`

- ## Constructor Details

  - ### SQLTransactionRollbackException

    public SQLTransactionRollbackException()
    Constructs a `SQLTransactionRollbackException` object. The `reason`, `SQLState` are initialized to `null` and the vendor code is initialized to 0. The `cause` is not initialized, and may subsequently be initialized by a call to the `Throwable.initCause(java.lang.Throwable)` method.
    Since:
      1.6

  - ### SQLTransactionRollbackException

    public SQLTransactionRollbackException​(String reason)
    Constructs a `SQLTransactionRollbackException` object with a given `reason`. The `SQLState` is initialized to `null` and the vendor code is initialized to 0. The `cause` is not initialized, and may subsequently be initialized by a call to the `Throwable.initCause(java.lang.Throwable)` method.
    Parameters:
      `reason` - a description of the exception
    Since:
      1.6

  - ### SQLTransactionRollbackException

    public SQLTransactionRollbackException​(String reason, String SQLState)
    Constructs a `SQLTransactionRollbackException` object with a given `reason` and `SQLState`. The `cause` is not initialized, and may subsequently be initialized by a call to the `Throwable.initCause(java.lang.Throwable)` method. The vendor code is initialized to 0.
    Parameters:
      `reason` - a description of the exception
      `SQLState` - an XOPEN or SQL:2003 code identifying the exception
    Since:
      1.6

  - ### SQLTransactionRollbackException

    public SQLTransactionRollbackException​(String reason, String SQLState, int vendorCode)
    Constructs a `SQLTransactionRollbackException` object with a given `reason`, `SQLState` and `vendorCode`. The `cause` is not initialized, and may subsequently be initialized by a call to the `Throwable.initCause(java.lang.Throwable)` method.
    Parameters:
      `reason` - a description of the exception
      `SQLState` - an XOPEN or SQL:2003 code identifying the exception
      `vendorCode` - a database vendor specific exception code
    Since:
      1.6

  - ### SQLTransactionRollbackException

    public SQLTransactionRollbackException​(Throwable cause)
    Constructs a `SQLTransactionRollbackException` object with a given `cause`. The `SQLState` is initialized to `null` and the vendor code is initialized to 0. The `reason` is initialized to `null` if `cause==null` or to `cause.toString()` if `cause!=null`.
    Parameters:
      `cause` - the underlying reason for this `SQLException` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown.
    Since:
      1.6

  - ### SQLTransactionRollbackException

    public SQLTransactionRollbackException​(String reason, Throwable cause)
    Constructs a `SQLTransactionRollbackException` object with a given `reason` and `cause`. The `SQLState` is initialized to `null` and the vendor code is initialized to 0.
    Parameters:
      `reason` - a description of the exception.
      `cause` - the underlying reason for this `SQLException` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown.
    Since:
      1.6

  - ### SQLTransactionRollbackException

    public SQLTransactionRollbackException​(String reason, String SQLState, Throwable cause)
    Constructs a `SQLTransactionRollbackException` object with a given `reason`, `SQLState` and `cause`. The vendor code is initialized to 0.
    Parameters:
      `reason` - a description of the exception.
      `SQLState` - an XOPEN or SQL:2003 code identifying the exception
      `cause` - the underlying reason for this `SQLException` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown.
    Since:
      1.6

  - ### SQLTransactionRollbackException

    public SQLTransactionRollbackException​(String reason, String SQLState, int vendorCode, Throwable cause)
    Constructs a `SQLTransactionRollbackException` object with a given `reason`, `SQLState`, `vendorCode` and `cause`.
    Parameters:
      `reason` - a description of the exception
      `SQLState` - an XOPEN or SQL:2003 code identifying the exception
      `vendorCode` - a database vendor-specific exception code
      `cause` - the underlying reason for this `SQLException` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown.
    Since:
      1.6