Class SQLExceptionSubclassTranslator

java.lang.Object

org.springframework.jdbc.support.AbstractFallbackSQLExceptionTranslator

org.springframework.jdbc.support.SQLExceptionSubclassTranslator

All Implemented Interfaces:

SQLExceptionTranslator

public class SQLExceptionSubclassTranslator
extends AbstractFallbackSQLExceptionTranslator

SQLExceptionTranslator implementation which analyzes the specific SQLException subclass thrown by the JDBC driver.

Falls back to a standard SQLStateSQLExceptionTranslator if the JDBC driver does not actually expose JDBC 4 compliant SQLException subclasses.

This translator serves as the default JDBC exception translator as of 6.0. As of 6.2.12, it specifically introspects BatchUpdateException to look at the underlying exception, analogous to the former default SQLErrorCodeSQLExceptionTranslator.

Since:

2.5

Author:

Thomas Risberg, Juergen Hoeller

See Also:

• SQLTransientException
• SQLNonTransientException
• SQLRecoverableException

Field Summary

Fields inherited from class AbstractFallbackSQLExceptionTranslator

logger

Constructor Summary

Constructors

Constructor	Description
SQLExceptionSubclassTranslator()

Method Summary

Modifier and Type	Method	Description
protected @Nullable DataAccessException	doTranslate(String task, @Nullable String sql, SQLException ex)	Template method for actually translating the given exception.

Methods inherited from class AbstractFallbackSQLExceptionTranslator

buildMessage, getCustomTranslator, getFallbackTranslator, setCustomTranslator, setFallbackTranslator, translate

Methods inherited from class Object

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

Constructor Details

SQLExceptionSubclassTranslator

public SQLExceptionSubclassTranslator()

Method Details

doTranslate

protected @Nullable DataAccessException doTranslate(String task,
 @Nullable String sql,
 SQLException ex)

Description copied from class: AbstractFallbackSQLExceptionTranslator

Template method for actually translating the given exception.

The passed-in arguments will have been pre-checked. Furthermore, this method is allowed to return null to indicate that no exception match has been found and that fallback translation should kick in.

Specified by:

doTranslate in class AbstractFallbackSQLExceptionTranslator

Parameters:

task - readable text describing the task being attempted

sql - the SQL query or update that caused the problem (if known)

ex - the offending SQLException

Returns:

the DataAccessException, wrapping the SQLException; or null if no exception match found