[Spring] Mapper, Mapstruct

Mapper

• Mapper 필요 이유

  • DTO와 Entity를 서로 변환해야함
    • 계층별 관심사 분리
      • 하나의 클래스나 메서드 내에서 여러 개의 기능들을 구현하고 있는 것은 객체 지향 코드 관점에서도 리팩토링 대상
    • 코드 구성의 단순화
    • REST API 스펙의 독립성 확보
  • Request DTO → Entity → Response DTO

• Mapper 클래스 구현

  @Component
  public class MemberMapper {
      public Member memberPostDtoToMember(MemberPostDto memberPostDto) {
          return new Member(0L,
                  memberPostDto.getEmail(),
                  memberPostDto.getName(),
                  memberPostDto.getPhone());
      }
  }

MapStruct

• MapStruct

  • Java Bean 규약을 지키는 객체들 간의 변환 기능을 제공하는 매퍼(Mapper) 구현 클래스를 자동으로 생성해주는 코드 자동 생성기

• MapStruct의 필요 이유

  • 어떤 도메인 업무 기능이 늘어날때 마다 개발자가 일일이 수작업으로 매퍼(Mapper) 클래스를 만드는 것은 비효율적
  • MapStruct가 매퍼 클래스를 자동으로 구현해줌으로 개발 생산성 향상

• MapStruct 프레임워크 추가

  dependencies {
  		...
  		...
  		implementation 'org.mapstruct:mapstruct:1.4.2.Final'
  		annotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final'
  }

• MapStruct 기반 Mapper 인터페이스 정의

  @Mapper(componentModel = "spring") // componentModel = "spring" 을 지정하면 Spring Bean 등록
  public interface MemberMapper {
    Member memberPostDtoToMember(MemberPostDto memberPostDto);
    Member memberPatchDtoToMember(MemberPatchDto memberPatchDto);
    MemberResponseDto memberToMemberResponseDto(Member member);
    // 변경_후_객체 메서드명 (변경_전_객체 변경전객체)
  }

• 실제로 구현된 객체는 Gradle의 build task를 실행 시 자동 생성

  • IntelliJ IDE 좌측 Project 탭 > 프로젝트명 > build 디렉토리 내에 Mapper 인터페이스가 위치한 패키지 안에 생성