DTO는 record로 구현 강제

설명

DTO(Data Transfer Object)는 읽기 전용(ReadOnly) 객체입니다. C#에서 class가 아닌 record로 구현해야 합니다. record는 불변성(immutability), 값 기반 동등성(value equality), with 식을 기본 제공하므로 DTO에 최적입니다.

규칙

• 모든 DTO 클래스는 class 대신 record로 선언합니다
• 응답/요청 전용 객체, 직렬화/역직렬화 전용 객체가 대상입니다
• 엔티티(Entity)나 상태 변경이 필요한 도메인 모델은 제외합니다
• sealed class + { get; set; } 패턴을 record + 위치 매개변수(positional parameter) 또는 { get; init; } 패턴으로 변환합니다

Worst Case (나쁜 예)

csharp
1// DTO를 class로 구현 - 불변성 보장 없음, 보일러플레이트 과다
2private sealed class PagedResponse
3{
4    public int Page { get; set; }
5    public int PageSize { get; set; }
6    public int TotalCount { get; set; }
7    public int TotalPages { get; set; }
8    public EmployeeDto[] Data { get; set; } = [];
9}
10
11private sealed class CreatedResponse
12{
13    public int Count { get; set; }
14    public EmployeeDto[] Data { get; set; } = [];
15}
16
17private sealed class EmployeeDto
18{
19    public string Name { get; set; } = "";
20    public string Email { get; set; } = "";
21    public string Tel { get; set; } = "";
22    public DateTime Joined { get; set; }
23}
24
25// JSON 역직렬화용 DTO를 class로 구현
26private sealed class JsonEmployeeDto
27{
28    public string? Name { get; set; }
29    public string? Email { get; set; }
30    public string? Tel { get; set; }
31    public string? Joined { get; set; }
32}

Best Case (좋은 예)

csharp
1// DTO를 record로 구현 - 불변성 보장, 간결한 코드
2private sealed record PagedResponse(
3    int Page,
4    int PageSize,
5    int TotalCount,
6    int TotalPages,
7    EmployeeDto[] Data);
8
9private sealed record CreatedResponse(
10    int Count,
11    EmployeeDto[] Data);
12
13private sealed record EmployeeDto(
14    string Name,
15    string Email,
16    string Tel,
17    DateTime Joined);
18
19// JSON 역직렬화용 DTO도 record로 구현
20private sealed record JsonEmployeeDto(
21    string? Name,
22    string? Email,
23    string? Tel,
24    string? Joined);

적용 대상

• API 응답/요청 DTO
• JSON 직렬화/역직렬화 매핑 객체
• 테스트 코드의 역직렬화 DTO
• 내부 데이터 전달용 객체