CodeGym /課程 /C# SELF /資料傳遞類別(DTO)的問題

資料傳遞類別(DTO)的問題

C# SELF
等級 19, 課堂 0
開放

1. 認識 DTO

DTO(Data Transfer Object,資料傳遞物件)這個詞是從專業程式圈來的,特別是在分散式應用和服務(像是某個服務透過網路呼叫另一個服務)裡很常見。其實它就是個物件——大部分時候就是 C# 的普通 class——唯一的任務就是:裝一堆資料,然後安全地在程式不同層或不同應用之間傳來傳去。

想像一下 client 跟 server 之間的聊天室。每次使用者發送訊息時,client 會組一個物件,裡面有文字、時間、使用者名稱,然後丟給 server,server 再決定怎麼處理。這個物件最好什麼都不要多,只有傳資料需要的東西。這就是 DTO 類別的精神。

public class UserDto
{
    public int Id { get; set; }
    public string Name { get; set; }
}
經典 DTO:只有屬性,完全沒邏輯

就這樣!沒有商業邏輯,沒有複雜方法——只有屬性。

只負責傳資料的類別

想像你在做披薩外送。你的外送員(DTO)不用會做披薩、不用接單、不用修腳踏車。他唯一要做的事——就是把盒子從 A 點送到 B 點。DTO 類別也是這樣:只負責存簡單資料。他不用驗證自己、不用知道怎麼在 UI 顯示自己——只要存資料就好。

  • DTO 就是「沒專業技能的人」或「沒邏輯的物件」,只負責搬資料。
  • 用它們是為了不要讓商業邏輯被資料傳遞細節搞亂:行李越小越好搬。

2. 傳統 DTO 類別的實務問題

看起來很爽對吧:宣告個 class,auto-property 一下,人生就美好了!但其實沒那麼簡單。

資料可變性:會出什麼包

public class ProductDto
{
    public int Id { get; set; }
    public string Name { get; set; }
}
DTO 有 public set——資料超容易被不小心改掉

現在想像一下,某段 code 不小心改了屬性:

ProductDto dto = new ProductDto { Id = 1, Name = "牛奶" };
SomeApiProcess(dto);
dto.Name = "優格"; // 哎呀!

因為所有屬性都有 public set,很容易一不小心就把物件搞壞,或者更慘,在某個地方改了,結果整個系統都被影響。這在多模組、多執行緒的情境下超級危險。

複製跟比較——無止盡的苦差事

假設你想複製一個 ProductDto,只改名字。

var otherDto = new ProductDto { Id = dto.Id, Name = "起司" };

如果屬性一堆,這就變成超無聊又容易出 bug 的手動複製。

如果還要比較物件?你還得 override Equals 跟 GetHashCode,很多人都亂寫或直接忘記。

不可變性——傳統 class 做不到

大多數情況下 DTO 應該是不可變的:資料拿到一次就不能再改。但 auto-property 的 class 完全不適合這種需求:誰都能改任何欄位。

3. 實務上在大專案會怎樣

來看個真實案例。

你是某個超大電商的工程師。你要把訂單資訊透過網路傳出去。你寫了這樣的 class:

public class OrderDto
{
    public int Id { get; set; }
    public string Customer { get; set; }
    public double Total { get; set; }
}

一切都很順,直到每週有幾十萬筆訂單。超多 microservice 開始互相傳 DTO,有人忘了 Total 應該要算出來不是自己設,有人不小心在送出後改了 Customer……然後你就會遇到超難抓的 bug。

怎麼改善?

  • 只用 get 屬性(不要 set)。
  • 設計一個專用 constructor,只能在建立時設定值。
  • override Equals 跟 GetHashCode……

你懂了吧?本來只是個「行李箱」,結果搞到最後變成一隻怪獸。

4. DTO class 常見問題小抄

小專案時 DTO 被改出 bug 還能「用手抓」。大專案就災難了。DTO 會用在授權、金流、訂單處理——任何非法資料變動都可能變成金錢損失,甚至(靠北!)刑事案件。

下面這張「小抄」列出大家寫 DTO class 幾乎都會遇到的問題:

問題 說明
可變性 資料到處都能改——很容易出 bug(尤其多執行緒時)
複製 物件不好複製,常常要手動寫
比較 預設是比 reference,不是比內容
支援 with 複製 想要只改部分資料複製,卻得手動寫
巢狀不明顯 巢狀 DTO 也要整個複製,很麻煩

5. 範例:我們的應用程式裡資料在不同層傳遞

假設我們有個行事曆 app,可以存任務。以前我們會寫這樣的 class:

public class TaskDto
{
    public int Id { get; set; }
    public string Description { get; set; }
    public DateTime DueDate { get; set; }
}

我們會從檔案讀 TaskDto,加到 collection,然後顯示在畫面上。一切都很順……直到某個 module 不小心在序列化前改了 DueDate,結果用戶就一頭霧水。

7. 有沒有更好的做法?

有!而且不只可以,根本就該這樣做!C# 為了解決這些問題,推出了 record 這個語法。它幾乎神奇地解決了大部分 DTO class 的痛點。

record 會幫你做什麼:

  • 預設是 value-based:物件比較是比內容,不是 reference。
  • 不可變性:可以只寫 get 屬性,值只能在 constructor 設定。
  • 超好複製:有 with 語法可以複製時改部分資料。
  • 自動產生比較跟 ToString 之類的方法。
public record TaskDto(int Id, string Description, DateTime DueDate);
用 record 寫 DTO:超精簡、超安全、超方便!

是不是很酷?超酷!但這個我們下堂課再聊。

2
任務
C# SELF, 等級 19, 課堂 0
上鎖
建立最簡單的 DTO 類別
建立最簡單的 DTO 類別
2
任務
C# SELF, 等級 19, 課堂 0
上鎖
使用 DTO 在方法之間傳遞資料
使用 DTO 在方法之間傳遞資料
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION