文档内容来源于 spring.io，由 springdoc.tech 翻译，版权归属于 SPRING.IO (VMware, Inc.)。可供个人学习、研究，未经许可，不得进行转载或用于商业行为。

仓库

ChatGPT-4o-mini 中英对照 Repositories

本章解释了 Spring Data 仓库的基本基础和 Couchbase 的特性。在继续 Couchbase 的特性之前，请确保您对基本概念有清晰的理解。

Spring Data 仓库抽象的目标是显著减少实现各种持久化存储数据访问层所需的样板代码量。

章节摘要

Spring Data 仓库抽象中的核心接口是 Repository。它作为类型参数接受要管理的领域类以及领域类的标识符类型。该接口主要作为标记接口，用于捕获要处理的类型，并帮助您发现扩展此接口的接口。

要定义一个仓库接口，首先需要定义一个特定于领域类的仓库接口。该接口必须扩展 Repository 并且要指定领域类和 ID 类型。如果你想暴露该领域类型的 CRUD 方法，你可以扩展 CrudRepository 或其变体，而不是 Repository。

Spring Data 仓库抽象的目标是显著减少实现各种持久化存储的数据访问层所需的样板代码量。

本章描述了对 Couchbase 的反应式仓库支持。这建立在 Couchbase 仓库中解释的核心仓库支持之上。因此，请确保您对那里解释的基本概念有一个清晰的理解。

本节介绍了如何为定义的仓库接口创建实例和 bean 定义。

仓库代理有两种方法可以从方法名称派生特定于商店的查询：

Spring Data 查询方法通常返回由仓库管理的聚合根的一个或多个实例。然而，有时可能希望基于这些类型的某些属性创建投影。Spring Data 允许建模专用的返回类型，以更有选择性地检索管理聚合的部分视图。

Spring Data 提供了多种选项来创建查询方法，几乎不需要编码。但是，当这些选项不能满足您的需求时，您也可以为仓库方法提供自定义实现。本节将介绍如何实现这一点。

由仓库管理的实体是聚合根。在领域驱动设计应用程序中，这些聚合根通常会发布领域事件。Spring Data 提供了一个注解 @DomainEvents，你可以在聚合根的方法上使用它，使得发布领域事件变得尽可能简单，示例如下所示：

本节文档介绍了一组 Spring Data 扩展，这些扩展使得 Spring Data 可以在多种上下文中使用。目前，大部分集成主要面向 Spring MVC。

从 Spring Data 2.0 开始，返回单个聚合实例的仓库 CRUD 方法使用 Java 8 的 Optional 来指示值可能不存在。此外，Spring Data 支持在查询方法中返回以下包装类型：

以下表格列出了 Spring Data 存储库查询推导机制通常支持的主题关键字，用于表达谓词。请查阅特定存储的文档以获取确切的支持关键字列表，因为某些这里列出的关键字可能在某些存储中不受支持。

以下表格列出了 Spring Data 仓库通常支持的返回类型。然而，请查阅特定存储的文档以获取支持的返回类型的确切列表，因为此处列出的一些类型在特定存储中可能不受支持。