9.8.1.实例化 CassandraTemplate

CassandraTemplate应该始终配置为 Spring bean，尽管我们之前展示了一个示例，您可以在其中直接实例化它。但是，因为我们假设了创建 Spring 模块的上下文，所以我们假设存在 Spring 容器。

有两种方法可以获取 a CassandraTemplate，具体取决于您加载 Spring 的方式ApplicationContext：

• 自动装配

• Bean 查找 ApplicationContext

自动装配

您可以将 a 自动装配CassandraOperations到您的项目中，如以下示例所示：

@Autowiredprivate CassandraOperations cassandraOperations;

同所有的Spring自动装配，这是假定只有一种类型的豆CassandraOperations中ApplicationContext。如果您有多个CassandraTemplatebean（如果您在同一个项目中使用多个键空间就是这种情况），那么您可以使用@Qualifier注释来指定要自动装配的 bean。

@Autowired@Qualifier("keyspaceOneTemplateBeanId")
private CassandraOperations cassandraOperations;

Bean 查找ApplicationContext

您还可以CassandraTemplate从 中查找bean ApplicationContext，如以下示例所示：

CassandraOperations cassandraOperations = applicationContext.getBean("cassandraTemplate", CassandraOperations.class);

9.9.保存、更新和删除行

CassandraTemplate 为您提供了一种简单的方法来保存、更新和删除域对象并将这些对象映射到 Cassandra 中管理的表。

9.9.1.类型映射

Spring Data for Apache Cassandra 依赖于 DataStax Java 驱动程序CodecRegistry来确保类型支持。随着类型的添加或更改，Apache Cassandra 模块的 Spring Data 继续运行而无需更改。有关当前类型映射矩阵，请参阅CQL 数据类型 和“数据映射和类型转换”。

9.9.2.插入和更新行的方法

CassandraTemplate有几种方便的方法来保存和插入您的对象。要对转换过程进行更细粒度的控制，您可以Converter使用MappingCassandraConverter （例如，Converter<Row, Person>）注册 Spring实例。

插入和更新操作的区别在于INSERT操作不插入null值。

使用该INSERT操作的简单案例是保存一个 POJO。在这种情况下，表名由简单的类名（而不是完全限定的类名）确定。可以使用映射元数据覆盖存储对象的表。

插入或更新时，id必须设置该属性。Apache Cassandra 无法生成 ID。

以下示例使用保存操作并检索其内容：

示例 64. 使用 CassandraTemplate

import static org.springframework.data.cassandra.core.query.Criteria.where;import static org.springframework.data.cassandra.core.query.Query.query;
…

Person bob = new Person("Bob", 33);
cassandraTemplate.insert(bob);

Person queriedBob = cassandraTemplate.selectOneById(query(where("age").is(33)), Person.class);

您可以使用以下操作进行插入和保存：

• void insert (Object objectToSave)：在 Apache Cassandra 表中插入对象。

• WriteResult 插入 (Object objectToSave, InsertOptions options)：在 Apache Cassandra 表中插入对象并应用InsertOptions。

您可以使用以下更新操作：

• void update (Object objectToSave)：更新 Apache Cassandra 表中的对象。

• WriteResult 更新 (Object objectToSave, UpdateOptions options)：更新 Apache Cassandra 表中的对象并应用UpdateOptions。

您还可以使用老式的方式编写自己的 CQL 语句，如下例所示：

String cql = "INSERT INTO person (age, name) VALUES (39, 'Bob')";

cassandraTemplate().getCqlOperations().execute(cql);

您还可以在使用InsertOptions和时配置其他选项，例如 TTL、一致性级别和轻量级事务UpdateOptions。

我的行插入到哪个表中？

您可以通过两种方式管理用于对表进行操作的表名。默认表名是更改为以小写字母开头的简单类名。因此，com.example.Person类的一个实例将存储在person表中。第二种方式是在@Table注解中指定表名。

批量插入、更新和删除单个对象

