org.springframework.data.r2dbc.support

Class AbstractFallbackR2dbcExceptionTranslator

java.lang.Object

org.springframework.data.r2dbc.support.AbstractFallbackR2dbcExceptionTranslator

All Implemented Interfaces:

R2dbcExceptionTranslator

Direct Known Subclasses:

R2dbcExceptionSubclassTranslator, SqlErrorCodeR2dbcExceptionTranslator, SqlStateR2dbcExceptionTranslator

Deprecated.

since 1.2. Use Spring R2DBC's ConnectionFactoryUtils.convertR2dbcException(String, String, R2dbcException) instead.

@Deprecated
public abstract class AbstractFallbackR2dbcExceptionTranslator
extends Object
implements R2dbcExceptionTranslator

Base class for R2dbcExceptionTranslator implementations that allow for fallback to some other R2dbcExceptionTranslator.

Author:

Mark Paluch

Field Summary

Fields

Modifier and Type	Field and Description
protected Log	logger Deprecated. Logger available to subclasses

Constructor Summary

Constructors

Constructor and Description
AbstractFallbackR2dbcExceptionTranslator() Deprecated.

Method Summary

Modifier and Type	Method and Description
protected String	buildMessage(String task, String sql, R2dbcException ex) Deprecated. Build a message String for the given R2dbcException.
protected abstract DataAccessException	doTranslate(String task, String sql, R2dbcException ex) Deprecated. Template method for actually translating the given exception.
R2dbcExceptionTranslator	getFallbackTranslator() Deprecated. Return the fallback exception translator, if any.
void	setFallbackTranslator(R2dbcExceptionTranslator fallback) Deprecated. Override the default SQL state fallback translator (typically a R2dbcExceptionTranslator).
DataAccessException	translate(String task, String sql, R2dbcException ex) Deprecated. Pre-checks the arguments, calls doTranslate(java.lang.String, java.lang.String, io.r2dbc.spi.R2dbcException), and invokes the fallback translator if necessary.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final Log logger

Deprecated.

Logger available to subclasses

Constructor Detail

AbstractFallbackR2dbcExceptionTranslator

public AbstractFallbackR2dbcExceptionTranslator()

Deprecated.

Method Detail

setFallbackTranslator

public void setFallbackTranslator(@Nullable
                                  R2dbcExceptionTranslator fallback)

Deprecated.

Override the default SQL state fallback translator (typically a R2dbcExceptionTranslator).

getFallbackTranslator

@Nullable
public R2dbcExceptionTranslator getFallbackTranslator()

Deprecated.

Return the fallback exception translator, if any.

translate

@NonNull
public DataAccessException translate(String task,
                                              @Nullable
                                              String sql,
                                              R2dbcException ex)

Deprecated.

Pre-checks the arguments, calls doTranslate(java.lang.String, java.lang.String, io.r2dbc.spi.R2dbcException), and invokes the fallback translator if necessary.

Specified by:

translate in interface R2dbcExceptionTranslator

Parameters:

task - readable text describing the task being attempted.

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

ex - the offending R2dbcException.

Returns:

the DataAccessException wrapping the R2dbcException, or null if no translation could be applied (in a custom translator; the default translators always throw an UncategorizedR2dbcException in such a case).

See Also:

NestedRuntimeException.getRootCause()

doTranslate

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

Deprecated.

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.

Parameters:

task - readable text describing the task being attempted.

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

ex - the offending R2dbcException.

Returns:

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

buildMessage

protected String buildMessage(String task,
                              @Nullable
                              String sql,
                              R2dbcException ex)

Deprecated.

Build a message String for the given R2dbcException.

To be called by translator subclasses when creating an instance of a generic DataAccessException class.

Parameters:

task - readable text describing the task being attempted.

sql - the SQL statement that caused the problem.

ex - the offending R2dbcException.

Returns:

the message String to use.