Package org.springframework.data.r2dbc.core

Interface R2dbcEntityOperations

All Superinterfaces:

FluentR2dbcOperations, ReactiveDeleteOperation, ReactiveInsertOperation, ReactiveSelectOperation, ReactiveUpdateOperation

All Known Implementing Classes:

R2dbcEntityTemplate

public interface R2dbcEntityOperations
extends FluentR2dbcOperations

Interface specifying a basic set of reactive R2DBC operations using entities. Implemented by R2dbcEntityTemplate. Not often used directly, but a useful option to enhance testability, as it can easily be mocked or stubbed.

Since:

1.1

Author:

Mark Paluch

See Also:

• DatabaseClient

Nested Class Summary

Nested classes/interfaces inherited from interface org.springframework.data.r2dbc.core.ReactiveDeleteOperation

ReactiveDeleteOperation.DeleteWithQuery, ReactiveDeleteOperation.DeleteWithTable, ReactiveDeleteOperation.ReactiveDelete, ReactiveDeleteOperation.TerminatingDelete

Nested classes/interfaces inherited from interface org.springframework.data.r2dbc.core.ReactiveInsertOperation

ReactiveInsertOperation.InsertWithTable<T>, ReactiveInsertOperation.ReactiveInsert<T>, ReactiveInsertOperation.TerminatingInsert<T>

Nested classes/interfaces inherited from interface org.springframework.data.r2dbc.core.ReactiveSelectOperation

ReactiveSelectOperation.ReactiveSelect<T>, ReactiveSelectOperation.SelectWithProjection<T>, ReactiveSelectOperation.SelectWithQuery<T>, ReactiveSelectOperation.SelectWithTable<T>, ReactiveSelectOperation.TerminatingSelect<T>

Nested classes/interfaces inherited from interface org.springframework.data.r2dbc.core.ReactiveUpdateOperation

ReactiveUpdateOperation.ReactiveUpdate, ReactiveUpdateOperation.TerminatingUpdate, ReactiveUpdateOperation.UpdateWithQuery, ReactiveUpdateOperation.UpdateWithTable

Method Summary

Modifier and Type	Method	Description
Mono<Long>	count(Query query, Class<?> entityClass)	Returns the number of rows for the given entity class applying Query.
Mono<Long>	delete(Query query, Class<?> entityClass)	Remove entities (rows)/columns from the table by Query.
<T> Mono<T>	delete(T entity)	Delete the given entity and emit the entity if the delete was applied.
Mono<Boolean>	exists(Query query, Class<?> entityClass)	Determine whether the result for entityClass Query yields at least one row.
R2dbcConverter	getConverter()	Return the underlying R2dbcConverter.
ReactiveDataAccessStrategy	getDataAccessStrategy()	Deprecated. use getConverter() instead as ReactiveDataAccessStrategy will be removed in a future release.
DatabaseClient	getDatabaseClient()	Expose the underlying DatabaseClient to allow SQL operations.
<T> RowsFetchSpec<T>	getRowsFetchSpec(DatabaseClient.GenericExecuteSpec executeSpec, Class<?> entityType, Class<T> resultType)
<T> Mono<T>	insert(T entity)	Insert the given entity and emit the entity if the insert was applied.
<T> RowsFetchSpec<T>	query(PreparedOperation<?> operation, Class<?> entityClass, Class<T> resultType)	Execute a query for a RowsFetchSpec, given PreparedOperation.
<T> RowsFetchSpec<T>	query(PreparedOperation<?> operation, Class<?> entityClass, BiFunction<io.r2dbc.spi.Row,io.r2dbc.spi.RowMetadata,T> rowMapper)	Execute a query for a RowsFetchSpec in the context of entityClass, given PreparedOperation.
default <T> RowsFetchSpec<T>	query(PreparedOperation<?> operation, Class<?> entityClass, Function<io.r2dbc.spi.Row,T> rowMapper)	Execute a query for a RowsFetchSpec in the context of entityClass, given PreparedOperation.
<T> RowsFetchSpec<T>	query(PreparedOperation<?> operation, Class<T> entityClass)	Execute a query for a RowsFetchSpec, given PreparedOperation.
<T> RowsFetchSpec<T>	query(PreparedOperation<?> operation, BiFunction<io.r2dbc.spi.Row,io.r2dbc.spi.RowMetadata,T> rowMapper)	Execute a query for a RowsFetchSpec, given PreparedOperation.
default <T> RowsFetchSpec<T>	query(PreparedOperation<?> operation, Function<io.r2dbc.spi.Row,T> rowMapper)	Execute a query for a RowsFetchSpec, given PreparedOperation.
<T> Flux<T>	select(Query query, Class<T> entityClass)	Execute a SELECT query and convert the resulting items to a stream of entities.
<T> Mono<T>	selectOne(Query query, Class<T> entityClass)	Execute a SELECT query and convert the resulting item to an entity ensuring exactly one result.
Mono<Long>	update(Query query, Update update, Class<?> entityClass)	Update the queried entities and return true if the update was applied.
<T> Mono<T>	update(T entity)	Update the given entity and emit the entity if the update was applied.