Cassandra 协议支持使用批处理在一个操作中插入一组行。

CassandraTemplate接口中的以下方法支持此功能：

• batchOps：创建一个新CassandraBatchOperations的填充批次。

CassandraBatchOperations

• insert: 接受单个对象、数组 (var-args) 或Iterable要插入的对象。

• update: 接受单个对象、数组 (var-args) 或Iterable要更新的对象。

• delete: 接受单个对象、数组 (var-args) 或Iterable要删除的对象。

• withTimestamp：对批次应用 TTL。

• execute: 执行批处理。

9.9.3.更新表中的行

对于更新，您可以选择更新多行。

以下示例显示了通过向具有+分配的余额添加一次性 50.00 美元奖金来更新单个帐户对象：

示例 65. 使用更新行 CasandraTemplate

import static org.springframework.data.cassandra.core.query.Criteria.where;import org.springframework.data.cassandra.core.query.Query;import org.springframework.data.cassandra.core.query.Update;

…

boolean applied = cassandraTemplate.update(Query.query(where("id").is("foo")),
  Update.create().increment("balance", 50.00), Account.class);

除了Query前面讨论的之外，我们还通过使用Update对象来提供更新定义。该Update班有匹配可用的Apache Cassandra的更新任务，从而方法。

大多数方法返回Update对象以提供用于代码样式目的的流畅 API。

对行执行更新的方法

update方法可以更新行，如下：

• boolean update (Query query, Update update, Class<?> entityClass)：更新 Apache Cassandra 表中的对象选择。

Update 类的方法

本Update类可以用一点点“语法糖”被使用，因为它的方法是为了链接在一起。此外，您可以使用静态Update方法public static Update update(String key, Object value)和使用静态导入来启动新实例的创建。

该Update班有以下方法：

• AddToBuilder 添加到 (String columnName) AddToBuilder入口点：更新prepend(Object value)：使用+更新分配将集合值预先添加到现有集合。更新prependAll(Object… values)：使用+更新分配将所有集合值添加到现有集合中。更新append(Object value)：使用+更新分配将集合值附加到现有集合。更新append(Object… values)：使用+更新分配将所有集合值附加到现有集合。更新entry(Object key, Object value)：使用+更新分配添加地图条目。更新addAll(Map<? extends Object, ? extends Object> map)：使用+更新分配将所有地图条目添加到地图。

• Update remove (String columnName, Object value)：使用-更新分配从集合中删除值。

• Update clear (String columnName) : 清除集合。

• Update increment (String columnName, Number delta)：使用+更新分配进行更新。

• Update decrement (String columnName, Number delta)：使用-更新分配进行更新。

• Update set (String columnName, Object value)：使用=更新分配进行更新。

• SetBuilder 设置 (String columnName) SetBuilder入口点：更新atIndex(int index).to(Object value)：使用=更新分配将给定索引处的集合设置为一个值。更新atKey(String object).to(Object value)：将给定键处的映射条目设置为=更新分配的值。

以下清单显示了一些更新示例：

// UPDATE … SET key = 'Spring Data';
Update.update("key", "Spring Data")

// UPDATE … SET key[5] = 'Spring Data';
Update.empty().set("key").atIndex(5).to("Spring Data");

// UPDATE … SET key = key + ['Spring', 'DATA'];
Update.empty().addTo("key").appendAll("Spring", "Data");

请注意，Update一旦创建，它就是不可变的。调用方法会创建新的不可变（中间）Update对象。

9.9.4.删除行的方法

您可以使用以下重载方法从数据库中删除对象：

• boolean 删除 (Query query, Class<?> entityClass)：删除由 选择的对象Query。

• T delete (T entity) : 删除给定的对象。

• T delete (T entity, QueryOptions queryOptions)：删除给定的对象应用QueryOptions。

• boolean deleteById (Object id, Class<?> entityClass)：使用给定的 Id 删除对象。

