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

• java.lang.Object

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

• All Implemented Interfaces:
  Serializable, Iterable<Throwable>

public class SQLIntegrityConstraintViolationException
extends SQLNonTransientException
The subclass of SQLException thrown when the SQLState class value is '23', or under vendor-specified conditions. This indicates that an integrity constraint (foreign key, primary key or unique key) has been violated.
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
  SQLIntegrityConstraintViolationException()	Constructs a SQLIntegrityConstraintViolationException object.
  SQLIntegrityConstraintViolationException(String reason)	Constructs a SQLIntegrityConstraintViolationException with a given reason.
  SQLIntegrityConstraintViolationException(String reason,String SQLState)	Constructs a SQLIntegrityConstraintViolationException object with a given reason and SQLState.
  SQLIntegrityConstraintViolationException(String reason,String SQLState, int vendorCode)	Constructs a SQLIntegrityConstraintViolationException object with a given reason, SQLState andvendorCode.
  SQLIntegrityConstraintViolationException(String reason,String SQLState, int vendorCode,Throwable cause)	Constructs a SQLIntegrityConstraintViolationException object with a givenreason, SQLState, vendorCode and cause.
  SQLIntegrityConstraintViolationException(String reason,String SQLState,Throwable cause)	Constructs a SQLIntegrityConstraintViolationException object with a givenreason, SQLState and cause.
  SQLIntegrityConstraintViolationException(String reason,Throwable cause)	Constructs a SQLIntegrityConstraintViolationException object with a givenreason and cause.
  SQLIntegrityConstraintViolationException(Throwable cause)	Constructs an SQLIntegrityConstraintViolationException object with a given cause.

  • 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

     * #### SQLIntegrityConstraintViolationException  
     public SQLIntegrityConstraintViolationException()  
     Constructs a `SQLIntegrityConstraintViolationException` 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)](../../java/lang/Throwable.html#initCause-java.lang.Throwable-) method.  
     Since:  
     1.6  
     * #### SQLIntegrityConstraintViolationException  
     public SQLIntegrityConstraintViolationException([String](../../java/lang/String.html "class in java.lang") reason)  
     Constructs a `SQLIntegrityConstraintViolationException` 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)](../../java/lang/Throwable.html#initCause-java.lang.Throwable-) method.  
     Parameters:  
     `reason` \- a description of the exception  
     Since:  
     1.6  
     * #### SQLIntegrityConstraintViolationException  
     public SQLIntegrityConstraintViolationException([String](../../java/lang/String.html "class in java.lang") reason,  
                                                     [String](../../java/lang/String.html "class in java.lang") SQLState)  
     Constructs a `SQLIntegrityConstraintViolationException` 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)](../../java/lang/Throwable.html#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  
     Since:  
     1.6  
     * #### SQLIntegrityConstraintViolationException  
     public SQLIntegrityConstraintViolationException([String](../../java/lang/String.html "class in java.lang") reason,  
                                                     [String](../../java/lang/String.html "class in java.lang") SQLState,  
                                                     int vendorCode)  
     Constructs a `SQLIntegrityConstraintViolationException` 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)](../../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  
     * #### SQLIntegrityConstraintViolationException  
     public SQLIntegrityConstraintViolationException([Throwable](../../java/lang/Throwable.html "class in java.lang") cause)  
     Constructs an `SQLIntegrityConstraintViolationException` 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  
     * #### SQLIntegrityConstraintViolationException  
     public SQLIntegrityConstraintViolationException([String](../../java/lang/String.html "class in java.lang") reason,  
                                                     [Throwable](../../java/lang/Throwable.html "class in java.lang") cause)  
     Constructs a `SQLIntegrityConstraintViolationException` 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 (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown.  
     Since:  
     1.6  
     * #### SQLIntegrityConstraintViolationException  
     public SQLIntegrityConstraintViolationException([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 `SQLIntegrityConstraintViolationException` 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  
     * #### SQLIntegrityConstraintViolationException  
     public SQLIntegrityConstraintViolationException([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 `SQLIntegrityConstraintViolationException` 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 (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.