Methods inherited from interface org.springframework.data.r2dbc.core.ReactiveDeleteOperation

delete

Methods inherited from interface org.springframework.data.r2dbc.core.ReactiveInsertOperation

insert

Methods inherited from interface org.springframework.data.r2dbc.core.ReactiveSelectOperation

select

Methods inherited from interface org.springframework.data.r2dbc.core.ReactiveUpdateOperation

update

Method Details

getDatabaseClient

DatabaseClient getDatabaseClient()

Expose the underlying DatabaseClient to allow SQL operations.

Returns:

the underlying DatabaseClient.

See Also:

• DatabaseClient

getDataAccessStrategy

@Deprecated
ReactiveDataAccessStrategy getDataAccessStrategy()

Deprecated.

use getConverter() instead as ReactiveDataAccessStrategy will be removed in a future release.

Expose the underlying ReactiveDataAccessStrategy encapsulating dialect specifics.

Returns:

the underlying ReactiveDataAccessStrategy.

Since:

1.1.3

See Also:

• ReactiveDataAccessStrategy

getConverter

R2dbcConverter getConverter()

Return the underlying R2dbcConverter.

Returns:

the underlying R2dbcConverter.

Since:

1.2

count

Mono<Long> count(Query query,
 Class<?> entityClass)
          throws DataAccessException

Returns the number of rows for the given entity class applying Query. This overridden method allows users to further refine the selection Query using a Query predicate to determine how many entities of the given type match the Query.

Parameters:

query - user-defined count Query to execute; must not be null.

entityClass - type of the entity; must not be null.

Returns:

the number of existing entities.

Throws:

DataAccessException - if any problem occurs while executing the query.

exists

Mono<Boolean> exists(Query query,
 Class<?> entityClass)
              throws DataAccessException

Determine whether the result for entityClass Query yields at least one row.

Parameters:

query - user-defined exists Query to execute; must not be null.

entityClass - type of the entity; must not be null.

Returns:

true if the object exists.

Throws:

DataAccessException - if any problem occurs while executing the query.

Since:

2.1

select

<T> Flux<T> select(Query query,
 Class<T> entityClass)
            throws DataAccessException

Execute a SELECT query and convert the resulting items to a stream of entities.

Parameters:

query - must not be null.

entityClass - the entity type must not be null.

Returns:

the result objects returned by the action.

Throws:

DataAccessException - if there is any problem issuing the execution.

selectOne

<T> Mono<T> selectOne(Query query,
 Class<T> entityClass)
               throws DataAccessException

Execute a SELECT query and convert the resulting item to an entity ensuring exactly one result.

Parameters:

query - must not be null.

entityClass - the entity type must not be null.

Returns:

exactly one result or Mono.empty() if no match found.

Throws:

IncorrectResultSizeDataAccessException - if more than one match found.

DataAccessException - if there is any problem issuing the execution.

update

Mono<Long> update(Query query,
 Update update,
 Class<?> entityClass)
           throws DataAccessException

Update the queried entities and return true if the update was applied.

Parameters:

query - must not be null.

update - must not be null.

entityClass - the entity type must not be null.

Returns:

the number of affected rows.

Throws:

DataAccessException - if there is any problem executing the query.

delete

Mono<Long> delete(Query query,
 Class<?> entityClass)
           throws DataAccessException

Remove entities (rows)/columns from the table by Query.

Parameters:

query - must not be null.

entityClass - the entity type must not be null.

Returns:

the number of affected rows.

Throws:

DataAccessException - if there is any problem issuing the execution.

query

<T> RowsFetchSpec<T> query(PreparedOperation<?> operation,
 Class<T> entityClass)
                    throws DataAccessException

Execute a query for a RowsFetchSpec, given PreparedOperation. Any provided bindings within PreparedOperation are applied to the underlying DatabaseClient. The query is issued as-is without additional pre-processing such as named parameter expansion. Results of the query are mapped onto entityClass.

Parameters:

operation - the prepared operation wrapping a SQL query and bind parameters.

entityClass - the entity type must not be null.

Returns:

a RowsFetchSpec ready to materialize.

Throws:

DataAccessException - if there is any problem issuing the execution.

Since:

1.4

query

<T> RowsFetchSpec<T> query(PreparedOperation<?> operation,
 Class<?> entityClass,
 Class<T> resultType)
                    throws DataAccessException

Execute a query for a RowsFetchSpec, given PreparedOperation. Any provided bindings within PreparedOperation are applied to the underlying DatabaseClient. The query is issued as-is without additional pre-processing such as named parameter expansion. Results of the query are mapped onto entityClass.

