org.springframework.data.cassandra.core

Interface ReactiveCassandraOperations

All Known Implementing Classes:

ReactiveCassandraTemplate

public interface ReactiveCassandraOperations

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

Since:

2.0

Author:

Mark Paluch

See Also:

ReactiveCassandraTemplate, ReactiveCqlOperations, Statement, InsertOptions, UpdateOptions, Flux, Mono

Method Summary

Modifier and Type	Method and Description
reactor.core.publisher.Mono<Long>	count(Class<?> entityClass) Returns the number of rows for the given entity class.
reactor.core.publisher.Mono<WriteResult>	delete(Object entity, QueryOptions options) Delete the given entity applying QueryOptions and emit the entity if the delete was applied.
reactor.core.publisher.Mono<Boolean>	delete(Query query, Class<?> entityClass) Remove entities (rows)/columns from the table by Query.
<T> reactor.core.publisher.Mono<T>	delete(T entity) Delete the given entity and emit the entity if the delete was applied.
reactor.core.publisher.Mono<Boolean>	deleteById(Object id, Class<?> entityClass) Remove the given object from the table by id.
reactor.core.publisher.Mono<Boolean>	exists(Object id, Class<?> entityClass) Determine whether the row entityClass with the given id exists.
CassandraConverter	getConverter() Returns the underlying CassandraConverter.
ReactiveCqlOperations	getReactiveCqlOperations() Expose the underlying ReactiveCqlOperations to allow CQL operations.
reactor.core.publisher.Mono<WriteResult>	insert(Object entity, InsertOptions options) Insert the given entity applying WriteOptions and emit the entity if the insert was applied.
<T> reactor.core.publisher.Mono<T>	insert(T entity) Insert the given entity and emit the entity if the insert was applied.
<T> reactor.core.publisher.Flux<T>	select(Query query, Class<T> entityClass) Execute a SELECT query and convert the resulting items to a stream of entities.
<T> reactor.core.publisher.Flux<T>	select(com.datastax.driver.core.Statement statement, Class<T> entityClass) Execute a SELECT query and convert the resulting items to a stream of entities.
<T> reactor.core.publisher.Flux<T>	select(String cql, Class<T> entityClass) Execute a SELECT query and convert the resulting items to a stream of entities.
<T> reactor.core.publisher.Mono<T>	selectOne(Query query, Class<T> entityClass) Execute a SELECT query and convert the resulting item to an entity.
<T> reactor.core.publisher.Mono<T>	selectOne(com.datastax.driver.core.Statement statement, Class<T> entityClass) Execute a SELECT query and convert the resulting item to an entity.
<T> reactor.core.publisher.Mono<T>	selectOne(String cql, Class<T> entityClass) Execute a SELECT query and convert the resulting item to an entity.
<T> reactor.core.publisher.Mono<T>	selectOneById(Object id, Class<T> entityClass) Execute the Select by id for the given entityClass.
reactor.core.publisher.Mono<Void>	truncate(Class<?> entityClass) Execute a TRUNCATE query to remove all entities of a given class.
reactor.core.publisher.Mono<WriteResult>	update(Object entity, UpdateOptions options) Update the given entity applying WriteOptions and emit the entity if the update was applied.
reactor.core.publisher.Mono<Boolean>	update(Query query, Update update, Class<?> entityClass) Update the queried entities and return true if the update was applied.
<T> reactor.core.publisher.Mono<T>	update(T entity) Update the given entity and emit the entity if the update was applied.

Method Detail

getConverter

CassandraConverter getConverter()

Returns the underlying CassandraConverter.

Returns:

the underlying CassandraConverter.

getReactiveCqlOperations

ReactiveCqlOperations getReactiveCqlOperations()

Expose the underlying ReactiveCqlOperations to allow CQL operations.

Returns:

the underlying ReactiveCqlOperations.

See Also:

ReactiveCqlOperations

select

<T> reactor.core.publisher.Flux<T> select(String cql,
                                          Class<T> entityClass)
                                   throws DataAccessException

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

Parameters:

cql - must not be null.

entityClass - The entity type must not be null.

Returns:

the converted results

Throws:

DataAccessException - if there is any problem issuing the execution.

selectOne

<T> reactor.core.publisher.Mono<T> selectOne(String cql,
                                             Class<T> entityClass)
                                      throws DataAccessException

Execute a SELECT query and convert the resulting item to an entity.

Parameters:

cql - must not be null.

entityClass - The entity type must not be null.

Returns:

the result object returned by the action or Mono.empty()

Throws:

