public class HibernateExceptionTranslator extends Object implements PersistenceExceptionTranslator
PersistenceExceptionTranslator
capable of translating HibernateException
instances to Spring's DataAccessException
hierarchy. As of Spring 4.3.2 and
Hibernate 5.2, it also converts standard JPA PersistenceException
instances.
Extended by LocalSessionFactoryBean
, so there is no need to declare this
translator in addition to a LocalSessionFactoryBean
.
When configuring the container with @Configuration
classes, a @Bean
of this type must be registered manually.
PersistenceExceptionTranslationPostProcessor
,
SessionFactoryUtils.convertHibernateAccessException(HibernateException)
,
EntityManagerFactoryUtils.convertJpaAccessExceptionIfPossible(RuntimeException)
Constructor and Description |
---|
HibernateExceptionTranslator() |
Modifier and Type | Method and Description |
---|---|
protected DataAccessException |
convertHibernateAccessException(HibernateException ex)
Convert the given HibernateException to an appropriate exception from the
org.springframework.dao hierarchy. |
void |
setJdbcExceptionTranslator(SQLExceptionTranslator jdbcExceptionTranslator)
Set the JDBC exception translator for Hibernate exception translation purposes.
|
DataAccessException |
translateExceptionIfPossible(RuntimeException ex)
Translate the given runtime exception thrown by a persistence framework to a
corresponding exception from Spring's generic
DataAccessException hierarchy, if possible. |
public void setJdbcExceptionTranslator(SQLExceptionTranslator jdbcExceptionTranslator)
Applied to any detected SQLException
root cause of a Hibernate
JDBCException
, overriding Hibernate's own SQLException
translation
(which is based on a Hibernate Dialect for a specific target database).
SQLException
,
JDBCException
,
SQLErrorCodeSQLExceptionTranslator
,
SQLStateSQLExceptionTranslator
@Nullable public DataAccessException translateExceptionIfPossible(RuntimeException ex)
PersistenceExceptionTranslator
DataAccessException
hierarchy, if possible.
Do not translate exceptions that are not understood by this translator: for example, if coming from another persistence framework, or resulting from user code or otherwise unrelated to persistence.
Of particular importance is the correct translation to DataIntegrityViolationException, for example on constraint violation. Implementations may use Spring JDBC's sophisticated exception translation to provide further information in the event of SQLException as a root cause.
translateExceptionIfPossible
in interface PersistenceExceptionTranslator
ex
- a RuntimeException to translatenull
if the
exception could not be translated, as in this case it may result from
user code rather than from an actual persistence problem)DataIntegrityViolationException
,
SQLExceptionTranslator
protected DataAccessException convertHibernateAccessException(HibernateException ex)
org.springframework.dao
hierarchy.
Will automatically apply a specified SQLExceptionTranslator to a Hibernate JDBCException, otherwise rely on Hibernate's default translation.
ex
- the HibernateException that occurredSessionFactoryUtils.convertHibernateAccessException(org.hibernate.HibernateException)