此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Data Cassandra 4.4.0！spring-doc.cn

准备好的语句

可以准备多次执行的 CQL 语句并将其存储在一个对象中，以提高查询性能。 驱动程序和 Cassandra 都维护查询到其元数据的映射。 您可以通过以下抽象来使用准备好的语句：PreparedStatementPreparedStatementspring-doc.cn

用CqlTemplate

该类（及其异步和反应式变体）提供了各种方法，这些方法接受静态 CQL、对象和 . 接受不带其他参数的静态 CQL 的方法通常按原样运行 CQL 语句，而无需进一步处理。 接受静态 CQL 与 arguments 数组（例如 和 ）组合的方法使用准备好的语句。 在内部，这些方法创建一个 and 对象来准备语句，然后将值绑定到语句以运行它。 Spring Data Cassandra 通常对准备好的语句使用基于索引的参数绑定。CqlTemplateStatementPreparedStatementCreatorexecute(String cql, Object…​ args)queryForRows(String cql, Object…​ args)PreparedStatementCreatorPreparedStatementBinderspring-doc.cn

从 Cassandra Driver 版本 4 开始，准备好的语句缓存在驱动程序级别，这样就无需在应用程序中跟踪准备好的语句。spring-doc.cn

以下示例显示了如何使用参数化的准备好的语句发出查询：spring-doc.cn

String lastName = cqlTemplate.queryForObject(
		"SELECT last_name FROM t_actor WHERE id = ?",
		String.class, 1212L);
Mono<String> lastName = reactiveCqlTemplate.queryForObject(
	"SELECT last_name FROM t_actor WHERE id = ?",
	String.class, 1212L);

在需要对语句准备和参数绑定进行更多控制（例如，使用命名绑定参数）的情况下，可以通过使用 和 arguments 调用查询方法来完全控制准备好的语句创建和参数绑定：PreparedStatementCreatorPreparedStatementBinderspring-doc.cn

List<String> lastNames = cqlTemplate.query(
		session -> session.prepare("SELECT last_name FROM t_actor WHERE id = ?"),
		ps -> ps.bind(1212L),
		(row, rowNum) -> row.getString(0));
Flux<String> lastNames = reactiveCqlTemplate.query(
		session -> session.prepare("SELECT last_name FROM t_actor WHERE id = ?"),
		ps -> ps.bind(1212L),
		(row, rowNum) -> row.getString(0));

Spring Data Cassandra 在包中附带了支持该模式的类：cqlspring-doc.cn

  • SimplePreparedStatementCreator- 实用程序类来创建准备好的语句。spring-doc.cn

  • ArgumentPreparedStatementBinder- 实用程序类，用于将参数绑定到准备好的语句。spring-doc.cn

用CassandraTemplate

该类构建在 之上，以提供更高级别的抽象。 通过调用相应的 . 请注意，默认情况下，使用准备好的语句 by 是启用的。CassandraTemplateCqlTemplateCassandraTemplatesetUsePreparedStatements(false)setUsePreparedStatements(true)CassandraTemplatespring-doc.cn

以下示例显示了生成和接受 CQL 的方法的用法：spring-doc.cn

template.setUsePreparedStatements(true);

Actor actorByQuery = template.selectOne(query(where("id").is(42)), Actor.class);

Actor actorByStatement = template.selectOne(
		SimpleStatement.newInstance("SELECT id, name FROM actor WHERE id = ?", 42),
		Actor.class);
template.setUsePreparedStatements(true);

Mono<Actor> actorByQuery = template.selectOne(query(where("id").is(42)), Actor.class);

Mono<Actor> actorByStatement = template.selectOne(
		SimpleStatement.newInstance("SELECT id, name FROM actor WHERE id = ?", 42),
		Actor.class);

调用实体绑定方法（例如 或 构建 CQL 语句）本身来执行预期的操作。 某些方法（例如 ）也接受 CQL 对象作为其 API 的一部分。select(Query, Class<T>)update(Query, Update, Class<T>)CassandraTemplateselect(Statement<?>, Class<T>)Statementspring-doc.cn

在调用接受 a with a 对象的方法时，可以参与准备好的语句。 模板 API 提取查询字符串和参数（位置参数和命名参数），并使用它们来准备、绑定和运行语句。 Non- 对象不能与准备好的语句一起使用。StatementSimpleStatementSimpleStatementspring-doc.cn

缓存准备好的语句

从 Cassandra 驱动程序 4.0 开始，准备好的语句由缓存缓存，因此可以准备相同的字符串两次。 以前的版本需要在驱动程序之外缓存准备好的语句。 另请参阅 Driver 文档中的 Prepared Statements 以进一步参考。CqlSessionspring-doc.cn