org.springframework.data.r2dbc.repository.config

Annotation Type EnableR2dbcRepositories

@Target(value=TYPE)
 @Retention(value=RUNTIME)
 @Documented
 @Inherited
 @Import(value=org.springframework.data.r2dbc.repository.config.R2dbcRepositoriesRegistrar.class)
public @interface EnableR2dbcRepositories

Annotation to activate reactive relational repositories using R2DBC. If no base package is configured through either value(), basePackages() or basePackageClasses() it will trigger scanning of the package of annotated class.

Author:

Mark Paluch, Christoph Strobl

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Class<?>[]	basePackageClasses Type-safe alternative to basePackages() for specifying the packages to scan for annotated components.
String[]	basePackages Base packages to scan for annotated components.
boolean	considerNestedRepositories Configures whether nested repository-interfaces (e.g. defined as inner classes) should be discovered by the repositories infrastructure.
String	databaseClientRef Deprecated. since 1.2, in favor of entityOperationsRef().
String	entityOperationsRef Configures the name of the R2dbcEntityOperations bean to be used with the repositories detected.
ComponentScan.Filter[]	excludeFilters Specifies which types are not eligible for component scanning.
ComponentScan.Filter[]	includeFilters Specifies which types are eligible for component scanning.
String	namedQueriesLocation Configures the location of where to find the Spring Data named queries properties file.
QueryLookupStrategy.Key	queryLookupStrategy Returns the key of the QueryLookupStrategy to be used for lookup queries for query methods.
Class<?>	repositoryBaseClass Configure the repository base class to be used to create repository proxies for this particular configuration.
Class<?>	repositoryFactoryBeanClass Returns the FactoryBean class to be used for each repository instance.
String	repositoryImplementationPostfix Returns the postfix to be used when looking up custom repository implementations.
String[]	value Alias for the basePackages() attribute.

Element Detail

value

public abstract String[] value

Alias for the basePackages() attribute. Allows for more concise annotation declarations e.g.: @EnableR2dbcRepositories("org.my.pkg") instead of @EnableR2dbcRepositories(basePackages="org.my.pkg").

Default:

{}

basePackages

public abstract String[] basePackages

Base packages to scan for annotated components. value() is an alias for (and mutually exclusive with) this attribute. Use basePackageClasses() for a type-safe alternative to String-based package names.

Default:

{}

basePackageClasses

public abstract Class<?>[] basePackageClasses

Type-safe alternative to basePackages() for specifying the packages to scan for annotated components. The package of each class specified will be scanned. Consider creating a special no-op marker class or interface in each package that serves no purpose other than being referenced by this attribute.

Default:

{}

includeFilters

public abstract ComponentScan.Filter[] includeFilters

Specifies which types are eligible for component scanning. Further narrows the set of candidate components from everything in basePackages() to everything in the base packages that matches the given filter or filters.

Default:

{}

excludeFilters

public abstract ComponentScan.Filter[] excludeFilters

Specifies which types are not eligible for component scanning.

Default:

{}

repositoryImplementationPostfix

public abstract String repositoryImplementationPostfix

Returns the postfix to be used when looking up custom repository implementations. Defaults to Impl. So for a repository named PersonRepository the corresponding implementation class will be looked up scanning for PersonRepositoryImpl.

Returns:

Default:

"Impl"

namedQueriesLocation

public abstract String namedQueriesLocation

Configures the location of where to find the Spring Data named queries properties file. Will default to META-INF/r2dbc-named-queries.properties if not configured otherwise.

Returns:

Default:

""

queryLookupStrategy

public abstract QueryLookupStrategy.Key queryLookupStrategy

Returns the key of the QueryLookupStrategy to be used for lookup queries for query methods. Defaults to QueryLookupStrategy.Key.CREATE_IF_NOT_FOUND.

Returns:

Default:

org.springframework.data.repository.query.QueryLookupStrategy.Key.CREATE_IF_NOT_FOUND

repositoryFactoryBeanClass

public abstract Class<?> repositoryFactoryBeanClass

Returns the FactoryBean class to be used for each repository instance. Defaults to R2dbcRepositoryFactoryBean.

Returns:

Default:

org.springframework.data.r2dbc.repository.support.R2dbcRepositoryFactoryBean.class

repositoryBaseClass

public abstract Class<?> repositoryBaseClass

Configure the repository base class to be used to create repository proxies for this particular configuration.

Returns:

Default:

org.springframework.data.repository.config.DefaultRepositoryBaseClass.class

databaseClientRef

@Deprecated
public abstract String databaseClientRef

Deprecated. since 1.2, in favor of entityOperationsRef().

Configures the name of the DatabaseClient bean to be used with the repositories detected.

Returns:

See Also:

entityOperationsRef()

Default:

""

entityOperationsRef

public abstract String entityOperationsRef

Configures the name of the R2dbcEntityOperations bean to be used with the repositories detected. Used as alternative to databaseClientRef() to configure an access strategy when using repositories with different database systems/dialects. If this attribute is set, then databaseClientRef() is ignored.

Returns:

Since:

1.1.3

Default:

"r2dbcEntityTemplate"

considerNestedRepositories

public abstract boolean considerNestedRepositories

Configures whether nested repository-interfaces (e.g. defined as inner classes) should be discovered by the repositories infrastructure.

Default:

false