Module org.jooq

Package org.jooq.exception

Class DataAccessException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.jooq.exception.DataAccessException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

ConfigurationException, DataChangedException, DataDefinitionException, DataException, DataMigrationException, DataTypeException, DetachedException, IntegrityConstraintViolationException, InvalidResultException, IOException, LoaderConfigurationException, MappingException, MockFileDatabaseException, ParserException, TemplatingException

public class DataAccessException
extends RuntimeException

The DataAccessException is a generic RuntimeException indicating that something went wrong while executing a SQL statement from jOOQ.

Unlike JDBC, jOOQ throws RuntimeException, knowing that

• most SQLException types are not recoverable.
• even when they are (e.g. SQLIntegrityConstraintViolationException), they won't appear with most statements.

Apart from jOOQ's own DataAccessException subtypes, which are thrown by jOOQ's internals, most SQLException types (or R2dbcException types) are translated and wrapped by:

• DataException when jOOQ detects SQLStateClass.C22_DATA_EXCEPTION.
• IntegrityConstraintViolationException when jOOQ detects SQLStateClass.C23_INTEGRITY_CONSTRAINT_VIOLATION.
• DataAccessException otherwise.

Author:

Sergey Epik - Merged into jOOQ from Spring JDBC Support, Lukas Eder

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
DataAccessException(String message)	Constructor for DataAccessException.
DataAccessException(String message, Throwable cause)	Constructor for DataAccessException.

Method Summary

Modifier and Type	Method	Description
<T extends Throwable> T	getCause(Class<? extends T> type)	Find a root cause of a given type, or null if no root cause of that type was found.
StackTraceElement[]	getStackTrace()
@NotNull String	sqlState()	Retrieve the SQLException.getSQLState() or R2dbcException.getSqlState() from Throwable.getCause(), if this DataAccessException was caused by a SQLException or R2dbcException.
@NotNull SQLStateClass	sqlStateClass()	Decode the SQLException.getSQLState() or R2dbcException.getSqlState() from Throwable.getCause() into SQLStateClass, if this DataAccessException was caused by a SQLException or R2dbcException.
static @NotNull SQLStateClass	sqlStateClass(io.r2dbc.spi.R2dbcException e)	Decode the R2dbcException.getSqlState() into SQLStateClass.
static @NotNull SQLStateClass	sqlStateClass(SQLException e)	Decode the SQLException.getSQLState() into SQLStateClass.
DataAccessException	sqlStateClass(SQLStateClass c)	Set the SQLStateClass.
@NotNull SQLStateSubclass	sqlStateSubclass()	Decode the SQLException.getSQLState() or R2dbcException.getSqlState() from Throwable.getCause() into SQLStateSubclass, if this DataAccessException was caused by a SQLException or R2dbcException.
DataAccessException	sqlStateSubclass(SQLStateSubclass c)	Set the SQLStateSubclass.

Methods inherited from class java.lang.Throwable

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

DataAccessException

public DataAccessException(String message)

Constructor for DataAccessException.

Parameters:

message - the detail message

DataAccessException

public DataAccessException(String message,
 Throwable cause)

Constructor for DataAccessException.

Parameters:

message - the detail message

cause - the root cause (usually from using a underlying data access API such as JDBC)

Method Details

sqlState

@NotNull
public @NotNull String sqlState()

Retrieve the SQLException.getSQLState() or R2dbcException.getSqlState() from Throwable.getCause(), if this DataAccessException was caused by a SQLException or R2dbcException.

sqlStateClass

@NotNull
public @NotNull SQLStateClass sqlStateClass()

Decode the SQLException.getSQLState() or R2dbcException.getSqlState() from Throwable.getCause() into SQLStateClass, if this DataAccessException was caused by a SQLException or R2dbcException.

sqlStateClass

public DataAccessException sqlStateClass(SQLStateClass c)

Set the SQLStateClass.

sqlStateClass

@NotNull
public static @NotNull SQLStateClass sqlStateClass(SQLException e)

Decode the SQLException.getSQLState() into SQLStateClass.

sqlStateClass

@NotNull
public static @NotNull SQLStateClass sqlStateClass(io.r2dbc.spi.R2dbcException e)

Decode the R2dbcException.getSqlState() into SQLStateClass.

sqlStateSubclass

public DataAccessException sqlStateSubclass(SQLStateSubclass c)

Set the SQLStateSubclass.

sqlStateSubclass

@NotNull
public @NotNull SQLStateSubclass sqlStateSubclass()

Decode the SQLException.getSQLState() or R2dbcException.getSqlState() from Throwable.getCause() into SQLStateSubclass, if this DataAccessException was caused by a SQLException or R2dbcException.

getStackTrace

public StackTraceElement[] getStackTrace()

Overrides:

getStackTrace in class Throwable

getCause

@Nullable
public <T extends Throwable> T getCause(Class<? extends T> type)

Find a root cause of a given type, or null if no root cause of that type was found.