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)不用會做披薩、不用接單、不用修腳踏車。他唯一要做的事——就是把盒子從 A 點送到 B 點。DTO 類別也是這樣:只負責存簡單資料。他不用驗證自己、不用知道怎麼在 UI 顯示自己——只要存資料就好。
- DTO 就是「沒專業技能的人」或「沒邏輯的物件」,只負責搬資料。
- 用它們是為了不要讓商業邏輯被資料傳遞細節搞亂:行李越小越好搬。
2. 傳統 DTO 類別的實務問題
看起來很爽對吧:宣告個 class,auto-property 一下,人生就美好了!但其實沒那麼簡單。
資料可變性:會出什麼包
public class ProductDto
{
public int Id { get; set; }
public string Name { get; 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);
是不是很酷?超酷!但這個我們下堂課再聊。
GO TO FULL VERSION