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

模板 & 直接操作

该模板提供对底层数据库的较低级别访问，还用作存储库的基础。 任何时候，当仓库对你的需求来说太高级时，模板很有可能为你提供很好的服务。请注意， 您始终可以通过 .AbstractCouchbaseConfigurationspring-doc.cn

支持的操作

可以通过上下文之外的 和 bean 访问该模板。 一旦你有了对它的引用，你就可以对它运行各种操作。 除了通过存储库之外，在模板中，您还需要始终指定要转换的目标实体类型。couchbaseTemplatereactiveCouchbaseTemplatespring-doc.cn

这些模板使用 Fluent 样式的 API，允许您根据需要链接可选运算符。例如，这里是 如何存储用户，然后按其 ID 再次找到它：spring-doc.cn

示例 1.Fluent 模板访问
// Create an Entity
User user = new User(UUID.randomUUID().toString(), "firstname", "lastname");

// Upsert it
couchbaseTemplate.upsertById(User.class).one(user);

// Retrieve it again
User found = couchbaseTemplate.findById(User.class).one(user.getId());

如果您想为操作使用自定义（默认情况下将使用注释中的持久性选项）持久性要求，您可以将其链接进来：@Documentupsertspring-doc.cn

示例 2.具有持久性的 Upsert
User modified = couchbaseTemplate
  .upsertById(User.class)
  .withDurability(DurabilityLevel.MAJORITY)
  .one(user);

以类似的方式，您可以执行 N1QL 操作：spring-doc.cn

例 3.模板上的 N1QL 查询
final List<User> foundUsers = couchbaseTemplate
  .findByQuery(User.class)
  .consistentWith(QueryScanConsistency.REQUEST_PLUS)
  .all();

子文档操作

Couchbase 支持子文档操作。本节记录了如何将其与 Spring Data Couchbase 一起使用。spring-doc.cn

子文档操作可能比完整文档操作（如 upsert 或 replace）更快、更高效，因为它们仅通过网络传输文档的访问部分。spring-doc.cn

Sub-Document 操作也是原子的，因为如果一个 Sub-Document 更改失败，那么所有 Sub-Document 更改都会失败，从而允许使用内置的并发控制对文档进行安全修改。spring-doc.cn

目前 Spring Data Couchbase 仅支持子文档更改（remove、upsert、replace 和 insert）。spring-doc.cn

更改操作会修改文档中的一个或多个路径。这些操作中最简单的是 upsert，它与 fulldoc 级别的 upsert 类似，将修改现有路径的值，或者在不存在时创建它：spring-doc.cn

以下示例将更新用户地址上的 city 字段，而不会传输任何其他用户文档数据。spring-doc.cn

示例 4.模板上的 MutateIn upsert
User user = new User();
// id field on the base document id required
user.setId(ID);
user.setAddress(address);
couchbaseTemplate.mutateInById(User.class)
    .withUpsertPaths("address.city")
    .one(user);

执行多个子文档操作

可以同时对同一文档执行多个 Sub-Document 操作，从而允许您一次修改多个 Sub-Documents。当在单个 mutateIn 命令的上下文中提交多个操作时，服务器将使用相同版本的文档执行所有操作。spring-doc.cn

要执行多个 mutation 操作，可以使用方法链接。spring-doc.cn

例 5.MutateIn 多个操作
couchbaseTemplate.mutateInById(User.class)
    .withInsertPaths("roles", "subuser.firstname")
    .withRemovePaths("address.city")
    .withUpsertPaths("firstname")
    .withReplacePaths("address.street")
    .one(user);

并发修改

对文档不同部分的并发 Sub-Document 操作不会冲突，因此默认情况下，在执行更改时不会提供 CAS 值。 如果需要 CAS，则可以像这样提供：spring-doc.cn

例 6.使用 CAS 的 MutateIn
User user = new User();
// id field on the base document id required
user.setId(ID);
// @Version field should have a value for CAS to be supplied
user.setVersion(cas);
user.setAddress(address);
couchbaseTemplate.mutateInById(User.class)
    .withUpsertPaths("address.city")
    .withCasProvided()
    .one(user);

异常转换

Spring Framework 为各种数据库和 Map 技术提供了异常转换。 传统上，这是 JDBC 和 JPA 的专利。 Spring Data Couchbase 通过提供接口的实现将此功能扩展到 Couchbase。org.springframework.dao.support.PersistenceExceptionTranslatorspring-doc.cn

映射到 Spring 的一致数据访问异常层次结构背后的动机是让您编写可移植的描述性异常处理代码，而无需针对和处理特定的 Couchbase 异常进行编码。 Spring 的所有数据访问异常都是从该类继承的，因此您可以确保可以在单个 try-catch 块中捕获所有与数据库相关的异常。DataAccessExceptionspring-doc.cn

ReactiveCouchbase尽早传播异常。 在处理反应序列期间发生的异常将作为错误信号发出。spring-doc.cn