OpenJDK 27 · java.sql.SQLException · APIdia, the JavaDoc alternative

Modifier and Type	Field and Description
private volatile SQLException	next
private static final AtomicReferenceFieldUpdater<SQLException, SQLException>	nextUpdater
private static final long	serialVersionUID Hides java.lang.Exception.serialVersionUID.
private String	SQLState
private int	vendorCode

Constructor Summary

Access	Constructor and Description
public	SQLException(String a description of the exception reason, String an XOPEN or SQL:2003 code identifying the exception SQLState, int a database vendor-specific exception code vendorCode) Constructs a `SQLException` object with a given `reason`, `SQLState` and `vendorCode`.
public	SQLException(String a description of the exception reason, String an XOPEN or SQL:2003 code identifying the exception SQLState) Constructs a `SQLException` object with a given `reason` and `SQLState`.
public	SQLException(String a description of the exception reason) Constructs a `SQLException` object with a given `reason`.
public	SQLException() Constructs a `SQLException` object.
public	SQLException(Throwable 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. cause) Constructs a `SQLException` object with a given `cause`.
public	SQLException(String a description of the exception. reason, Throwable 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. cause) Constructs a `SQLException` object with a given `reason` and `cause`.
public	SQLException(String a description of the exception. reason, String an XOPEN or SQL:2003 code identifying the exception sqlState, Throwable 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. cause) Constructs a `SQLException` object with a given `reason`, `SQLState` and `cause`.
public	SQLException(String a description of the exception reason, String an XOPEN or SQL:2003 code identifying the exception sqlState, int a database vendor-specific exception code vendorCode, Throwable 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. cause) Constructs a `SQLException` object with a given `reason`, `SQLState`, `vendorCode` and `cause`.

Method Summary

Modifier and Type	Method and Description
public int	Returns: the vendor's error code getErrorCode() Retrieves the vendor-specific exception code for this `SQLException` object.
public SQLException	Returns: the next `SQLException` object in the chain; `null` if there are none getNextException() Retrieves the exception chained to this `SQLException` object by setNextException(SQLException ex).
public String	Returns: the SQLState value getSQLState() Retrieves the SQLState for this `SQLException` object.
public Iterator<Throwable>	Returns: an iterator over the chained SQLExceptions and causes in the proper order iterator() Implements java.lang.Iterable.iterator. Returns an iterator over the chained SQLExceptions.
public void	setNextException(SQLException the new exception that will be added to the end of the `SQLException` chain ex) Adds an `SQLException` object to the end of the chain.

Field Detail

next	back to summary
private volatile SQLException next

nextUpdater	back to summary
private static final AtomicReferenceFieldUpdater<SQLException, SQLException> nextUpdater

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.lang.Exception.serialVersionUID.

SQLState	back to summary
private String SQLState

vendorCode	back to summary
private int vendorCode

Constructor Detail

SQLException back to summary

SQLException	back to summary
public SQLException(String reason, String SQLState, int vendorCode) Constructs a `SQLException` 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:String a description of the exception SQLState:String an XOPEN or SQL:2003 code identifying the exception vendorCode:int a database vendor-specific exception code

public SQLException(String reason, String SQLState, int vendorCode)

Constructs a SQLException 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:String: a description of the exception
SQLState:String: an XOPEN or SQL:2003 code identifying the exception
vendorCode:int: a database vendor-specific exception code

SQLException back to summary

SQLException	back to summary
public SQLException(String reason, String SQLState) Constructs a `SQLException` 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:String a description of the exception SQLState:String an XOPEN or SQL:2003 code identifying the exception

public SQLException(String reason, String SQLState)

Constructs a SQLException 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:String: a description of the exception
SQLState:String: an XOPEN or SQL:2003 code identifying the exception

SQLException back to summary

SQLException	back to summary
public SQLException(String reason) Constructs a `SQLException` 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:String a description of the exception

public SQLException(String reason)

Constructs a SQLException 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:String: a description of the exception

SQLException	back to summary
public SQLException() Constructs a `SQLException` 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.

SQLException back to summary

SQLException	back to summary
public SQLException(Throwable cause) Constructs a `SQLException` 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:Throwable 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

