<div id="readability-page-1" class="page"><div><h2 id="entity와-dto-간-매핑에-대한-코드를-자동-생성하는-mapstruct"><a href="#entity%EC%99%80-dto-%EA%B0%84-%EB%A7%A4%ED%95%91%EC%97%90-%EB%8C%80%ED%95%9C-%EC%BD%94%EB%93%9C%EB%A5%BC-%EC%9E%90%EB%8F%99-%EC%83%9D%EC%84%B1%ED%95%98%EB%8A%94-mapstruct" aria-label="entity와 dto 간 매핑에 대한 코드를 자동 생성하는 mapstruct permalink"></a>Entity와 DTO 간 매핑에 대한 코드를 자동 생성하는 MapStruct</h2>
Spring에서, Entity와 DTO 간 매핑을 자주하게 된다. 레이어 간 데이터를 주고받을 때 혹은 비즈니스 로직에서의 형변환 등이 그 경우이다.
이러한 작업을 수동으로 개발자가 직접 할 때 발생하는 문제점은 다음과 같다.
<blockquote>
<ol>
<li>지루하며 반복적이고 코드 중복이 발생한다.</li>
<li>필드가 많은 경우 실수하기 쉽다. </li>
<li>생산성 저하</li>
<li>코드의 복잡성</li>
</ol>
</blockquote>
객체 간 매핑을 자동으로 생성해주는 <code>MapStruct</code> 라이브러리를 사용한다면 위와 같은 문제점을 제거할 수 있다.
<h2 id="mapstruct의-장점"><a href="#mapstruct%EC%9D%98-%EC%9E%A5%EC%A0%90" aria-label="mapstruct의 장점 permalink"></a>MapStruct의 장점</h2>
<blockquote>
<ol>
<li>컴파일 시점에서 오류 확인 가능</li>
<li>리플렉션을 사용하지 않기 때문에 매핑 속도가 빠르다. (ModelMapper는 리플렉션을 사용한다.)</li>
<li>디버깅이 쉽다.</li>
<li>빌드 시, 매핑 코드가 자동생성되기 때문에 눈으로 확인할 수 있다.</li>
</ol>
</blockquote>
<h2 id="사용-예시"><a href="#%EC%82%AC%EC%9A%A9-%EC%98%88%EC%8B%9C" aria-label="사용 예시 permalink"></a>사용 예시</h2>
<h2 id="메서드-추상화"><a href="#%EB%A9%94%EC%84%9C%EB%93%9C-%EC%B6%94%EC%83%81%ED%99%94" aria-label="메서드 추상화 permalink"></a>메서드 추상화</h2>
<div data-language="java"><pre><code>public interface GenericMapper&lt;D, E&gt; {

 D toDto(E e);

 E toEntity(D d);

 @BeanMapping(nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE)
 void updateFromDto(D dto, @MappingTarget E entity);
}</code></pre></div>
공통적으로 사용되는 메서드들을 추상화한 <code>GenericMapper</code> 라는 인터페이스를 생성한다.
<h2 id="구현"><a href="#%EA%B5%AC%ED%98%84" aria-label="구현 permalink"></a>구현</h2>
<div data-language="java"><pre><code>@Mapper(componentModel = "spring", uses = ExampleEntity.class)
public interface ExampleEntityMapper extends GenericMapper&lt;ExampleDto, ExampleEntity&gt; {
 ExampleEntity toEntity(ExampleDto dto);
}</code></pre></div>
<div data-language="java"><pre><code>@Mapper(componentModel = "spring")
public interface ExampleResponseDto extends GenericMapper&lt;ExampleResponseDto, ExampleEntity&gt; {

 @Mapping(target = "someIgnoreField", ignore = true)
 ExampleResponseDto toDto(ExampleEntity exampleEntity);
}</code></pre></div>
참고
<a href="https://meetup.toast.com/posts/213">https://meetup.toast.com/posts/213</a></div></div>

Seulog💘

이예슬

Entity와 DTO 간 매핑에 대한 코드를 자동 생성하는 MapStruct
Spring에서, Entity와 DTO 간 매핑을 자주하게 된다. 레이어 간 데이터를 주고받을 때 혹은 비즈니스 로직에서의 형변환 등이 그 경우이다.
이러한 작업을 수동으로 개발자가 직접 할 때 발생하는 문제점은 다음과 같다.
지루하며 반복적이고 코드 중복이 발생한다.
필드가 많은 경우 실수하기 쉽다. 
생산성 저하
코드의 복잡성
객체 간 매핑을 자동으로 생성해주는 MapStruct 라이브러리를 사용한다면 위와 같은 문제점을 제거할 수 있다.
MapStruct의 장점
컴파일 시점에서 오류 확인 가능
리플렉션을 사용하지 않기 때문에 매핑 속도가 빠르다. (ModelMapper는 리플렉션을 사용한다.)
디버깅이 쉽다.
빌드 시, 매핑 코드가 자동생성되기 때문에 눈으로 확인할 수 있다.
사용 예시
메서드 추상화
public interface GenericMapper<D, E> {
 D toDto(E e);
 E toEntity(D d);
 @BeanMapping(nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE)
 void updateFromDto(D dto, @MappingTarget E entity);
}
공통적으로 사용되는 메서드들을 추상화한 GenericMapper 라는 인터페이스를 생성한다.
구현
@Mapper(componentModel = "spring", uses = ExampleEntity.class)
public interface ExampleEntityMapper extends GenericMapper<ExampleDto, ExampleEntity> {
 ExampleEntity toEntity(ExampleDto dto);
}
@Mapper(componentModel = "spring")
public interface ExampleResponseDto extends GenericMapper<ExampleResponseDto, ExampleEntity> {
 @Mapping(target = "someIgnoreField", ignore = true)
 ExampleResponseDto toDto(ExampleEntity exampleEntity);
}
참고
https://meetup.toast.com/posts/213

Entity와 DTO 간 매핑에 대한 코드를 자동 생성하는 MapStruct

댓글