Class HibernateExceptionTranslator
- java.lang.Object
- org.springframework.orm.hibernate5.HibernateExceptionTranslator
- All Implemented Interfaces:
PersistenceExceptionTranslator
- Direct Known Subclasses:
LocalSessionFactoryBean
public class HibernateExceptionTranslator extends Object implements PersistenceExceptionTranslator
PersistenceExceptionTranslatorcapable of translatingHibernateExceptioninstances to Spring'sDataAccessExceptionhierarchy. As of Spring 4.3.2 and Hibernate 5.2, it also converts standard JPAPersistenceExceptioninstances.Extended by
LocalSessionFactoryBean, so there is no need to declare this translator in addition to aLocalSessionFactoryBean.When configuring the container with
@Configurationclasses, a@Beanof this type must be registered manually.
Constructor Summary
Constructors Constructor Description HibernateExceptionTranslator()
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected DataAccessExceptionconvertHibernateAccessException(HibernateException ex)Convert the given HibernateException to an appropriate exception from theorg.springframework.daohierarchy.voidsetJdbcExceptionTranslator(SQLExceptionTranslator jdbcExceptionTranslator)Set the JDBC exception translator for Hibernate exception translation purposes.DataAccessExceptiontranslateExceptionIfPossible(RuntimeException ex)Translate the given runtime exception thrown by a persistence framework to a corresponding exception from Spring's genericDataAccessExceptionhierarchy, if possible.
Constructor Detail
HibernateExceptionTranslator
public HibernateExceptionTranslator()
Method Detail
setJdbcExceptionTranslator
public void setJdbcExceptionTranslator(SQLExceptionTranslator jdbcExceptionTranslator)
Set the JDBC exception translator for Hibernate exception translation purposes.Applied to any detected
SQLExceptionroot cause of a HibernateJDBCException, overriding Hibernate's ownSQLExceptiontranslation (which is based on a Hibernate Dialect for a specific target database).- Since:
- 5.1
- See Also:
SQLException,JDBCException,SQLErrorCodeSQLExceptionTranslator,SQLStateSQLExceptionTranslator
translateExceptionIfPossible
@Nullable public DataAccessException translateExceptionIfPossible(RuntimeException ex)
Description copied from interface:PersistenceExceptionTranslatorTranslate the given runtime exception thrown by a persistence framework to a corresponding exception from Spring's genericDataAccessExceptionhierarchy, 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.
- Specified by:
translateExceptionIfPossiblein interfacePersistenceExceptionTranslator- Parameters:
ex- a RuntimeException to translate- Returns:
- the corresponding DataAccessException (or
nullif the exception could not be translated, as in this case it may result from user code rather than from an actual persistence problem) - See Also:
DataIntegrityViolationException,SQLExceptionTranslator
convertHibernateAccessException
protected DataAccessException convertHibernateAccessException(HibernateException ex)
Convert the given HibernateException to an appropriate exception from theorg.springframework.daohierarchy.Will automatically apply a specified SQLExceptionTranslator to a Hibernate JDBCException, otherwise rely on Hibernate's default translation.
- Parameters:
ex- the HibernateException that occurred- Returns:
- a corresponding DataAccessException
- See Also:
SessionFactoryUtils.convertHibernateAccessException(org.hibernate.HibernateException)