<aside>

목차

</aside>

변환 ( Class Transformer )

<aside> 📖

NestJs의 class-transformer 는 요청, 응답 과정에서 객체를 지정된 클래스 직렬화 하거나, 역직렬화, 타입 변환 등 변환 작업을 담당하는 유틸리티 라이브러리이다.

</aside>

<aside> ❗

Class Transformer 특성

• TS Decorator를 사용해 클래스를 변환한다. ( transformer → validate )
• 직렬화(Serialization), 역직렬화(Deserialization), 인스턴스 변환 담당
• 중첩된 ( Nested ) 객체에도 매우 쉽게 적용 가능
• 커스텀 Transformer로 제약 없이 변환 가능 </aside>

Class Transformer 예제

• 1. 일반 객체 사용 예제
• 2. 요청 DTO 변환 및 검증

주요 데코레이터

<aside> ✏️

• @Transform(): 변환 시 특정 로직(ex. 문자열 → 숫자) 적용

• @Type(() ⇒ TargetClass): 중첩 객체나 배열을 특정 클래스 타입으로 변환

• @Expose(): 변환 결과에 필드를 포함

• @Exclude(): 변환 결과에서 해당 필드를 제외 (필터링) </aside>

• 코드 예제

중첩 클래스 변환

class Address {
		city: string;
		country: string;		
}

class User {
		@Exclude()
		name: string;
		
		@Type(() => Address)
		email: string;
}

• 중첩된 객체 타입을 Type 데코레이터에 제공