2. 響應 DTO vs 請求 DTO

• 響應 DTO：定義服務端返回給客戶端的數(shù)據(jù)結構；
• 請求 DTO：定義客戶端提交給服務端的數(shù)據(jù)結構。
  90% 的場景里，API 的入?yún)⑴c出參都會使用這兩類 DTO，對業(yè)務層與數(shù)據(jù)層起到解耦保護。

3. 舉例：絕不直接返回完整 Model

假設用戶模型里含有 Password 字段，你絕對不能連同密碼一起返回。

> 錯誤做法：return user;
> 正確做法：定義 UserResponseDto { Username, Email … }，只傳回安全字段。

4. 創(chuàng)建 DTO 文件夾與 StockResponseDto

1. 在項目根目錄下新建 Dtos 文件夾；

2. 再在其中按實體分子目錄，這里創(chuàng)建 Dtos/Stock。

   API/
   └── Dtos/
      └── Stock/
          └── StockResponseDto.cs

5. 編寫 StockResponseDto 類

public class StockResponseDto
{
    public int    Id            { get; set; }
    public string Symbol        { get; set; } = string.Empty;
    public string CompanyName   { get; set; } = string.Empty;
    public decimal PurchasePrice{ get; set; }
    public decimal LastDividend { get; set; }
    public string Industry      { get; set; } = string.Empty;
    public long   MarketCap     { get; set; }
}

6. 自寫 Mapper：Stock → StockResponseDto

在 Mappers/StockMapper.cs 中，利用擴展方法將 Stock 實體投射到 DTO：

public static class StockMapper
{
    public static StockResponseDto ToDto(this Stock stock) = >
        new()
        {
            Id             = stock.Id,
            Symbol         = stock.Symbol,
            CompanyName    = stock.CompanyName,
            PurchasePrice  = stock.PurchasePrice,
            LastDividend   = stock.LastDividend,
            Industry       = stock.Industry,
            MarketCap      = stock.MarketCap
        };
}

7. 在 Controller 中應用 DTO

將原先：

var stocks = await _context.Stocks.ToList();
return ok(stocks);

替換為：

var dtos = await _context.Stocks
    .Select(s = > s.ToDto())
    .ToListAsync();
return Ok(stocks);

• Select(s = > s.ToDto()) 等同于 JavaScript 的 map，批量轉換為 DTO。

小結

• DTO：裁剪與定制數(shù)據(jù)結構，提升安全與性能；
• 擴展方法 Mapper：輕量、直觀，比 AutoMapper 更易掌控；
• Select + ToDto：讓 Controller 返回清晰、可維護的 DTO 列表。

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

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

HTTP API vs WebSocket API：選擇哪個來實現(xiàn)實時通信？

深入了解 Gateway API 的推理擴展

GraphQL API滲透測試指南