java.sql.SQLException
An Exception class that is used in conjunction with JDBC operations. It
provides information about problems encountered with Database access and
other problems related to JDBC
The SQLException class provides the following information:
- A standard Java exception message, as a String
- An SQLState string. This is an error description string which follows
either the SQL 99 conventions or the XOPEN SQLstate conventions. The
potential values of the SQLState string are described in each of the
specifications. Which of the conventions is being used by the SQLState string
can be discovered by using the getSQLStateType method of the DatabaseMetaData
interface.
- An Error Code, an an integer. The error code is specific to each
database vendor and is typically the error code returned by the database
itself.
- A chain to a next Exception, if relevant, which can give access to
additional error information.
Known Direct Subclasses
BatchUpdateException |
An exception thrown if a problem occurs during a batch update operation. |
SQLWarning |
An exception class that holds information about Database access warnings. |
Known Indirect Subclasses
DataTruncation |
An exception which is thrown when a JDBC driver unexpectedly truncates a data
value either when reading or when writing data. |
Summary
Public Constructors
Public Methods
fillInStackTrace,
getCause,
getLocalizedMessage,
getMessage,
getStackTrace,
initCause,
printStackTrace,
printStackTrace,
printStackTrace,
setStackTrace,
toString
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Public Constructors
public
SQLException()
Creates an SQLException object. The Reason string is set to null, the
SQLState string is set to null and the Error Code is set to 0.
public
SQLException(String theReason)
Creates an SQLException object. The Reason string is set to the given
reason string, the SQLState string is set to null and the Error Code is
set to 0.
Parameters
theReason
| the string to use as the Reason string
|
public
SQLException(String theReason, String theSQLState)
Creates an SQLException object. The Reason string is set to the given
reason string, the SQLState string is set to the given SQLState string
and the Error Code is set to 0.
Parameters
theReason
| the string to use as the Reason string |
theSQLState
| the string to use as the SQLState string
|
public
SQLException(String theReason, String theSQLState, int theErrorCode)
Creates an SQLException object. The Reason string is set to the given
reason string, the SQLState string is set to the given SQLState string
and the Error Code is set to the given error code value.
Parameters
theReason
| the string to use as the Reason string |
theSQLState
| the string to use as the SQLState string |
theErrorCode
| the integer value for the error code
|
Public Methods
public
int
getErrorCode()
Returns the integer error code for this SQLException
Returns
- The integer error code for this SQLException. The meaning of the
code is specific to the vendor of the database.
public
SQLException
getNextException()
Retrieves the SQLException chained to this SQLException, if any.
Returns
- The SQLException chained to this SQLException. null if there is
no SQLException chained to this SQLException.
public
String
getSQLState()
Retrieves the SQLState description string for this SQLException object
Returns
- The SQLState string for this SQLException object. This is an
error description string which follows either the SQL 99
conventions or the XOPEN SQLstate conventions. The potential
values of the SQLState string are described in each of the
specifications. Which of the conventions is being used by the
SQLState string can be discovered by using the getSQLStateType
method of the DatabaseMetaData interface.
public
void
setNextException(SQLException ex)
Adds the SQLException to the end of this SQLException chain.
Parameters
ex
| the new SQLException to be added to the end of the chain
|