Top Description Methods
org.springframework.dao.support

public Interface PersistenceExceptionTranslator

Known Direct Implementers
org.springframework.dao.support.ChainedPersistenceExceptionTranslator
Annotations
@FunctionalInterface
Imports
org.springframework.dao.DataAccessException, org.springframework.lang.Nullable
Interface implemented by Spring integrations with data access technologies that throw runtime exceptions, such as JPA and Hibernate.

This allows consistent usage of combined exception translation functionality, without forcing a single translator to understand every single possible type of exception.

Authors
Rod Johnson, Juergen Hoeller
Since
2.0

Method Summary

Modifier and TypeMethod and Description
public DataAccessException

Returns:

the corresponding DataAccessException (or null if the exception could not be translated, as in this case it may result from user code rather than from an actual persistence problem)
translateExceptionIfPossible(RuntimeException
a RuntimeException to translate
ex)

Translate the given runtime exception thrown by a persistence framework to a corresponding exception from Spring's generic org.springframework.dao.DataAccessException hierarchy, if possible.

Method Detail

translateExceptionIfPossibleback to summary
public DataAccessException translateExceptionIfPossible(RuntimeException ex)

Translate the given runtime exception thrown by a persistence framework to a corresponding exception from Spring's generic org.springframework.dao.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.

Parameters
ex:RuntimeException

a RuntimeException to translate

Returns:DataAccessException

the corresponding DataAccessException (or null if the exception could not be translated, as in this case it may result from user code rather than from an actual persistence problem)

Annotations
@Nullable
See Also
org.springframework.dao.DataIntegrityViolationException, org.springframework.jdbc.support.SQLExceptionTranslator