org.springframework.data.cassandra.core.cql

Class ReactiveCassandraAccessor

java.lang.Object

org.springframework.data.cassandra.core.cql.ReactiveCassandraAccessor

All Implemented Interfaces:

InitializingBean

Direct Known Subclasses:

ReactiveCqlTemplate

public abstract class ReactiveCassandraAccessor
extends Object
implements InitializingBean

Base class for ReactiveCqlTemplate and other CQL-accessing DAO helpers, defining common properties such as ReactiveSessionFactory and exception translator.

Not intended to be used directly.

Since:

2.0

Author:

Mark Paluch

See Also:

InitializingBean, ReactiveSession, ReactiveCqlTemplate

Field Summary

Fields

Modifier and Type	Field and Description
protected org.slf4j.Logger	logger Logger available to subclasses

Constructor Summary

Constructors

Constructor and Description
ReactiveCassandraAccessor()

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Ensures the Cassandra ReactiveSessionFactory and exception translator has been properly set.
CqlExceptionTranslator	getExceptionTranslator() Returns the exception translator for this instance.
ReactiveSessionFactory	getSessionFactory() Returns the configured ReactiveSessionFactory.
void	setExceptionTranslator(CqlExceptionTranslator exceptionTranslator) Sets the exception translator used by this template to translate Cassandra specific exceptions into Spring DAO's Exception Hierarchy.
void	setSessionFactory(ReactiveSessionFactory sessionFactory) Sets the ReactiveSessionFactory to use.
protected DataAccessException	translate(String task, String cql, RuntimeException ex) Translate the given DriverException into a generic DataAccessException.
protected DataAccessException	translateExceptionIfPossible(RuntimeException ex) Translate the given DriverException into a generic DataAccessException.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.slf4j.Logger logger

Logger available to subclasses

Constructor Detail

ReactiveCassandraAccessor

public ReactiveCassandraAccessor()

Method Detail

setSessionFactory

public void setSessionFactory(ReactiveSessionFactory sessionFactory)

Sets the ReactiveSessionFactory to use.

Parameters:

sessionFactory - must not be null.

getSessionFactory

@Nullable
public ReactiveSessionFactory getSessionFactory()

Returns the configured ReactiveSessionFactory.

Returns:

the configured ReactiveSessionFactory.

setExceptionTranslator

public void setExceptionTranslator(CqlExceptionTranslator exceptionTranslator)

Sets the exception translator used by this template to translate Cassandra specific exceptions into Spring DAO's Exception Hierarchy.

Parameters:

exceptionTranslator - exception translator to set; must not be null.

See Also:

CassandraExceptionTranslator, DataAccessException

getExceptionTranslator

public CqlExceptionTranslator getExceptionTranslator()

Returns the exception translator for this instance.

Returns:

the Cassandra exception translator.

See Also:

CassandraExceptionTranslator

afterPropertiesSet

public void afterPropertiesSet()

Ensures the Cassandra ReactiveSessionFactory and exception translator has been properly set.

Specified by:

afterPropertiesSet in interface InitializingBean

translateExceptionIfPossible

@Nullable
protected DataAccessException translateExceptionIfPossible(RuntimeException ex)

Translate the given DriverException into a generic DataAccessException.

The returned DataAccessException is supposed to contain the original DriverException as root cause. However, client code may not generally rely on this due to DataAccessExceptions possibly being caused by other resource APIs as well. That said, a getRootCause() instanceof DataAccessException check (and subsequent cast) is considered reliable when expecting Cassandra-based access to have happened.

Parameters:

ex - the offending DriverException

Returns:

the DataAccessException, wrapping the DriverException

See Also:

Consistent exception hierarchy, DataAccessException

translate

protected DataAccessException translate(String task,
                                        @Nullable
                                        String cql,
                                        RuntimeException ex)

Translate the given DriverException into a generic DataAccessException.

The returned DataAccessException is supposed to contain the original DriverException as root cause. However, client code may not generally rely on this due to DataAccessExceptions possibly being caused by other resource APIs as well. That said, a getRootCause() instanceof DataAccessException check (and subsequent cast) is considered reliable when expecting Cassandra-based access to have happened.

Parameters:

task - readable text describing the task being attempted

cql - CQL query or update that caused the problem (may be null)

ex - the offending DriverException

Returns:

the DataAccessException, wrapping the DriverException

See Also:

NestedRuntimeException.getRootCause(), Consistent exception hierarchy