使用Spring Data中的CassandraTemplate
原文链接:www.baeldung.com/spring-data…
作者:baeldung
译者:xuli
1.概述
这是Spring Data Cassandra文章系列的第二篇文章。在本文中,我们将主要关注数据访问层中的CassandraTemplate和CQL查询。您可以在本系列的第一篇文章中阅读有关Spring Data Cassandra的更多信息(第一篇文章也进行了翻译)。
Cassandra查询语言(CQL)是Cassandra数据库的查询语言,CqlTemplate是Spring Data Cassandra中的底层数据访问模板 - 它方便地公开与数据操作相关的操作以执行CQL语句。CassandraTemplate构建在底层CqlTemplate之上,提供了一种查询域对象的简单方法,并将对象映射到Cassandra中的持久化数据结构。
让我们从配置开始,然后深入了解使用这两个模板的示例。
2. CassandraTemplate配置
CassandraTemplate在Spring上下文中可用,因为我们的主要Cassandra Spring配置正在扩展AbstractCassandraConfiguration:
@Configuration
@EnableCassandraRepositories(basePackages = "org.baeldung.spring.data.cassandra.repository")
public class CassandraConfig extends AbstractCassandraConfiguration { ... }
然后我们可以在模板中简单地连接 - 无论是通过它的确切类型CassandraTemplate,还是更通用的接口CassandraOperations:
@Autowired
private CassandraOperations cassandraTemplate;
3.使用CassandraTemplate访问数据
让我们在数据访问层模块中使用上面定义的CassandraTemplate来处理数据持久化。
3.1.保存一本新书
我们可以将新书保存到我们的书店:
Book javaBook = new Book(
UUIDs.timeBased(), "Head First Java", "O'Reilly Media",
ImmutableSet.of("Computer", "Software"));
cassandraTemplate.insert(javaBook);
然后我们可以检查数据库中插入的书的可用性:
Select select = QueryBuilder.select().from("book")
.where(QueryBuilder.eq("title", "Head First Java"))
.and(QueryBuilder.eq("publisher", "O'Reilly Media"));
Book retrievedBook = cassandraTemplate.selectOne(select, Book.class);
我们使用的是选择的QueryBuilder这里,被映射到selectOne()在cassandraTemplate。
我们将在CQL查询部分更深入地讨论QueryBuilder。
3.2.保存多本书
我们可以使用列表一次将多本书籍保存到我们的书店:
Book javaBook = new Book(
UUIDs.timeBased(), "Head First Java", "O'Reilly Media",
ImmutableSet.of("Computer", "Software"));
Book dPatternBook = new Book(
UUIDs.timeBased(), "Head Design Patterns", "O'Reilly Media",
ImmutableSet.of("Computer", "Software"));
List<Book> bookList = new ArrayList<Book>();
bookList.add(javaBook);
bookList.add(dPatternBook);
cassandraTemplate.insert(bookList);
3.3.更新现有图书
首先插入一本新书:
Book javaBook = new Book(
UUIDs.timeBased(), "Head First Java", "O'Reilly Media",
ImmutableSet.of("Computer", "Software"));
cassandraTemplate.insert(javaBook);
我们来取出本书:
Select select = QueryBuilder.select().from("book");
Book retrievedBook = cassandraTemplate.selectOne(select, Book.class);
然后让我们为检索到的书添加一些额外的标签:
retrievedBook.setTags(ImmutableSet.of("Java", "Programming"));
cassandraTemplate.update(retrievedBook);
3.4.删除已插入的图书
我们来插一本新书:
Book javaBook = new Book(
UUIDs.timeBased(), "Head First Java", "O'Reilly Media",
ImmutableSet.of("Computer", "Software"));
cassandraTemplate.insert(javaBook);
然后删除这本书:
cassandraTemplate.delete(javaBook);
3.5.删除所有图书
我们现在插入一些新书:
Book javaBook = new Book(
UUIDs.timeBased(), "Head First Java", "O'Reilly Media",
ImmutableSet.of("Computer", "Software"));
Book dPatternBook = new Book(
UUIDs.timeBased(), "Head Design Patterns", "O'Reilly Media",
ImmutableSet.of("Computer", "Software"));
cassandraTemplate.insert(javaBook);
cassandraTemplate.insert(dPatternBook);
然后删除所有书籍:
cassandraTemplate.deleteAll(Book.class);
4.使用CQL查询进行数据访问
始终可以在数据访问层中使用CQL查询进行数据操作。CQL查询处理由CqlTemplate类执行,允许我们根据需要执行自定义查询。
但是,由于CassandraTemplate类是CqlTemplate的扩展,我们可以直接使用它来执行这些查询。
让我们看一下使用CQL查询操作数据的不同方法。
4.1.使用QueryBuilder
QueryBuilder可用于构建数据库中数据操作的查询。几乎所有的标准操作都可以使用开箱即用的构建块来构建:
Insert insertQueryBuider = QueryBuilder.insertInto("book")
.value("isbn", UUIDs.timeBased())
.value("title", "Head First Java")
.value("publisher", "OReilly Media")
.value("tags", ImmutableSet.of("Software"));
cassandraTemplate.execute(insertQueryBuider);
如果仔细查看代码片段,您可能会注意到使用了execute()方法而不是相关的操作类型(插入,删除等)。这是因为查询类型由QueryBuilder的输出定义。
4.2.使用PreparedStatements
尽管PreparedStatements可用于任何情况,但通常建议将此机制用于多个插入以进行高速摄取。
一个PreparedStatement的准备只有一次,帮助确保高性能:
UUID uuid = UUIDs.timeBased();
String insertPreparedCql =
"insert into book (isbn, title, publisher, tags) values (?, ?, ?, ?)";
List<Object> singleBookArgsList = new ArrayList<>();
List<List<?>> bookList = new ArrayList<>();
singleBookArgsList.add(uuid);
singleBookArgsList.add("Head First Java");
singleBookArgsList.add("OReilly Media");
singleBookArgsList.add(ImmutableSet.of("Software"));
bookList.add(singleBookArgsList);
cassandraTemplate.ingest(insertPreparedCql, bookList);
4.3.使用CQL语句
我们可以直接使用CQL语句来查询数据,如下所示:
UUID uuid = UUIDs.timeBased();
String insertCql = "insert into book (isbn, title, publisher, tags)
values (" + uuid + ", 'Head First Java', 'OReilly Media', {'Software'})";
cassandraTemplate.execute(insertCql);
5.结论
在本文中,我们使用Spring Data Cassandra检查了各种数据操作策略,包括CassandraTemplate和CQL查询。
上面的代码片段和示例的实现可以在我的GitHub项目中找到 - 这是一个基于Maven的项目,因此它应该很容易导入和运行。