2. 響應(yīng) DTO vs 請求 DTO

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

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

假設(shè)用戶模型里含有 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 中應(yīng)用 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，批量轉(zhuǎn)換為 DTO。

小結(jié)

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

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

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

深入解析API網(wǎng)關(guān)策略：認(rèn)證、授權(quán)、安全、流量處理與可觀測性

火山引擎如何接入API：從入門到實踐的技術(shù)指南

深入解析 DeepSeek API 密鑰：獲取、使用與最佳實踐

API 設(shè)計原理：從理論到實踐

DeepSeek+dify 工作流應(yīng)用,自然語言查詢數(shù)據(jù)庫信息并展示

REST API 基礎(chǔ)：定義、示例及使用方法

如何使用 DeepSeek 構(gòu)建 AI Agent：終極指南

API 網(wǎng)關(guān)集成 SkyWalking 打造全方位日志處理

9個最佳Text2Sql開源項目：自然語言到SQL的高效轉(zhuǎn)換工具