DataAccessException - if there is any problem issuing the execution.

select

<T> reactor.core.publisher.Flux<T> select(com.datastax.driver.core.Statement statement,
                                          Class<T> entityClass)
                                   throws DataAccessException

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

Parameters:

statement - 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> reactor.core.publisher.Mono<T> selectOne(com.datastax.driver.core.Statement statement,
                                             Class<T> entityClass)
                                      throws DataAccessException

Execute a SELECT query and convert the resulting item to an entity.

Parameters:

statement - must not be null.

entityClass - The entity type must not be null.

Returns:

the result object returned by the action or Mono.empty()

Throws:

DataAccessException - if there is any problem issuing the execution.

select

<T> reactor.core.publisher.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> reactor.core.publisher.Mono<T> selectOne(Query query,
                                             Class<T> entityClass)
                                      throws DataAccessException

Execute a SELECT query and convert the resulting item to an entity.

Parameters:

query - must not be null.

entityClass - The entity type must not be null.

Returns:

the result object returned by the action or Mono.empty()

Throws:

DataAccessException - if there is any problem issuing the execution.

update

reactor.core.publisher.Mono<Boolean> 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.

Throws:

DataAccessException - if there is any problem executing the query.

delete

reactor.core.publisher.Mono<Boolean> 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:

true if the deletion was applied.

Throws:

DataAccessException - if there is any problem issuing the execution.

count

reactor.core.publisher.Mono<Long> count(Class<?> entityClass)
                                 throws DataAccessException

Returns the number of rows for the given entity class.

Parameters:

entityClass - must not be null.

Returns:

the number of existing entities.

Throws:

DataAccessException - if there is any problem issuing the execution.

exists

reactor.core.publisher.Mono<Boolean> exists(Object id,
                                            Class<?> entityClass)
                                     throws DataAccessException

Determine whether the row entityClass with the given id exists.

Parameters:

id - the Id value. For single primary keys it's the plain value. For composite primary keys either the PrimaryKeyClass or MapId. Must not be null.

entityClass - must not be null.

Returns:

true if the object exists.

Throws:

DataAccessException - if there is any problem issuing the execution.

selectOneById

<T> reactor.core.publisher.Mono<T> selectOneById(Object id,
                                                 Class<T> entityClass)
                                          throws DataAccessException

Execute the Select by id for the given entityClass.

Parameters:

id - the Id value. For single primary keys it's the plain value. For composite primary keys either the PrimaryKeyClass or MapId. Must not be null.

entityClass - The entity type must not be null.

Returns:

the result object returned by the action or Mono.empty()

Throws:

DataAccessException - if there is any problem issuing the execution.

insert

<T> reactor.core.publisher.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.

insert

reactor.core.publisher.Mono<WriteResult> insert(Object entity,
                                                InsertOptions options)
                                         throws DataAccessException

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

Parameters:

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

options - must not be null.

Returns:

the WriteResult for this operation.

Throws:

DataAccessException - if there is any problem issuing the execution.

See Also:

InsertOptions.empty()

update

<T> reactor.core.publisher.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.

update

reactor.core.publisher.Mono<WriteResult> update(Object entity,
                                                UpdateOptions options)
                                         throws DataAccessException

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

Parameters:

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

options - must not be null.

Returns:

the WriteResult for this operation.

Throws:

DataAccessException - if there is any problem issuing the execution.

See Also:

UpdateOptions.empty()

delete

<T> reactor.core.publisher.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.

delete

reactor.core.publisher.Mono<WriteResult> delete(Object entity,
                                                QueryOptions options)
                                         throws DataAccessException

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

Parameters:

entity - must not be null.

options - must not be null.

Returns:

the WriteResult for this operation.

Throws:

DataAccessException - if there is any problem issuing the execution.

See Also:

QueryOptions.empty()

deleteById

reactor.core.publisher.Mono<Boolean> deleteById(Object id,
                                                Class<?> entityClass)
                                         throws DataAccessException

Remove the given object from the table by id.

Parameters:

id - the Id value. For single primary keys it's the plain value. For composite primary keys either the PrimaryKeyClass or MapId. Must not be null.

entityClass - The entity type must not be null.

Returns:

true if the deletion was applied.

Throws:

DataAccessException - if there is any problem issuing the execution.

truncate

reactor.core.publisher.Mono<Void> truncate(Class<?> entityClass)
                                    throws DataAccessException

Execute a TRUNCATE query to remove all entities of a given class.

Parameters:

entityClass - The entity type must not be null.

Throws:

DataAccessException - if there is any problem issuing the execution.