[Spring] 서로 다른 객체 모델 간 매핑해주는 MapStruct 라이브러리

MapStruct 와 Lombok 설정 순서로 인한 문제 해결

최근에 MapStruct를 사용하여 DTO를 Entity로 변환하는 MemberMapper를 작성했습니다. 처음에는 정상적으로 작동할 거라 예상했지만, 빌드를 하고 난 후 생성된 MemberMapperImpl에서 기대했던 결과를 얻지 못했습니다.

 

문제 상황

작성한 코드는 다음과 같습니다.

MemberMapper

@Mapper(componentModel = "spring")
public interface MemberMapper {
    Member memberPostToMember(MemberPostDto requestBody);

}

MemberPostDto

@Getter
@AllArgsConstructor
public class MemberPostDto {

    @Email
    @NotBlank
    private String email;

    @NotBlank
    private String password;
}

 

Member

@Entity
@Getter
@Setter
@NoArgsConstructor
public class Member {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long memberId;

    @Column(nullable = false, updatable = false, unique = true)
    private String email;

    // 추가
    @Column(length = 100, nullable = false)
    private String password;

    @Column(length = 100)
    private String name;

    @Enumerated(value = EnumType.STRING)
    @Column(length = 20, nullable = false)
    private MemberStatus memberStatus = MemberStatus.MEMBER_SETTING_1;

    @ElementCollection(fetch = FetchType.EAGER)
    private List<String> roles = new ArrayList<>();


}

빌드 후 생성된 MemberMapperImpl은 다음과 같았습니다.

@Component
public class MemberMapperImpl implements MemberMapper {

    @Override
    public Member memberPostToMember(MemberPostDto requestBody) {
        if ( requestBody == null ) {
            return null;
        }

        Member member = new Member();

        //member.setEmail( requestBody.getEmail() );
        //member.setPassword( requestBody.getPassword() );

        return member;
    }
}

 

문제 분석

제가 예상했던 것은 DTO 의 멤버 변수를 가져와서 Entity 의 멤버 변수에 값을 설정하는 것이었지만, 생성된 코드에는 이러한 매핑이 전혀 이루어지지 않았습니다. 처음에는 Lombok 설정이 문제인지 의심하여 다음 사항들을 확인했습니다.

 

1) DTO 클래스에 @Getter 가 제대로 적용되었는지.

2) Entity 클래스에 @Setter, @NoArgsConstructor 가 적용되었는지,

 

하지만 아쉽게도(?) 제대로 설정이 되어 있었습니다.

 

그렇게 몇시간을 찾아보다가 build.gradle 설정에 문제가 있을 수 있다는 정보를 찾았습니다.

 

해결 방법

문제의 원인은 MapStruct 의존성 추가 순서였습니다.

" MapStruct 의존성 추가 설정이 Lombok 보다 뒤에 선언되어야 한다."

	//Lombok
	compileOnly 'org.projectlombok:lombok'
	annotationProcessor 'org.projectlombok:lombok'
	testImplementation 'org.springframework.boot:spring-boot-starter-test'
	testImplementation 'org.springframework.security:spring-security-test'
	//MapStruct
	implementation 'org.mapstruct:mapstruct:1.4.2.Final'
	annotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final'

이렇게 순서를 변경하고 나니 예상대로 MemeberMapperImpl 이 제대로 생성되었습니다.