NestJS 객체 변환 (feat. TypeORM)

문제 상황

보통 업무 코드에서 Entity는 테이블 정보와 동일하게 정의하고, DTO는 API를 위해 별도로 정의하게 됩니다. 문제는 Entity에서 DTO로 변환하거나 그 반대의 과정이 필요한데, 겹치는 속성이 많음에도 객체를 새로 생성하게 되면 코드가 깔끔해지지 않는다는 점입니다.

const foos = await this.getFooList();
 
return foos.map((foo) => ({
  name: foo.name,
  description: foo.description,
  bar: someProcess(foo.bar),
  // ..
}));

해결 방안

class-transformer 패키지의 plainToInstance 함수를 사용할 수 있습니다.

import { plainToInstance } from "class-transformer";
 
const foos = await this.getFooList();
 
return foos.map((foo) =>
  plainToInstance(FooDto, {
    ...foo,
    bar: someProcess(foo.bar),
  })
);

별도의 처리가 필요할 경우 필요한 값만 교체하면 되기 때문에 유연하게 대처할 수 있습니다.

@Expose 데코레이터 활용

특정 필드만 노출하고 싶을 경우 @Expose() 데코레이터를 활용할 수 있습니다.

import { Expose, Exclude } from "class-transformer";
 
@Exclude()
export class FooDto {
  @Expose()
  name: string;
 
  @Expose()
  description: string;
 
  // bar는 노출되지 않음
  bar: string;
}

excludeExtraneousValues 옵션과 함께 사용하면 @Expose()가 붙은 필드만 변환됩니다.

plainToInstance(FooDto, data, { excludeExtraneousValues: true });

대안

DTO가 많고 매핑이 복잡해지면 @automapper/nestjs를 고려해볼 수 있습니다.