9.9.5.乐观锁定

该@Version注释在 Cassandra 的上下文中提供类似于 JPA 的语法，并确保更新仅应用于具有匹配版本的行。乐观锁利用 Cassandra 的轻量级事务来有条件地插入、更新和删除行。因此，INSERT语句是在IF NOT EXISTS条件下执行的。对于更新和删除，版本属性的实际值被添加到UPDATE条件中，这样如果在此期间另一个操作更改了行，则修改不会产生任何影响。在这种情况下，
OptimisticLockingFailureException会抛出an 。以下示例显示了这些功能：

@Tableclass Person {  @Id String id;
  String firstname;
  String lastname;  @Version Long version;
}

Person daenerys = template.insert(new Person("Daenerys"));                            

Person tmp = template.findOne(query(where("id").is(daenerys.getId())), Person.class); daenerys.setLastname("Targaryen");
template.save(daenerys);                                                              

template.save(tmp); // throws OptimisticLockingFailureException

最初插入文档。version设置为0。

加载刚刚插入的文档。version还在0。

用 更新文档version = 0。将lastname和设置version为1。

尝试更新先前加载的文档，但仍有version = 0. 操作失败并显示
OptimisticLockingFailureException，因为当前version是1。

乐观锁定仅支持单实体操作，不支持批处理操作。

9.10.查询行

你可以表达使用您的查询Query和Criteria类别，其中有反映本地卡桑德拉谓词运营商名称，如方法名lt，lte，is，等。

在Query和Criteria类遵循流畅API风格，让您可以轻松地串联多个方法标准和查询在一起，同时具有易于理解的代码。在 Java 中创建Query 和Criteria实例时使用静态导入以提高可读性。

9.10.1.查询表中的行

在前面的部分中，我们看到了如何使用selectOneByIdon 方法检索单个对象CassandraTemplate。这样做会返回单个域对象。我们还可以查询要作为域对象列表返回的行集合。假设我们有许多Person名称和年龄值作为行存储在表中的对象，并且每个人都有一个帐户余额，我们现在可以使用以下代码运行查询：

示例 66. 查询行使用 CassandraTemplate

import static org.springframework.data.cassandra.core.query.Criteria.where;import static org.springframework.data.cassandra.core.query.Query.query;

…

List<Person> result = cassandraTemplate.select(query(where("age").is(50))
  .and(where("balance").gt(1000.00d)).withAllowFiltering(), Person.class);

的select，selectOne和stream方法采取一个Query对象作为参数。此对象定义用于执行查询的条件和选项。该标准是通过使用一个Criteria对象来指定的，该对象具有一个名为where实例化新Criteria对象的静态工厂方法。我们建议对
org.springframework.data.cassandra.core.query.Criteria.whereand使用静态导入Query.query，以使查询更具可读性。

此查询应返回Person满足指定条件的对象列表。的Criteria类有下列方法，对应于运营商的Apache卡桑德拉提供：

Criteria 类的方法

• CriteriaDefinition gt (Object value)：使用>运算符创建条件。

• CriteriaDefinition gte (Object value)：使用>=运算符创建条件。

• CriteriaDefinition in (Object… values)：通过IN对 varargs 参数使用运算符来创建条件。

• CriteriaDefinition in (Collection<?> collection)：通过使用IN集合的运算符创建条件。

• CriteriaDefinition is (Object value)：通过使用字段匹配 ( column = value)创建条件。

• CriteriaDefinition lt (Object value)：使用<运算符创建条件。

• CriteriaDefinition lte (Object value)：使用⇐运算符创建条件。

• CriteriaDefinition like (Object value)：使用LIKE运算符创建条件。

• CriteriaDefinition contains (Object value)：使用CONTAINS运算符创建条件。

• CriteriaDefinition containsKey (Object key)：使用CONTAINS KEY运算符创建条件。

Criteria 一经创建即不可变。

Query 类的方法

本Query类有一些额外的方法，你可以用它来提供的查询选项：

