org.springframework.data.r2dbc.config

Class AbstractR2dbcConfiguration

java.lang.Object

org.springframework.data.r2dbc.config.AbstractR2dbcConfiguration

All Implemented Interfaces:

Aware, ApplicationContextAware

@Configuration(proxyBeanMethods=false)
public abstract class AbstractR2dbcConfiguration
extends Object
implements ApplicationContextAware

Base class for Spring Data R2DBC configuration containing bean declarations that must be registered for Spring Data R2DBC to work.

Author:

Mark Paluch

See Also:

ConnectionFactory, DatabaseClient, EnableR2dbcRepositories

Constructor Summary

Constructors

Constructor and Description
AbstractR2dbcConfiguration()

Method Summary

Modifier and Type	Method and Description
abstract ConnectionFactory	connectionFactory() Return a R2DBC ConnectionFactory.
DatabaseClient	databaseClient(ReactiveDataAccessStrategy dataAccessStrategy, R2dbcExceptionTranslator exceptionTranslator) Register a DatabaseClient using connectionFactory() and RelationalMappingContext.
R2dbcExceptionTranslator	exceptionTranslator() Creates a R2dbcExceptionTranslator using the configured ConnectionFactory.
protected List<Object>	getCustomConverters() Customization hook to return custom converters.
R2dbcDialect	getDialect(ConnectionFactory connectionFactory) Return a R2dbcDialect for the given ConnectionFactory.
protected CustomConversions.StoreConversions	getStoreConversions() Returns the R2dbcDialect-specific CustomConversions.StoreConversions.
R2dbcCustomConversions	r2dbcCustomConversions() Register custom Converters in a CustomConversions object if required.
org.springframework.data.relational.core.mapping.RelationalMappingContext	r2dbcMappingContext(Optional<org.springframework.data.relational.core.mapping.NamingStrategy> namingStrategy, R2dbcCustomConversions r2dbcCustomConversions) Register a RelationalMappingContext and apply an optional NamingStrategy.
ReactiveDataAccessStrategy	reactiveDataAccessStrategy(org.springframework.data.relational.core.mapping.RelationalMappingContext mappingContext, R2dbcCustomConversions r2dbcCustomConversions) Creates a ReactiveDataAccessStrategy using the configured r2dbcMappingContext(Optional, R2dbcCustomConversions) RelationalMappingContext}.
void	setApplicationContext(ApplicationContext applicationContext)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractR2dbcConfiguration

public AbstractR2dbcConfiguration()

Method Detail

setApplicationContext

public void setApplicationContext(ApplicationContext applicationContext)
                           throws BeansException

Specified by:

setApplicationContext in interface ApplicationContextAware

Throws:

BeansException

connectionFactory

public abstract ConnectionFactory connectionFactory()

Return a R2DBC ConnectionFactory. Annotate with Bean in case you want to expose a ConnectionFactory instance to the ApplicationContext.

Returns:

the configured ConnectionFactory.

getDialect

public R2dbcDialect getDialect(ConnectionFactory connectionFactory)

Return a R2dbcDialect for the given ConnectionFactory. This method attempts to resolve a R2dbcDialect from ConnectionFactoryMetadata. Override this method to specify a dialect instead of attempting to resolve one.

Parameters:

connectionFactory - the configured ConnectionFactory.

Returns:

the resolved R2dbcDialect.

Throws:

UnsupportedOperationException - if the R2dbcDialect cannot be determined.

databaseClient

@Bean
public DatabaseClient databaseClient(ReactiveDataAccessStrategy dataAccessStrategy,
                                           R2dbcExceptionTranslator exceptionTranslator)

Register a DatabaseClient using connectionFactory() and RelationalMappingContext.

Returns:

must not be null.

Throws:

IllegalArgumentException - if any of the required args is null.

r2dbcMappingContext

@Bean
public org.springframework.data.relational.core.mapping.RelationalMappingContext r2dbcMappingContext(Optional<org.springframework.data.relational.core.mapping.NamingStrategy> namingStrategy,
                                                                                                           R2dbcCustomConversions r2dbcCustomConversions)

Register a RelationalMappingContext and apply an optional NamingStrategy.

Parameters:

namingStrategy - optional NamingStrategy. Use NamingStrategy.INSTANCE as fallback.

r2dbcCustomConversions - customized R2DBC conversions.

Returns:

must not be null.

Throws:

IllegalArgumentException - if any of the required args is null.

reactiveDataAccessStrategy

@Bean
public ReactiveDataAccessStrategy reactiveDataAccessStrategy(org.springframework.data.relational.core.mapping.RelationalMappingContext mappingContext,
                                                                   R2dbcCustomConversions r2dbcCustomConversions)

Creates a ReactiveDataAccessStrategy using the configured r2dbcMappingContext(Optional, R2dbcCustomConversions) RelationalMappingContext}.

Parameters:

mappingContext - the configured RelationalMappingContext.

r2dbcCustomConversions - customized R2DBC conversions.

Returns:

must not be null.

Throws:

IllegalArgumentException - if any of the mappingContext is null.

See Also:

r2dbcMappingContext(Optional, R2dbcCustomConversions), getDialect(ConnectionFactory)

r2dbcCustomConversions

@Bean
public R2dbcCustomConversions r2dbcCustomConversions()

Register custom Converters in a CustomConversions object if required. These CustomConversions will be registered with the BasicRelationalConverter and r2dbcMappingContext(Optional, R2dbcCustomConversions). Returns an empty R2dbcCustomConversions instance by default. Override getCustomConverters() to supply custom converters.

Returns:

must not be null.

See Also:

getCustomConverters()

getCustomConverters

protected List<Object> getCustomConverters()

Customization hook to return custom converters.

Returns:

return custom converters.

getStoreConversions

protected CustomConversions.StoreConversions getStoreConversions()

Returns the R2dbcDialect-specific CustomConversions.StoreConversions.

Returns:

the R2dbcDialect-specific CustomConversions.StoreConversions.

exceptionTranslator

@Bean
public R2dbcExceptionTranslator exceptionTranslator()

Creates a R2dbcExceptionTranslator using the configured ConnectionFactory.

Returns:

must not be null.

See Also:

connectionFactory(), R2dbcExceptionSubclassTranslator, SqlStateR2dbcExceptionTranslator