Class ConstraintViolationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

jakarta.persistence.PersistenceException

org.hibernate.HibernateException

org.hibernate.JDBCException

org.hibernate.exception.ConstraintViolationException

All Implemented Interfaces:

Serializable

public class ConstraintViolationException
extends JDBCException

A JDBCException indicating that the requested DML operation resulted in violation of a defined data integrity constraint.

See Also:

• Column.unique()
• Column.nullable()
• Column.check()
• JoinColumn.foreignKey()
• Table.uniqueConstraints()
• Table.check()
• JoinTable.foreignKey()
• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	ConstraintViolationException.ConstraintKind	Enumerates the kinds of integrity constraint violation recognized by Hibernate.

Constructor Summary

Constructors

Constructor	Description
ConstraintViolationException(String message, SQLException root, String constraintName)
ConstraintViolationException(String message, SQLException root, String sql, String constraintName)
ConstraintViolationException(String message, SQLException root, String sql, ConstraintViolationException.ConstraintKind kind, String constraintName)
ConstraintViolationException(String message, SQLException root, ConstraintViolationException.ConstraintKind kind, String constraintName)

Method Summary

Modifier and Type	Method	Description
String	getConstraintName()	Returns the name of the violated constraint, if known.
ConstraintViolationException.ConstraintKind	getKind()	Returns the kind of constraint that was violated.

Methods inherited from class JDBCException

getErrorCode, getErrorMessage, getSQL, getSQLException, getSQLState

Methods inherited from class Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

ConstraintViolationException

public ConstraintViolationException(String message,
 SQLException root,
 @Nullable
 String constraintName)

ConstraintViolationException

public ConstraintViolationException(String message,
 SQLException root,
 String sql,
 @Nullable
 String constraintName)

ConstraintViolationException

public ConstraintViolationException(String message,
 SQLException root,
 ConstraintViolationException.ConstraintKind kind,
 @Nullable
 String constraintName)

ConstraintViolationException

public ConstraintViolationException(String message,
 SQLException root,
 String sql,
 ConstraintViolationException.ConstraintKind kind,
 @Nullable
 String constraintName)

Method Details

getConstraintName

@Nullable
public String getConstraintName()

Returns the name of the violated constraint, if known.

Returns:

The name of the violated constraint, or null if the name is not known.

See Also:

• ForeignKey.name()
• UniqueConstraint.name()
• CheckConstraint.name()

API Note:

Some databases do not reliably report the name of the constraint which was violated. Furthermore, many constraints have system-generated names.

getKind

public ConstraintViolationException.ConstraintKind getKind()

Returns the kind of constraint that was violated.