2. 為什么需要 Repository 模式

• 降低耦合：控制器和業務層只依賴于接口（而非具體實現），便于替換和測試。
• 提高復用：將重復的數據庫訪問邏輯封裝在倉儲方法中，避免多處粘貼相同代碼。
• 便于單元測試：可對接口打樁（Mock），無需真實數據庫即可測試業務邏輯。

3. Repository 模式的兩種闡釋

3.1 正式定義（學術視角）

> Repository 模式旨在為領域與數據映射層之間提供中介，使業務邏輯層無需關注數據存儲細節，就像一個“數據庫集合”的接口。

3.2 通俗解釋（實戰視角）

倉儲就是一個專門存放“數據庫調用”的地方，你把 DbContext 的增刪改查都放在這里，需要時在業務或控制器中“即插即用”，就像隨時取用一個獨立模塊。

4. 在 ASP.NET Core 中實現 Repository 模式

4.1 定義模型（Pokemon）

public class Pokemon
{
    public int Id { get; set; }
    public string Name { get; set; }
    // … 其他屬性
}

4.2 創建接口（IPokemonRepository）

在 Interfaces/IPokemonRepository.cs 中定義倉儲契約：

public interface IPokemonRepository
{
    IReadOnlyCollection < Pokemon > GetPokemons();
    // 若有增刪改查，可繼續擴展：
    // Pokemon GetPokemon(int id);
    // bool CreatePokemon(Pokemon p);
    // bool UpdatePokemon(Pokemon p);
    // bool DeletePokemon(int id);
}

4.3 編寫倉儲類（PokemonRepository）

在 Repositories/PokemonRepository.cs 中實現接口：

public class PokemonRepository : IPokemonRepository
{
    private readonly AppDbContext _context;

    public PokemonRepository(AppDbContext context)
    {
        _context = context;
    }

    public IReadOnlyCollection < Pokemon > GetPokemons()
    {
        // 從 DbContext 中讀取所有 Pokemons，并按 Id 排序
        return _context.Pokemons
                       .OrderBy(p = > p.Id)
                       .ToList();
    }
}

> 要點：ToList() 明確觸發查詢，并轉換為不可變集合類型。

4.4 在 Controller 中調用倉儲方法

在 Controllers/PokemonController.cs 中注入并使用：

[ApiController]
[Route("api/[controller]")]
public class PokemonController : ControllerBase
{
    private readonly IPokemonRepository _pokemonRepo;

    public PokemonController(IPokemonRepository pokemonRepo)
    {
        _pokemonRepo = pokemonRepo;
    }

    [HttpGet]
    public ActionResult < IReadOnlyCollection < Pokemon > > GetPokemons()
    {
        if (!ModelState.IsValid)
            return BadRequest(ModelState);

        var list = _pokemonRepo.GetPokemons();
        return Ok(list);
    }
}

• 通過接口注入，對控制器隱藏了具體倉儲實現細節。

4.5 配置依賴注入

在 Program.cs 中注冊服務：

builder.Services.AddScoped < IPokemonRepository, PokemonRepository > ();

• AddScoped：作用域級別注入，適合每次 HTTP 請求中使用同一實例。

5. 小結與最佳實踐

• 接口先行：始終先定義契約接口，再實現類。
• 單一職責：倉儲只負責數據訪問，不要混入業務邏輯。
• 依賴注入：通過 DI 容器注入接口，解耦控制器與實現。
• 可測試性：在單元測試中對接口打樁，隔離數據庫依賴。
• 按需擴展：根據項目需求，為每個實體創建獨立倉儲，或抽象通用倉儲基類。

通過本文示例，你已掌握在 ASP.NET Core 項目中從零搭建 Repository 模式的全流程，讓你的 API 更加松耦合、易維護、可測試。繼續打磨、優化，項目將更具健壯性與可擴展性！

原文引自YouTube視頻：https://www.youtube.com/watch?v=-LAeEQSfOQk

#你可能也喜歡這些API文章!

一步步教你進行 Python REST API 身份驗證

微信API接口調用憑證+Access token泄露

REST API 基礎：定義、示例及使用方法

HTTP API vs WebSocket API：選擇哪個來實現實時通信？

深入了解 Gateway API 的推理擴展

GraphQL API滲透測試指南