Parameters:

operation - the prepared operation wrapping a SQL query and bind parameters.

entityClass - the entity type must not be null.

resultType - the returned entity, type must not be null.

Returns:

a RowsFetchSpec ready to materialize.

Throws:

DataAccessException - if there is any problem issuing the execution.

Since:

3.2.1

query

default <T> RowsFetchSpec<T> query(PreparedOperation<?> operation,
 Function<io.r2dbc.spi.Row,T> rowMapper)
                            throws DataAccessException

Execute a query for a RowsFetchSpec, given PreparedOperation. Any provided bindings within PreparedOperation are applied to the underlying DatabaseClient. The query is issued as-is without additional pre-processing such as named parameter expansion. Results of the query are mapped using rowMapper.

Parameters:

operation - the prepared operation wrapping a SQL query and bind parameters.

rowMapper - the row mapper must not be null.

Returns:

a RowsFetchSpec with rowMapper applied ready to materialize.

Throws:

DataAccessException - if there is any problem issuing the execution.

Since:

1.4

See Also:

• query(PreparedOperation, BiFunction)

query

<T> RowsFetchSpec<T> query(PreparedOperation<?> operation,
 BiFunction<io.r2dbc.spi.Row,io.r2dbc.spi.RowMetadata,T> rowMapper)
                    throws DataAccessException

Execute a query for a RowsFetchSpec, given PreparedOperation. Any provided bindings within PreparedOperation are applied to the underlying DatabaseClient. The query is issued as-is without additional pre-processing such as named parameter expansion. Results of the query are mapped using rowMapper.

Parameters:

operation - the prepared operation wrapping a SQL query and bind parameters.

rowMapper - the row mapper must not be null.

Returns:

a RowsFetchSpec with rowMapper applied ready to materialize.

Throws:

DataAccessException - if there is any problem issuing the execution.

Since:

1.4

query

default <T> RowsFetchSpec<T> query(PreparedOperation<?> operation,
 Class<?> entityClass,
 Function<io.r2dbc.spi.Row,T> rowMapper)
                            throws DataAccessException

Execute a query for a RowsFetchSpec in the context of entityClass, given PreparedOperation. Any provided bindings within PreparedOperation are applied to the underlying DatabaseClient. The query is issued as-is without additional pre-processing such as named parameter expansion. Results of the query are mapped using rowMapper.

Parameters:

operation - the prepared operation wrapping a SQL query and bind parameters.

entityClass - the entity type must not be null.

rowMapper - the row mapper must not be null.

Returns:

a RowsFetchSpec with rowMapper applied ready to materialize.

Throws:

DataAccessException - if there is any problem issuing the execution.

Since:

1.4

See Also:

• query(PreparedOperation, Class, BiFunction)

query

<T> RowsFetchSpec<T> query(PreparedOperation<?> operation,
 Class<?> entityClass,
 BiFunction<io.r2dbc.spi.Row,io.r2dbc.spi.RowMetadata,T> rowMapper)
                    throws DataAccessException

Execute a query for a RowsFetchSpec in the context of entityClass, given PreparedOperation. Any provided bindings within PreparedOperation are applied to the underlying DatabaseClient. The query is issued as-is without additional pre-processing such as named parameter expansion. Results of the query are mapped using rowMapper.

Parameters:

operation - the prepared operation wrapping a SQL query and bind parameters.

entityClass - the entity type must not be null.

rowMapper - the row mapper must not be null.

Returns:

a RowsFetchSpec with rowMapper applied ready to materialize.

Throws:

DataAccessException - if there is any problem issuing the execution.

Since:

1.4

See Also:

• query(PreparedOperation, Class, BiFunction)

getRowsFetchSpec

<T> RowsFetchSpec<T> getRowsFetchSpec(DatabaseClient.GenericExecuteSpec executeSpec,
 Class<?> entityType,
 Class<T> resultType)

insert

<T> Mono<T> insert(T entity)
            throws DataAccessException

Insert the given entity and emit the entity if the insert was applied.

Parameters:

entity - the entity to insert, must not be null.

Returns:

the inserted entity.

Throws:

DataAccessException - if there is any problem issuing the execution.

update

<T> Mono<T> update(T entity)
            throws DataAccessException

Update the given entity and emit the entity if the update was applied.

Parameters:

entity - the entity to update, must not be null.

Returns:

the updated entity.

Throws:

DataAccessException - if there is any problem issuing the execution.

TransientDataAccessResourceException - if the update did not affect any rows.

delete

<T> Mono<T> delete(T entity)
            throws DataAccessException

Delete the given entity and emit the entity if the delete was applied.

Parameters:

entity - must not be null.

Returns:

the deleted entity.

Throws:

DataAccessException - if there is any problem issuing the execution.