[Spring] DTO, Entity, Mapper

안녕하세요 백엔드 개발자 홍민정입니다 🫧

오늘은 DTO, Entity가 무엇이며 Mapper를 사용하는 이유에 대해 알아보겠습니다. 

또한 추가적으로 @Mapper 애너테이션까지 알아보도록 하겠습니다 !

알아보기에 앞서, 그림으로 이해되기 쉽게 설명해 보았습니다.

 

 

✍🏻 Entity

 - 실제 DB의 테이블과 매칭된 클래스

 - 테이블과 연결될 클래스임을 나타냄

 - DB 테이블에 존재하는 컬럼들을 필드로 가지는 객체를 말함

    즉, 테이블이 가지지 않는 컬럼을 가져서는 안됨

---

✍🏻 DTO

 - Data Transfer Object, 데이터 전송 객체

 - 프로세스 간 데이터를 전달하는 객체

 - DB에서 데이터를 얻어 Service나 Controller 등으로 보낼 때 사용하는 객체

 - 로직을 가지지 않고 Getter/Setter 메서드만을 갖는 순수한 객체

---

📍 User의 있는 정보가 Id, name, email, password 가 있을 때,

      * Password는 관례상, 외부에 노출이 되서는 안되는 정보

 📎 User.java

public class User {
    public Long id;
    public String password;
    public String name;
    public String email;
 }

 📎 UserDto.java

public class UserDto {
    public Long id;
    public String name;
    public String email;
 }

---

🔎 왜 DTO를 쓸까?

 - 외부와 통신하는 프로그램에게 있어 호출은 큰 비용 ! 요청에 따라 비용이 증가함

 - 때문에 한번의 요청에 더 많은 데이터를 전송해야 함 → 이를 위해 데이터를 모아 한 번에 전달할 수 있는 클래스인 DTO 사용

---

🔎 DTO와 Entity를 분리하는 이유 : 관심사의 분리

 

  - Entity의 값이 변하면 Repository에서 DB 값이 반영되고 이는 다른 로직에도 영향을 미침

  - View와 통신하면서 데이터 변경이 많은 DTO 클래스를 분리해주어야 함

 

즉, DB와 상호작용할 때에는 Entity 객체를 사용

      Request, Response 처리할 때는 DTO 객체를 사용

 

여기서 Entity → DTO로, DTO → Entity로 변환해 주기 위해 MapStruct 를 사용 !

 (ModelMapper 클래스도 있지만, 이번 포스팅에서는 MapStruct 사용)

---

✍🏻 MapStruct 

 - DTO와 Entity 간 객체 Mapping을 편하게 도와주는 라이브러리

📎 의존성 추가

implementation 'org.mapstruct:mapstruct:1.4.2.Final'
annotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final'

 - 자바에서 사용할 때는 인터페이스를 만들고 @Mapper 애너테이션을 붙여주면 됨

 - 필드 이름을 기반으로 생성되며 만약 이름이 다르면 @Mapping(sourc="~" , target="~")으로 지정

@Mapper
public interface UserMapper {
    UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);
    
    @Mapping(target="id")
    UserEntity userDtoToEntity(UserDto dto);
    
    UserDto uwerEntityToDto(UserEntity entity);
   
 }

---

✍🏻 Mapper

 - Mapper 클래스는 DTO 클래스와 엔티티 클래스를 서로 변환하는 클래스

    즉, DB에 저장하기 위해 엔티티에 맞게 변환해주는 과정

 - 의존관계는 최대한 약하게 함

 - 컨트롤러와 서비스의 의존은 비용 문제에서 위험함 

    → 서비스 DTO를 만들거나 Mapper를 통해 상호 변환하여 의존관계를 줄여 해결

 📎 Mapper XML

  - Mapper 인터페이스만으로도 충분히 SQL문을 편리하게 처리가 가능함

     But, 복잡하고 길어지는 SQL 문을 사용하는 경우에는 XML 문을 사용하면 좋음