• Query by (CriteriaDefinition… criteria)：用于创建Query对象。

• Query 和 (CriteriaDefinition criteria)：用于向查询添加附加条件。

• Query columns (Columns columns)：用于定义要包含在查询结果中的列。

• Query limit (long limit)：用于将返回结果的大小限制为提供的限制（用于分页）。

• Query pageRequest (Pageable pageRequest)：用于关联Sort，PagingState以及fetchSize与查询（用于寻呼）。

• Query pagingState (ByteBuffer pagingState)：用于将 aByteBuffer与查询关联（用于分页）。

• Query queryOptions (QueryOptions queryOptions)：用于QueryOptions与查询关联。

• Query sort (Sort sort)：用于为结果提供排序定义。

• Query withAllowFiltering ()：用于呈现ALLOW FILTERING查询。

Query一经创建即不可变。调用方法会创建新的不可变（中间）Query对象。

9.10.2.查询行的方法

本Query类有以下方法，返回行：

• List<T> select (Query query, Class<T> entityClass)：T从表中查询类型的对象列表。

• T selectOne (Query query, Class<T> entityClass)：T从表中查询单个类型的对象。

• Slice<T> slice (Query query, Class<T> entityClass)：通过从表中查询 a Sliceof 类型的对象来开始或继续分页T。

• Stream<T> stream (Query query, Class<T> entityClass)：T从表中查询类型对象的流。

• List<T> select (String cql, Class<T> entityClass)：T通过提供 CQL 语句对表中类型对象列表的临时查询。

• T selectOne (String cql, Class<T> entityClass)：T通过提供 CQL 语句对表中的单个类型对象进行临时查询。

• Stream<T> stream (String cql, Class<T> entityClass)：T通过提供 CQL 语句对表中类型的对象流进行临时查询。

查询方法必须指定T返回的目标类型。

9.10.3.流畅的模板API

CassandraOperations当涉及到与 Apache Cassandra 的更底层交互时，该接口是核心组件之一。它提供了广泛的方法。您可以为每个方法找到多个重载。它们中的大多数涵盖了 API 的可选（可为空）部分。

FluentCassandraOperations为CassandraOperations 提供更易读、更流畅的 API 的常用方法提供更窄的接口。入口点（query(…)、insert(…)、update(…)和delete(…)）遵循基于要执行的操作的自然命名方案。从入口点开始，该 API 旨在仅提供依赖于上下文的方法，引导开发人员使用调用实际CassandraOperation. 以下示例显示了流畅的 API：

List<SWCharacter> all = ops.query(SWCharacter.class)
  .inTable("star_wars")                        
  .all();

如果使用类名SWCharacter定义表名@Table或使用类名作为表名没有问题，请跳过此步骤。

如果 Cassandra 中的一个表包含不同类型的实体，例如Jedi在一个 Table of 中的实体SWCharacters，则可以使用不同的类型来映射查询结果。您可以使用as(Class<?> targetType)将结果映射到不同的目标类型，同时query(Class<?> entityType)仍然适用于查询和表名。以下示例使用query和as方法：

List<Jedi> all = ops.query(SWCharacter.class)    
  .as(Jedi.class)                                
  .matching(query(where("jedi").is(true)))
  .all();

查询字段根据SWCharacter类型进行映射。

结果行被映射到Jedi.

您可以直接应用于预测由仅提供以产生的文件interface通过类型as(Class<?>)。

终止方法 ( first(), one(), all(), 和stream()) 处理检索单个实体和检索多个实体之间的切换List或Stream类似操作。

新流利的模板API方法（即query(..)，insert(..)，update(..)和delete(..)）使用有效线程安全的支持对象组成的CQL语句。然而，它带来了额外的年轻代 JVM 堆开销的额外成本，因为设计基于各种 CQL 语句组件的最终字段和变异构造。在可能插入或删除大量对象时（例如在循环内部），您应该小心。