Save This Page
Home » openjdk-7 » java » sql » [javadoc | source]
java.sql
public class: SQLException [javadoc | source]
java.lang.Object
   java.lang.Throwable
      java.lang.Exception
         java.sql.SQLException

All Implemented Interfaces:
    Iterable, Serializable

An exception that provides information on a database access error or other errors.

Each SQLException provides several kinds of information:

Fields inherited from java.lang.Exception:
serialVersionUID
Constructor:
 public SQLException() 
 public SQLException(String reason) 
    Constructs a SQLException object with a given reason. The SQLState is initialized to null and the vender 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
 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 - 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) 
    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 - a description of the exception
    SQLState - an XOPEN or SQL:2003 code identifying the exception
 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 - 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 -
 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 - a description of the exception
    SQLState - an XOPEN or SQL:2003 code identifying the exception
    vendorCode - a database vendor-specific exception code
 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 - 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 -
 public SQLException(String reason,
    String sqlState,
    int vendorCode,
    Throwable cause) 
    Constructs a SQLException 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 -
Method from java.sql.SQLException Summary:
getErrorCode,   getNextException,   getSQLState,   iterator,   setNextException
Methods from java.lang.Throwable:
addSuppressed,   fillInStackTrace,   getCause,   getLocalizedMessage,   getMessage,   getStackTrace,   getStackTraceDepth,   getStackTraceElement,   getSuppressed,   initCause,   printStackTrace,   printStackTrace,   printStackTrace,   setStackTrace,   toString
Methods from java.lang.Object:
clone,   equals,   finalize,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from java.sql.SQLException Detail:
 public int getErrorCode() 
    Retrieves the vendor-specific exception code for this SQLException object.
 public SQLException getNextException() 
    Retrieves the exception chained to this SQLException object by setNextException(SQLException ex).
 public String getSQLState() 
    Retrieves the SQLState for this SQLException object.
 public Iterator<Throwable> iterator() 
    Returns an iterator over the chained SQLExceptions. The iterator will be used to iterate over each SQLException and its underlying cause (if any).
 public  void setNextException(SQLException ex) 
    Adds an SQLException object to the end of the chain.