Module com.aoapps.sql

Package com.aoapps.sql

Class WrappedSQLException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.sql.SQLException

com.aoapps.sql.WrappedSQLException

All Implemented Interfaces:

Serializable, Iterable<Throwable>

@Deprecated
public class WrappedSQLException
extends SQLException

Deprecated.

We have been increasingly using custom subtypes of SQLException to represent different conditions, such as when no row is returned. This allows the simple use of standard catch blocks to handle different conditions accordingly. However, wrapping the original exception defeats this, as it just become a generic SQLException, albeit with SQL STATE and such copied from the original exception.

The primary purpose of wrapping exceptions was to attach the SQL statement being processed at the time of failure. This statement is only used in error reporting, specifically via ErrorPrinter. We have created a new way to accomplish this, without altering or wrapping any exceptions: register an exception and corresponding SQL statement directly with ErrorPrinter, which will then automatically be included in error reports.

Wraps a SQLException to include its source SQL statement.

Author:

AO Industries, Inc.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
WrappedSQLException(String reason, String sqlState, int vendorCode, Throwable cause, String sqlString)	Deprecated. Please use ErrorPrinter.addSql(java.lang.Throwable, java.lang.String) instead of wrapping exceptions.
WrappedSQLException(SQLException cause, String sqlString)	Deprecated. Please use ErrorPrinter.addSql(java.lang.Throwable, java.lang.String) instead of wrapping exceptions.
WrappedSQLException(SQLException cause, PreparedStatement pstmt)	Deprecated. Please use ErrorPrinter.addSql(java.lang.Throwable, java.sql.PreparedStatement) instead of wrapping exceptions.

Method Summary

Modifier and Type	Method	Description
String	getSqlString()	Deprecated.

Methods inherited from class java.sql.SQLException

getErrorCode, getNextException, getSQLState, iterator, setNextException

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Details

WrappedSQLException

@Deprecated
public WrappedSQLException(SQLException cause,
 PreparedStatement pstmt)

Deprecated.

Please use ErrorPrinter.addSql(java.lang.Throwable, java.sql.PreparedStatement) instead of wrapping exceptions.

WrappedSQLException

@Deprecated
public WrappedSQLException(SQLException cause,
 String sqlString)

Deprecated.

Please use ErrorPrinter.addSql(java.lang.Throwable, java.lang.String) instead of wrapping exceptions.

WrappedSQLException

@Deprecated
public WrappedSQLException(String reason,
 String sqlState,
 int vendorCode,
 Throwable cause,
 String sqlString)

Deprecated.

Please use ErrorPrinter.addSql(java.lang.Throwable, java.lang.String) instead of wrapping exceptions.

Method Details

getSqlString

public String getSqlString()

Deprecated.