SQLException

public class SQLException
extends 异常 implements Iterable<Throwable>

Known Direct Subclasses BatchUpdateException, SQLClientInfoException, SQLNonTransientException, SQLRecoverableException, SQLTransientException, SQLWarning BatchUpdateException 在批量更新操作期间发生错误时引发的子类 SQLException 。 SQLClientInfoException SQLException的子类在 SQLException上无法设置一个或多个客户端信息属性时 Connection 。 SQLNonTransientException SQLException的子类当相同操作的重试失败除非 SQLException的原因得到纠正的实例时抛出。 SQLRecoverableException 如果应用程序执行一些恢复步骤 SQLException试整个事务，或者在分布式事务（事务分支）的情况下先前失败的操作可能成功的情况下引发的子类 SQLException 。 SQLTransientException SQLException的子类在先前失败的操作可能能够成功执行的情况下抛出，如果重试操作时没有任何应用程序级功能的干预。 SQLWarning 提供有关数据库访问警告信息的例外。

Known Indirect Subclasses DataTruncation, SQLDataException, SQLFeatureNotSupportedException, SQLIntegrityConstraintViolationException, SQLInvalidAuthorizationSpecException, SQLNonTransientConnectionException, SQLSyntaxErrorException, SQLTimeoutException, SQLTransactionRollbackException, SQLTransientConnectionException DataTruncation DataTruncation异常（写入时）引发的异常或 DataTruncation警告（读取时）引发的异常， DataTruncation数据值由于除MaxFieldSize MaxFieldSize原因而意外截断。 SQLDataException 当SQLState类的值为' 22 '时，或在供应商指定的条件下引发的子类 SQLException 。 SQLFeatureNotSupportedException 当SQLState类的值为' 0A '（值为'零'A）时引发的子类 SQLException 。 SQLIntegrityConstraintViolationException SQLState类的值为' 23 '时或在供应商指定的条件下引发的子类 SQLException 。 SQLInvalidAuthorizationSpecException SQLState类值为' 28 '时或在供应商指定的条件下引发的子类 SQLException 。 SQLNonTransientConnectionException SQLException的子类为SQLState类值“ 08 ”或在供应商指定的条件下抛出。 SQLSyntaxErrorException SQLState类值为' 42 '时或在供应商指定的条件下引发的子类 SQLException 。 SQLTimeoutException 当Statement指定的超时已过期时引发的子类SQLException 。 SQLTransactionRollbackException 当SQLState类的值为' 40 '时，或在供应商指定的条件下引发的子类 SQLException 。 SQLTransientConnectionException SQLException的子类，用于SQLState类值“ 08 ”或供应商指定的条件下。

提供有关数据库访问错误或其他错误信息的例外。

每个 SQLException提供几种信息：

• a string describing the error. This is used as the Java Exception message, available via the method getMesasge.
• a "SQLstate" string, which follows either the XOPEN SQLstate conventions or the SQL:2003 conventions. The values of the SQLState string are described in the appropriate spec. The DatabaseMetaData method getSQLStateType can be used to discover whether the driver returns the XOPEN type or the SQL:2003 type.
• an integer error code that is specific to each vendor. Normally this will be the actual error code returned by the underlying database.
• a chain to a next Exception. This can be used to provide additional error information.
• the causal relationship, if any for this SQLException.

摘要(Summary)

继承方法(Inherited methods)
From class java.lang.Throwable final void addSuppressed(Throwable exception) 将指定的异常附加到为了传递此异常而被禁止的异常。 Throwable fillInStackTrace() 填写执行堆栈跟踪。 Throwable getCause() 如果原因不存在或未知，则返回此throwable的原因或 null 。 String getLocalizedMessage() 创建这个throwable的本地化描述。 String getMessage() 返回此throwable的详细消息字符串。 StackTraceElement[] getStackTrace() 提供编程访问由 printStackTrace()打印的堆栈跟踪信息。 final Throwable[] getSuppressed() 为了传递此异常，返回包含所有被压缩的异常（通常由 try -with-resources语句）的 try 。 Throwable initCause(Throwable cause) 将此throwable的 原因初始化为指定值。 void printStackTrace() 将此throwable及其回溯打印到标准错误流。 void printStackTrace(PrintWriter s) 将这个throwable和它的backtrace打印到指定的打印作者。 void printStackTrace(PrintStream s) 将此throwable及其回溯打印到指定的打印流。 void setStackTrace(StackTraceElement[] stackTrace) 设置将由 getStackTrace()返回并由 printStackTrace()和相关方法打印的堆栈跟踪元素。 String toString() 返回此throwable的简短描述。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 使当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。
From interface java.lang.Iterable default void forEach(Consumer<? super T> action) 对所有元素进行处理或操作抛出异常之前，对 Iterable每个元素执行给定操作。 abstract Iterator<Throwable> iterator() 返回类型为 T元素的迭代器。 default Spliterator<Throwable> spliterator() 创建 Spliterator在由此描述的元件 Iterable 。

Public constructors

SQLException (String reason, 
                String SQLState, 
                int vendorCode)

SQLException (String reason, 
                String SQLState)

SQLException (String reason)

SQLException ()

SQLException (Throwable cause)

SQLException (String reason, 
                Throwable cause)

SQLException (String reason, 
                String sqlState, 
                Throwable cause)

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

公共方法(Public methods)

int getErrorCode ()

SQLException getNextException ()

String getSQLState ()

Iterator<Throwable> iterator ()

void setNextException (SQLException ex)