Module spring.data.cassandra

Package org.springframework.data.cassandra.core.cql.support

Class CachedPreparedStatementCreator

java.lang.Object

org.springframework.data.cassandra.core.cql.support.CachedPreparedStatementCreator

All Implemented Interfaces:

PreparedStatementCreator

@Deprecated(forRemoval=true)
public class CachedPreparedStatementCreator
extends Object
implements PreparedStatementCreator

Deprecated, for removal: This API element is subject to removal in a future version.

since 3.2, the Cassandra driver has a built-in prepared statement cache with makes external caching of prepared statements superfluous.

PreparedStatementCreator implementation using caching of prepared statements.

Regular CQL statements are prepared on first use and executed as prepared statements. Prepared statements are cached by Cassandra itself (invalidation/eviction possible), in the driver to be able to re-prepare a statement and in this CachedPreparedStatementCreator using PreparedStatementCache.

Since:

2.0

Author:

Mark Paluch

See Also:

• PreparedStatementCache

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CachedPreparedStatementCreator(PreparedStatementCache cache, com.datastax.oss.driver.api.core.cql.SimpleStatement statement)	Deprecated, for removal: This API element is subject to removal in a future version. Create a new CachedPreparedStatementCreator.

Method Summary

Modifier and Type	Method	Description
com.datastax.oss.driver.api.core.cql.PreparedStatement	createPreparedStatement(com.datastax.oss.driver.api.core.CqlSession session)	Deprecated, for removal: This API element is subject to removal in a future version. Create a statement in this session.
PreparedStatementCache	getCache()	Deprecated, for removal: This API element is subject to removal in a future version.
static CachedPreparedStatementCreator	of(PreparedStatementCache cache, com.datastax.oss.driver.api.core.cql.SimpleStatement statement)	Deprecated, for removal: This API element is subject to removal in a future version. Create a new CachedPreparedStatementCreator given PreparedStatementCache and SimpleStatement to prepare.
static CachedPreparedStatementCreator	of(PreparedStatementCache cache, String cql)	Deprecated, for removal: This API element is subject to removal in a future version. Create a new CachedPreparedStatementCreator given PreparedStatementCache and cql to prepare.
static CachedPreparedStatementCreator	of(PreparedStatementCache cache, String cql, QueryOptions queryOptions)	Deprecated, for removal: This API element is subject to removal in a future version. Create a new CachedPreparedStatementCreator given PreparedStatementCache and cql to prepare.

Methods inherited from class java.lang.Object

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

Constructor Details

CachedPreparedStatementCreator

protected CachedPreparedStatementCreator(PreparedStatementCache cache,
 com.datastax.oss.driver.api.core.cql.SimpleStatement statement)

Deprecated, for removal: This API element is subject to removal in a future version.

Create a new CachedPreparedStatementCreator.

Parameters:

cache - must not be null.

statement - must not be null.

Method Details

of

public static CachedPreparedStatementCreator of(PreparedStatementCache cache,
 com.datastax.oss.driver.api.core.cql.SimpleStatement statement)

Deprecated, for removal: This API element is subject to removal in a future version.

Create a new CachedPreparedStatementCreator given PreparedStatementCache and SimpleStatement to prepare. Subsequent calls require the given SimpleStatement object with the same CQL test for a cache hit. Otherwise, the statement is likely to be re-prepared.

Parameters:

cache - must not be null.

statement - must not be null.

Returns:

the CachedPreparedStatementCreator for Statement.

of

public static CachedPreparedStatementCreator of(PreparedStatementCache cache,
 String cql)

Deprecated, for removal: This API element is subject to removal in a future version.

Create a new CachedPreparedStatementCreator given PreparedStatementCache and cql to prepare. Subsequent calls require the given CQL statement that are equal to the previously used CQL string for a cache hit. Otherwise, the statement is likely to be re-prepared.

Parameters:

cache - must not be null.

cql - must not be null or empty.

Returns:

the CachedPreparedStatementCreator for cql.

of

public static CachedPreparedStatementCreator of(PreparedStatementCache cache,
 String cql,
 QueryOptions queryOptions)

Deprecated, for removal: This API element is subject to removal in a future version.

Create a new CachedPreparedStatementCreator given PreparedStatementCache and cql to prepare. This method applies QueryOptions to the SimpleStatement before preparing it. Subsequent calls require the given CQL statement that are equal to the previously used CQL string for a cache hit. Otherwise, the statement is likely to be re-prepared.

Parameters:

cache - must not be null.

cql - must not be null or empty.

queryOptions - must not be null.

Returns:

the CachedPreparedStatementCreator for cql.

getCache

public PreparedStatementCache getCache()

Deprecated, for removal: This API element is subject to removal in a future version.

Returns:

the underlying PreparedStatementCache.

createPreparedStatement

public com.datastax.oss.driver.api.core.cql.PreparedStatement createPreparedStatement(com.datastax.oss.driver.api.core.CqlSession session)
                                                                               throws com.datastax.oss.driver.api.core.DriverException

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from interface: PreparedStatementCreator

Create a statement in this session. Allows implementations to use PreparedStatement.

Specified by:

createPreparedStatement in interface PreparedStatementCreator

Parameters:

session - CqlSession to use to create statement.

Returns:

a prepared statement.

Throws:

com.datastax.oss.driver.api.core.DriverException - there is no need to catch DriverException that may be thrown in the implementation of this method. The CqlTemplate class will handle them.