SQLDataException (Java Platform SE 8 ) (original) (raw)

• java.lang.Object

• • java.lang.Throwable
  • • java.lang.Exception
      • • java.sql.SQLException
          * * java.sql.SQLNonTransientException
          * * java.sql.SQLDataException

• All Implemented Interfaces:
  Serializable, Iterable<Throwable>

public class SQLDataException
extends SQLNonTransientException
The subclass of SQLException thrown when the SQLState class value is '22', or under vendor-specified conditions. This indicates various data errors, including but not limited to data conversion errors, division by 0, and invalid arguments to functions.
Please consult your driver vendor documentation for the vendor-specified conditions for which this Exception may be thrown.
Since:
1.6
See Also:
Serialized Form

• • Constructor Summary

  Constructors

  Constructor	Description
  SQLDataException()	Constructs a SQLDataException object.
  SQLDataException(String reason)	Constructs a SQLDataException object with a givenreason.
  SQLDataException(String reason,String SQLState)	Constructs a SQLDataException object with a givenreason and SQLState.
  SQLDataException(String reason,String SQLState, int vendorCode)	Constructs a SQLDataException object with a givenreason, SQLState andvendorCode.
  SQLDataException(String reason,String SQLState, int vendorCode,Throwable cause)	Constructs a SQLDataException object with a givenreason, SQLState, vendorCode and cause.
  SQLDataException(String reason,String SQLState,Throwable cause)	Constructs a SQLDataException object with a givenreason, SQLState and cause.
  SQLDataException(String reason,Throwable cause)	Constructs a SQLDataException object with a givenreason and cause.
  SQLDataException(Throwable cause)	Constructs a SQLDataException object with a givencause.

  • Method Summary

    * ### Methods inherited from class java.sql.[SQLException](../../java/sql/SQLException.html "class in java.sql")  
    `[getErrorCode](../../java/sql/SQLException.html#getErrorCode--), [getNextException](../../java/sql/SQLException.html#getNextException--), [getSQLState](../../java/sql/SQLException.html#getSQLState--), [iterator](../../java/sql/SQLException.html#iterator--), [setNextException](../../java/sql/SQLException.html#setNextException-java.sql.SQLException-)`  
    * ### Methods inherited from class java.lang.[Throwable](../../java/lang/Throwable.html "class in java.lang")  
    `[addSuppressed](../../java/lang/Throwable.html#addSuppressed-java.lang.Throwable-), [fillInStackTrace](../../java/lang/Throwable.html#fillInStackTrace--), [getCause](../../java/lang/Throwable.html#getCause--), [getLocalizedMessage](../../java/lang/Throwable.html#getLocalizedMessage--), [getMessage](../../java/lang/Throwable.html#getMessage--), [getStackTrace](../../java/lang/Throwable.html#getStackTrace--), [getSuppressed](../../java/lang/Throwable.html#getSuppressed--), [initCause](../../java/lang/Throwable.html#initCause-java.lang.Throwable-), [printStackTrace](../../java/lang/Throwable.html#printStackTrace--), [printStackTrace](../../java/lang/Throwable.html#printStackTrace-java.io.PrintStream-), [printStackTrace](../../java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-), [setStackTrace](../../java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement:A-), [toString](../../java/lang/Throwable.html#toString--)`  
    * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang")  
    `[clone](../../java/lang/Object.html#clone--), [equals](../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../java/lang/Object.html#finalize--), [getClass](../../java/lang/Object.html#getClass--), [hashCode](../../java/lang/Object.html#hashCode--), [notify](../../java/lang/Object.html#notify--), [notifyAll](../../java/lang/Object.html#notifyAll--), [wait](../../java/lang/Object.html#wait--), [wait](../../java/lang/Object.html#wait-long-), [wait](../../java/lang/Object.html#wait-long-int-)`  
    * ### Methods inherited from interface java.lang.[Iterable](../../java/lang/Iterable.html "interface in java.lang")  
    `[forEach](../../java/lang/Iterable.html#forEach-java.util.function.Consumer-), [spliterator](../../java/lang/Iterable.html#spliterator--)`

• • Constructor Detail

     * #### SQLDataException  
     public SQLDataException()  
     Constructs a `SQLDataException` 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[Throwable.initCause(java.lang.Throwable)](../../java/lang/Throwable.html#initCause-java.lang.Throwable-) method.  
     Since:  
     1.6  
     * #### SQLDataException  
     public SQLDataException([String](../../java/lang/String.html "class in java.lang") reason)  
     Constructs a `SQLDataException` 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[Throwable.initCause(java.lang.Throwable)](../../java/lang/Throwable.html#initCause-java.lang.Throwable-) method.  
     Parameters:  
     `reason` \- a description of the exception  
     Since:  
     1.6  
     * #### SQLDataException  
     public SQLDataException([String](../../java/lang/String.html "class in java.lang") reason,  
                             [String](../../java/lang/String.html "class in java.lang") SQLState)  
     Constructs a `SQLDataException` object with a given`reason` and `SQLState`. The vendor code is initialized to 0\. The `cause` is not initialized, and may subsequently be initialized by a call to[Throwable.initCause(java.lang.Throwable)](../../java/lang/Throwable.html#initCause-java.lang.Throwable-) method.  
     Parameters:  
     `reason` \- a description of the exception  
     `SQLState` \- an XOPEN or SQL:2003 code identifying the exception  
     Since:  
     1.6  
     * #### SQLDataException  
     public SQLDataException([String](../../java/lang/String.html "class in java.lang") reason,  
                             [String](../../java/lang/String.html "class in java.lang") SQLState,  
                             int vendorCode)  
     Constructs a `SQLDataException` object with a given`reason`, `SQLState` and`vendorCode`. The `cause` is not initialized, and may subsequently be initialized by a call to[Throwable.initCause(java.lang.Throwable)](../../java/lang/Throwable.html#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  
     Since:  
     1.6  
     * #### SQLDataException  
     public SQLDataException([Throwable](../../java/lang/Throwable.html "class in java.lang") cause)  
     Constructs a `SQLDataException` 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  
     * #### SQLDataException  
     public SQLDataException([String](../../java/lang/String.html "class in java.lang") reason,  
                             [Throwable](../../java/lang/Throwable.html "class in java.lang") cause)  
     Constructs a `SQLDataException` 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  
     * #### SQLDataException  
     public SQLDataException([String](../../java/lang/String.html "class in java.lang") reason,  
                             [String](../../java/lang/String.html "class in java.lang") SQLState,  
                             [Throwable](../../java/lang/Throwable.html "class in java.lang") cause)  
     Constructs a `SQLDataException` 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  
     * #### SQLDataException  
     public SQLDataException([String](../../java/lang/String.html "class in java.lang") reason,  
                             [String](../../java/lang/String.html "class in java.lang") SQLState,  
                             int vendorCode,  
                             [Throwable](../../java/lang/Throwable.html "class in java.lang") cause)  
     Constructs a `SQLDataException` 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

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.