chanYongYong

DTO와 mapper 본문

개발/백엔드지식

DTO와 mapper

chanYongYong 2026. 1. 26. 03:07

DTO (Data Transfer Object)

DTO란?

데이터를 전송할 때만 쓰는 객체다. 요청(Request)과 응답(Response)에 사용하며, 유효성 검증을 적용할 수 있다.


왜 DTO를 쓰는가?

응답 시 민감한 정보(비밀번호 등)를 제외해야 한다.

// 요청용 DTO
public record MemberPostDto(String name, String email, String password, int age) {}

// 응답용 DTO - 비밀번호 제외
public record MemberResponseDto(UUID memberId, String name, String email, int age) {}
 
 

엔티티를 그대로 반환하면 비밀번호까지 노출되므로, 응답용 DTO를 별도로 만든다.


리플렉션과 Getter

Spring 내부적으로 **리플렉션(Reflection)**을 사용한다. 접근자(private/public) 상관없이, setter 없이도 값 주입이 가능하다.

단, Jackson(JSON 직렬화 라이브러리)은 Getter가 필요하다.

객체를 JSON으로 변환할 때 값을 조회해야 하기 때문이다.

 

문제: 형변환 코드가 너무 많다

Controller에서 DTO → Entity, Entity → DTO 변환 코드가 핵심 로직을 가린다.

@PostMapping("/member")
public MemberResponseDto createMember(@RequestBody MemberPostDto dto) {
    // 형변환 코드 (핵심 아님)
    Member member = new Member();
    member.setId(UUID.randomUUID());
    member.setName(dto.getName());
    member.setPassword(dto.getPassword());
    member.setEmail(dto.getEmail());
    member.setAge(dto.getAge());

    // 핵심 로직
    Member createdMember = memberService.createMember(member);

    // 또 형변환 코드 (핵심 아님)
    MemberResponseDto response = new MemberResponseDto(
        createdMember.getId(),
        createdMember.getName(),
        createdMember.getEmail(),
        createdMember.getAge()
    );
    return response;
}

형변환만 하는데 이 코드양이 많음. 요청과 응답이 핵심로직임.

이럴 때 분리해야 함.

Mapper로 분리

DTO ↔ Entity 변환을 담당하는 Mapper를 분리하면 코드가 깔끔해진다.

이렇게 나누면 다음과 같이 줄어듬.

public class MemberMapper {
    public Member memberPostDtoToMember(MemberPostDto dto) {
        Member member = new Member();
        member.setId(UUID.randomUUID());
        member.setName(dto.getName());
        member.setEmail(dto.getEmail());
        member.setPassword(dto.getPassword());
        member.setAge(dto.getAge());
        return member;
    }

    public MemberResponseDto memberToMemberResponseDto(Member member) {
        return new MemberResponseDto(
            member.getId(),
            member.getName(),
            member.getEmail(),
            member.getAge()
        );
    }
}

Mapper 적용 후 Controller

@PostMapping("/member")
public MemberResponseDto createMember(@RequestBody MemberPostDto dto) {
    Member member = mapper.memberPostDtoToMember(dto);
    Member createdMember = memberService.createMember(member);
    MemberResponseDto response = mapper.memberToMemberResponseDto(createdMember);
    return response;
}

 

MapStruct 사용법

Mapper를 직접 만드는 것도 귀찮다. MapStruct는 Mapper를 자동으로 생성해주는 라이브러리다.

의존성 추가

compileOnly 'org.projectlombok:lombok'
annotationProcessor 'org.projectlombok:lombok'

implementation 'org.mapstruct:mapstruct:1.4.2.Final' //어노테이션 제공
annotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final' //구현체 생성

주의점

Lombok이 MapStruct보다 위에 있어야 한다!

Entity에 기본 생성자 + Setter 또는 모든 필드 생성자 중 하나는 있어야 한다


Mapper 인터페이스 작성

@Mapper(componentModel = "spring")
public interface MemberMapper {
    Member memberPostDtoToMember(MemberPostDto memberPostDto);
    MemberResponseDto memberToMemberResponseDto(Member member);
}
  • @Mapper(componentModel = "spring"): 이 인터페이스의 구현체를 Bean으로 등록
  • 필드 이름이 같으면 자동으로 매핑 (순서 상관없음)
  • ID 같은 건 DTO에 없으므로 별도 처리 필요

그렇다면 ID는 어디서 설정할까?

Controller에서 ID 설정

다음코드를 보면 컨트롤러에서 UUID를 따로 넣어주고 있다.

이렇게 하기 보다는 서비스에 넣어 하나의 비즈니스 로직으로 보는 것이 좋을것이다.

@PostMapping("/member")
public MemberResponseDto createMember(@RequestBody MemberPostDto dto) {
    Member member = mapper.memberPostDtoToMember(dto);
    member.setId(UUID.randomUUID());  // Controller에서 ID 설정 ❌
    
    Member createdMember = memberService.createMember(member);
    ...
}

Service에서 ID 설정

// MemberService
public Member createMember(Member member) {
    member.setId(UUID.randomUUID());  // Service에서 ID 설정 ✅
    // memberRepository.save(member);
    return member;
}

 

 


파라미터 검증

유효성 검증을 Controller에서 직접 구현하면 코드가 지저분해진다. 

spring-boot-starter-validation 라이브러리를 사용하면 어노테이션으로 간단하게 처리할 수 있다.

 

DTO에 검증 적용 (자카르트)
클래스 방식

@NotBlank(message = "이름엔 공백이 포함되지 않아야 합니다.")
private String name;

@Email(message = "올바른 형태의 이메일을 사용하셔야 합니다.")
private String email;

@NotBlank
private String password;

@Range(min = 1, max = 120, message = "사람이세요?")
private int age;

record 방식

Spring Boot 3 이후로는 JDK 17이 강제되기에 record 사용이 가능하다.
Spring Boot 2 이하에서는 JDK 16 미만일 수 있으므로 record 대신 class로 DTO를 구현해야 한다.

public record MemberPostDto (
    @Pattern(regexp = "^[가-힣]+$", message = "한글만 가능합니다.")
    String name,
    
    @Email(message = "올바른 형태의 이메일을 사용하셔야 합니다.")
    String email,
    
    @NotBlank
    String password,
    
    @Range(min = 1, max = 120, message = "사람이세요?")
    int age,
    
    @Pattern(regexp = "^010-\\d{4}-\\d{4}$", message = "올바른 형태의 전화번호를 입력하세요.")
    String phone
) {}

Controller에서 @Valid 적용

DTO에 검증 어노테이션을 붙였다면, Controller에서 @Valid를 추가해야 동작한다.

@PostMapping("/member")
public MemberResponseDto createMember(@Valid @RequestBody MemberPostDto dto) {
    Member member = mapper.memberPostDtoToMember(dto);
    Member createdMember = memberService.createMember(member);
    return mapper.memberToMemberResponseDto(createdMember);
}

 

세밀한 검증이 필요하면 정규식(@Pattern)을 활용해야 한다.

한글만 허용 (공백 불가)

@Pattern(regexp = "^[가-힣]+$", message = "한글만 가능합니다.")
private String name;

전화번호 형식

@Pattern(regexp = "^010-\\d{4}-\\d{4}$", message = "올바른 형태의 전화번호를 입력하세요.")
private String phone;

 


주의점

@NotBlank는 완전히 빈 문자열이나 공백만 있는 경우만 잡는다. 특수문자나 숫자가 포함된 경우는 통과시킨다.

@Pattern은 null일 때 동작하지 않는다. null 체크가 필요하면 @NotBlank 또는 @NotNull과 함께 사용해야 한다.