public SQLException(Throwable cause)

Constructs a SQLException 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:Throwable: 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

SQLException back to summary

SQLException	back to summary
public SQLException(String reason, Throwable cause) Constructs a `SQLException` object with a given `reason` and `cause`. The `SQLState` is initialized to `null` and the vendor code is initialized to 0. Parameters reason:String a description of the exception. cause:Throwable 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

public SQLException(String reason, Throwable cause)

Constructs a SQLException object with a given reason and cause. The SQLState is initialized to null and the vendor code is initialized to 0.

Parameters

reason:String: a description of the exception.
cause:Throwable: 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

SQLException back to summary

SQLException	back to summary
public SQLException(String reason, String sqlState, Throwable cause) Constructs a `SQLException` object with a given `reason`, `SQLState` and `cause`. The vendor code is initialized to 0. Parameters reason:String a description of the exception. sqlState:String an XOPEN or SQL:2003 code identifying the exception cause:Throwable 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

public SQLException(String reason, String sqlState, Throwable cause)

Constructs a SQLException object with a given reason, SQLState and cause. The vendor code is initialized to 0.

Parameters

reason:String: a description of the exception.
sqlState:String: an XOPEN or SQL:2003 code identifying the exception
cause:Throwable: 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

SQLException back to summary

SQLException	back to summary
public SQLException(String reason, String sqlState, int vendorCode, Throwable cause) Constructs a `SQLException` object with a given `reason`, `SQLState`, `vendorCode` and `cause`. Parameters reason:String a description of the exception sqlState:String an XOPEN or SQL:2003 code identifying the exception vendorCode:int a database vendor-specific exception code cause:Throwable 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

public SQLException(String reason, String sqlState, int vendorCode, Throwable cause)

Constructs a SQLException object with a given reason, SQLState, vendorCode and cause.

Parameters

reason:String: a description of the exception
sqlState:String: an XOPEN or SQL:2003 code identifying the exception
vendorCode:int: a database vendor-specific exception code
cause:Throwable: 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

Method Detail

getErrorCode back to summary

getErrorCode	back to summary
public int getErrorCode() Retrieves the vendor-specific exception code for this `SQLException` object. Returns:int the vendor's error code

public int getErrorCode()

Retrieves the vendor-specific exception code for this SQLException object.

Returns:int: the vendor's error code

getNextException back to summary

getNextException	back to summary
public SQLException getNextException() Retrieves the exception chained to this `SQLException` object by setNextException(SQLException ex). Returns:SQLException the next `SQLException` object in the chain; `null` if there are none See Also `setNextException`

public SQLException getNextException()

Retrieves the exception chained to this SQLException object by setNextException(SQLException ex).

Returns:SQLException: the next SQLException object in the chain; null if there are none
See Also: setNextException

getSQLState back to summary

getSQLState	back to summary
public String getSQLState() Retrieves the SQLState for this `SQLException` object. Returns:String the SQLState value

public String getSQLState()

Retrieves the SQLState for this SQLException object.

Returns:String: the SQLState value

iterator	back to summary
public Iterator<Throwable> iterator() Implements java.lang.Iterable.iterator. Returns an iterator over the chained SQLExceptions. The iterator will be used to iterate over each SQLException and its underlying cause (if any). Returns:Iterator<Throwable> an iterator over the chained SQLExceptions and causes in the proper order Since 1.6

iterator

back to summary

public Iterator<Throwable> iterator()

Implements java.lang.Iterable.iterator.

Returns an iterator over the chained SQLExceptions. The iterator will be used to iterate over each SQLException and its underlying cause (if any).

Returns:Iterator<Throwable>: an iterator over the chained SQLExceptions and causes in the proper order
Since: 1.6

setNextException back to summary

setNextException	back to summary
public void setNextException(SQLException ex) Adds an `SQLException` object to the end of the chain. Parameters ex:SQLException the new exception that will be added to the end of the `SQLException` chain See Also `getNextException`

public void setNextException(SQLException ex)

Adds an SQLException object to the end of the chain.

Parameters

ex:SQLException: the new exception that will be added to the end of the SQLException chain

See Also

getNextException

public Class SQLException

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail