[SpringBoot/JPA] ModelMapper로 Entity와 DTO 변환하기

📌환경

IntelliJ Ultimate

Java 17

 

Spring boot 3.2.3

Gradle - Groovy

Dependencies: 

Spring Web

Thymeleaf

Spring Data JPA

lombok

MariaDB 10.11

Spring Dev tool

 

📌ModelMapper란?

서로 다른 클래스의 값을 한번에 복사(매핑)할 수 있도록 도와주는 라이브러리. 예를 들어, 영속성 컨텍스트와 일치하는 엔티티 객체가 있고 이 값을 DTO에 담거나 혹은 그 반대의 작업을 처리하려고 할 때, 필드를 하나씩 매핑시킨다면 누락되거나 값이 변질되는 문제가 발생할 수 있다. `modelMapper`를 사용하면 엔티티와 DTO의 변환을 간단히 처리할 수 있다.

 

 

📌흐름

1. `build.gradle`에 `modelMapper`의존성을 추가한다.

2. `configuration` 클래스를 작성한다.

 

📌구현

`build.gradle`에 의존성을 추가한다.

 

dependencies{
  .
  .
  .
  implementation 'org.modelmapper:modelmapper:3.1.0'
}

 

 

config 패키지에 `RootConfig` 클래스를 추가한다.

 

package org.zerock.b02.config;

import org.modelmapper.ModelMapper;
import org.modelmapper.convention.MatchingStrategies;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class RootConfig {

    @Bean
    public ModelMapper getMapper(){
        ModelMapper modelMapper = new ModelMapper();
        modelMapper.getConfiguration()
                .setFieldMatchingEnabled(true)
                .setFieldAccessLevel(org.modelmapper.config.Configuration.AccessLevel.PRIVATE)
                .setMatchingStrategy(MatchingStrategies.LOOSE);

        return modelMapper;
    }
}

 

 

 

dto 패키지에 `BoardDTO`를 추가한다. 필드는 `Board`와 동일하다.

 

package org.zerock.b02.dto;

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.time.LocalDateTime;

@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class BoardDTO {

    private Long bno;
    private String title;
    private String content;
    private String writer;
    private LocalDateTime regDate;
    private LocalDateTime modDate;
}

 

 

 

✍️ CREATE(INSERT)

service 패키지에 `BoardService` 인터페이스와 그 구현체를 작성한다.

 

package org.zerock.b02.service;

import jakarta.transaction.Transactional;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.modelmapper.ModelMapper;
import org.springframework.stereotype.Service;
import org.zerock.b02.domain.Board;
import org.zerock.b02.dto.BoardDTO;
import org.zerock.b02.repository.BoardRepository;

@Service
@Slf4j
@RequiredArgsConstructor
@Transactional
public class BoardServiceImpl implements BoardService{

    private final ModelMapper modelMapper;
    private final BoardRepository boardRepository;

    @Override
    public Long register(BoardDTO boardDTO) {
        Board board = modelMapper.map(boardDTO, Board.class);

        Long bno = boardRepository.save(board).getBno();

        return bno;

    }
}

 

 

여러 번의 데이터베이스 연결이 있을 수 있으므로 트랜잭션 처리를 기본적으로 적용해야한다.

게시글 작성 후에는 방금 작성한 게시글로 이동해야하기 때문에 bno가 필요하다.

 

 

 

 

테스트 코드

 

package org.zerock.b02.service;

import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.zerock.b02.dto.BoardDTO;

@SpringBootTest
@Slf4j
public class BoardServiceTests {

    @Autowired
    private BoardService boardService;

    @Test
    public void registerTest(){

//        여러 번의 데이터베이스 연결이 있을 수 있으므로 트랜잭션 처리를 기본적으로 적용해야함
//        @Transactional 애노테이션을 적용했기 때문에 스프링이 해당 객체를 감싸는 별도의 클래스를 만듦
//        [boardService class name] org.zerock.b02.service.BoardServiceImpl$$SpringCGLIB$$0
        log.info("[boardService class name] " + boardService.getClass().getName());

        BoardDTO boardDTO = BoardDTO.builder()
                .title("Sample title...")
                .content("Sample content...")
                .writer("user00")
                .build();

        Long bno = boardService.register(boardDTO);

        log.info("[after register bno] " + bno);
    }
}

 

 

2024-03-13T00:21:59.047+09:00  INFO 60814 --- [b02] [    Test worker] o.zerock.b02.service.BoardServiceTests   : [after register bno] 101

 

 

 

DB에 잘 들어갔고 bno이 진짜 뽑힘 ㄷㄷ 어케 한 거지 (24/03/13) 공부할 것

 

 

 

📎 READ(SELECT)

 

// BoardServiceImpl

    @Override
    public BoardDTO readOne(Long bno) {

        Optional<Board> result = boardRepository.findById(bno);

    //        데이터베이스와 완전히 일치하는 엔티티 객체
        Board board = result.orElseThrow();

    //        엔티티 -> dto 변환
        BoardDTO boardDTO = modelMapper.map(board, BoardDTO.class);

        return boardDTO;
    }

 

   @Test
    public void readOneTest(){
        Long bno = 101L;

        BoardDTO boardDTO = boardService.readOne(bno);

        log.info("[readOne] " + boardDTO);
    }

 

2024-03-13T00:31:42.667+09:00  INFO 60964 --- [b02] [    Test worker] o.zerock.b02.service.BoardServiceTests   : [readOne] BoardDTO(bno=101, title=Sample title..., content=Sample content..., writer=user00, regDate=2024-03-13T00:21:59.022021, modDate=2024-03-13T00:21:59.022021)

 

 

 

📝 UPDATE

 

    // BoardService

    @Override
    public void modify(BoardDTO boardDTO) {
        Optional<Board> result = boardRepository.findById(boardDTO.getBno());

        Board board = result.orElseThrow();

        board.update(boardDTO.getTitle(), boardDTO.getContent());

        boardRepository.save(board);
    }

 

  @Test
    public void modifyTest(){

        BoardDTO boardDTO = BoardDTO.builder()
                .bno(101L)
                .title("modified Title...")
                .content("modified Content...")
                .build();

        boardService.modify(boardDTO);
    }

 

 

 

🔪 DELETE

 

 @Override
    public void remove(Long bno) {
        boardRepository.deleteById(bno);
    }

 

 

 

📌참고

자바 웹 개발 워크북 - 구멍가게 코딩단