什么是 Repository 模式？

Question

什么是 Repository 模式？

Accepted Answer

**Repository** 模式在一个 collection-like 接口后面抽象了**数据访问** — 将业务逻辑与数据如何存储和检索分离开来。它将应用程序与数据源（数据库、API）解耦，改进了可测试性和可维护性。

## Repository 模式做什么

```text
REPOSITORY → an abstraction layer between business logic and DATA ACCESS:
  → provides a clean interface (like a collection: findById, save, delete, findAll)
  → HIDES how/where data is actually stored (database, API, cache, files)
  → business logic uses the repository, NOT the database directly
→ separate WHAT data operations from HOW they're implemented
```

## 示例

```js
// repository interface — business logic depends on THIS, not the DB
class UserRepository {
  async findById(id) { /* query the database (hidden behind here) */ }
  async save(user) { /* insert/update */ }
  async findByEmail(email) { /* ... */ }
}
// business logic uses the repository, unaware of the data source
const user = await userRepository.findById(42);
// → swap the DB, or use a mock in tests, without changing business logic
```

## 好处

```text
✓ DECOUPLING → business logic doesn't depend on data-access details (DB, ORM, API) →
  swap data sources without changing business logic
✓ TESTABILITY → use a MOCK/fake repository in tests (no real database needed)
✓ CENTRALIZED data access → query logic in one place (maintainable, consistent)
✓ CLEANER architecture → clear separation between domain/business logic and data
→ common in layered/clean architectures; works with DI
```

## 为什么这很重要

理解 Repository 模式是有价值的，因为它是一个**常见的、实用的模式**，用于将业务逻辑与数据访问干净地分离开来，所以它是相关的设计知识。

Repository 模式在一个 collection-like 接口（findById、save、delete）后面抽象了数据访问，**隐藏了数据如何以及在哪里存储**，这样业务逻辑使用 repository 而不是直接使用数据库。

理解它做什么（提供一个干净的数据访问接口，隐藏实际的存储，将*什么*数据操作与*如何*实现它们分离）是核心知识。

理解**好处**是关键的：**解耦**（业务逻辑不依赖于数据访问细节，如特定的数据库、ORM 或 API，所以您可以在不改变业务逻辑的情况下交换数据源 — 一个有价值的架构优势）、**可测试性**（在测试中使用 mock/fake repositories，所以不需要真正的数据库 — 对于业务逻辑的单元测试很重要）、**集中式数据访问**（在一个地方处理查询逻辑以提高可维护性和一致性）和**更清洁的架构**（域/业务逻辑与数据之间的清晰分离）。

这些好处使 Repository 模式对于可维护的、可测试的应用程序具有实际价值。

理解它在**分层/整洁架构**中很常见，并与依赖注入配合工作，可以澄清它在现代架构中的位置。

Repository 模式被广泛使用，因为将业务逻辑与数据访问分离（为了可测试性、可维护性和灵活性）是一个常见的、重要的需求。

由于 Repository 模式是一个常见的、实用的模式，用于将业务逻辑与数据访问干净地分离开来（解耦、可测试性、集中式数据访问、更清洁的架构） — 一个常见的、重要的需求 — 并且是分层/整洁架构的核心，并且由于理解它做什么和它的好处对于构建可维护的应用程序是相关的，理解 Repository 模式是有价值的、具有实际相关性的设计知识 — 一个经常使用的模式，用于将业务逻辑与数据访问分离，提供解耦和可测试性，是整洁/分层架构的核心，对于构建可维护的、可测试的应用程序，逻辑和数据之间有清晰的分离，这是重要的设计知识。