Home Project Lab 6. 게시판 개발(DTO, MapStruct) - 3
Post
Cancel

Project Lab 6. 게시판 개발(DTO, MapStruct) - 3

DTO(Data Transfer Object)

  • 계층간 데이터 교환을 위한 객체(Java Beans)이다.
  • DTO는 데이터 접근만을 위해 사용하는 Domain Model을 복사한 형태로, view에서 부가적으로 사용하는 데이터(멤버 필드)를 추가한 객체다.

DTO를 사용하는 이유

  • 기존 Domain Model은 개발하기 빠르다는 장점이 있다.
  • 하지만 프로젝트의 로직이 복잡해지는 경우, DTO를 사용하면 객체지향 프로그래밍을 할 수 있고, 프론트엔드와 백엔드에서 사용하는 데이터를 명확하게 구분지을 수 있어 추후 유지보수가 쉬워지는 장점이 있다.

객체의 역할을 철저하게 분리하기 위해

  • Domain에 view 로직에서 사용되는 데이터가 포함될 수 있다. 따라서 모든 클래스는 하나의 책임만 가지 객체의 ‘단일 책임 원칙’을 위반하게 된다.

Domain model은 View 계층의 요구사항을 모두 반영할 수 없음

  • Domain은 실제 DB 테이블과 매칭되기에, view의 요구사항을 모두 반영하여 표현하기 어렵다. 만약 요구사항을 모두 반영하게 된다면 객체 간의 결합도가 증가하기 때문에 객체에서 코드를 수정하는 경우 다른 객체에서 코드 수정이 불가피하게 발생할 수 있으며 이를 개발자가 놓치는 경우 버그로 이어질 수 있다.

출처: https://netframework.tistory.com/entry/16-Model-%EA%B8%B0%EC%88%A0-%EC%A0%95%EB%A6%AC-%EB%B0%8F-%EB%B9%84%EA%B5%90
https://gmlwjd9405.github.io/2018/12/25/difference-dao-dto-entity.html

DTO 사용 범위?

  • 구글링한 결과, 이미 많은 개발자들은 ‘DTO의 사용 범위를 어디까지 정해야 하는가?’에 대한 고민을 계속 하였다.
  • ‘DTO를 controller에서만 사용한다? DTO를 service까지 사용한다?’ 등 다양한 의견들이 있었지만, 이에 대한 명확한 해답은 없었다.
  • 프로젝트에서는 service 계층까지 DTO를 사용할 것이며, DTO <-> domain 간 객체 mapping 과정 또한 service 계층에서만 수행할 것이다.

출처: https://velog.io/@aidenshin/DTO%EC%97%90-%EA%B4%80%ED%95%9C-%EA%B3%A0%EC%B0%B0
https://os94.tistory.com/157
https://yonguri.tistory.com/m/entry/Entity-DTO-%EA%B7%B8-%EC%82%AC%EC%9D%B4%EC%9D%98-ModelMapper-%EC%9D%B4%EC%95%BC%EA%B8%B0

Mapstrcut

  • DTO <-> Entity간 객체 mapping 소스 코드를 자동으로 생성하는 라이브러리다.
  • 하단 출처처럼 객체 간 mapping을 지원하는 라이브러리가 많이 존재하지만, 가장 많이 사용하는 ModelMapper와 MapStruct의 처리 속도를 비교한 결과 MapStruct의 속도가 더 빠른 것으로 확인되어 MapStruct를 선택하게 되었다.

출처: https://www.baeldung.com/java-performance-mapping-frameworks

의존성 라이브러리 관리

  • Mapstrcut 의존성 라이브러리를 추가한다.
  • 해당 프로젝트에서 사용하는 mapstruct 버전은 1.3.1이며, lombok 버전은 1.18.12다.
  • Mapstruct의 의존성이 lombok 보다 먼저 선언되어야 한다. 원인은 모르겠지만 의존성 순서가 변경되면 JUnit 테스트시 Mapper 인터페이스의 구현체인 MapperImpl 클래스를 인식하지 못하는 문제가 발생한다.
1
2
3
4
5
6
7
8
9
10
11
<build.gradle>

...
// mapstruct, lombok 의존성보다 먼저 선언되어야 한다.
implementation "org.mapstruct:mapstruct:1.3.1.Final"
annotationProcessor "org.mapstruct:mapstruct-processor:1.3.1.Final"

// lombok
implementation "org.projectlombok:lombok"
annotationProcessor "org.projectlombok:lombok"
...


  • 만약 lombok 버전이 1.18.16 이후인 경우 mapstruct 이슈로 매핑 코드가 생성되지 않으므로 다음과 같이 의존성 라이브러리를 선언해야 한다.
1
2
3
4
5
6
7
8
9
10
11
<build.gradle>

// Mapstruct
implementation "org.mapstruct:mapstruct:1.4.2.Final"
annotationProcessor "org.mapstruct:mapstruct-processor:1.4.2.Final"

// lombok
implementation "org.projectlombok:lombok"
implementation "org.projectlombok:lombok-mapstruct-binding:0.2.0"
annotationProcessor "org.projectlombok:lombok"
annotationProcessor "org.projectlombok:lombok-mapstruct-binding:0.2.0"

출처: https://huisam.tistory.com/entry/mapStruct
https://wise-develop.tistory.com/18

Domain 및 DTO

  • 모든 Mapper 클래스가 공통적으로 사용하는 인터페이스다.
  • DTO <-> Entity간 객체 mapping을 담당하는 MapperImpl 클래스는 EntityMapper 인터페이스를 구현받으며, EntityMapper 인터페이스의 메소드는 Mapstruct에 의해 자동으로 DTO <-> Entity간 객체 mapping 소스 코드가 생성된다.
  • Gradle build 할 때 MapStruct는 자동으로 MapeprImpl 소스 코드를 생성한다. MapperImpl 소스 코드는 Domain 그리고 DTO에 선언된 setter 또는 builder 패턴에 의하여 매핑 코드를 생성한다. setter와 builder 패턴이 동시에 존재하는 경우 setter을 우선적으로 사용한다. 본 프로젝트에서는 Domain에서는 builder 패턴을 사용하였으며, DTO에서는 setter를 사용하여 매핑 코드를 생성gks다.
1
2
3
4
5
6
7
8
9
10
11
12
<module-domain-core/src/main/java/kr/ac/univ/common/dto/mapper/EntityMapper>

package kr.ac.univ.common.dto.mapper;

import java.util.List;

public interface EntityMapper <Dto, Entity> {
   Entity toEntity(Dto dto);
   Dto toDto(Entity entity);
   List<Entity> toEntity(List<Dto> dto);
   List<Dto> toDto(List<Entity> entity);
}


  • NoticeBoard Entity<->DTO간 객체 mapping 소스 코드가 Mapstruct에 의해 생성되도록 메소드를 선언 및 하는 클래스다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<module-domain-core/src/main/java/kr/ac/univ/noticeBoard/NoticeBoardMapper>

package kr.ac.univ.noticeBoard.dto.mapper;

import kr.ac.univ.common.dto.mapper.EntityMapper;
import kr.ac.univ.noticeBoard.domain.NoticeBoard;
import kr.ac.univ.noticeBoard.dto.NoticeBoardDto;
import org.mapstruct.Mapper;
import org.mapstruct.factory.Mappers;

@Mapper(componentModel = "spring")
public interface NoticeBoardMapper extends EntityMapper<NoticeBoardDto, NoticeBoard> {
   NoticeBoardMapper INSTANCE = Mappers.getMapper(NoticeBoardMapper.class);

}


  • Domain 클래스가 공통적으로 사용하는 데이터를 담은 클래스다. 모든 Domain 클래스는 CommonAudit 클래스를 상속 받는다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
<module-domain-core/src/main/java/kr/ac/univ/common/domain/CommonAudit>

package kr.ac.univ.common.domain;

import kr.ac.univ.common.domain.enums.ActiveStatus;
import lombok.Getter;
import lombok.Setter;
import lombok.ToString;
import org.springframework.data.annotation.CreatedDate;
import org.springframework.data.annotation.LastModifiedDate;
import org.springframework.data.jpa.domain.support.AuditingEntityListener;

import javax.persistence.*;
import java.time.LocalDateTime;

@MappedSuperclass
@Getter
@Setter
@ToString
@EntityListeners(AuditingEntityListener.class)
public abstract class CommonAudit {
   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   private Long idx;

   @Column(nullable = false, updatable = false)
   @CreatedDate
   private LocalDateTime createdDate;

   @LastModifiedDate
   private LocalDateTime lastModifiedDate;

   private String createdBy;

   private String lastModifiedBy;

   @Enumerated(EnumType.STRING)
   private ActiveStatus activeStatus;

   private Long views = 0L;
}


  • NoticeBoard에서 사용하는 Domain다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
<module-domain-core/src/main/java/kr/ac/univ/noticeBoard/dto/NoticeBoard>

package kr.ac.univ.noticeBoard.domain;

import kr.ac.univ.common.domain.CommonAudit;
import kr.ac.univ.common.domain.enums.ActiveStatus;
import kr.ac.univ.noticeBoard.listener.NoticeBoardListener;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.ToString;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.EntityListeners;
import javax.persistence.Table;

@Getter
@NoArgsConstructor
@Entity
@Table
@ToString
public class NoticeBoard extends CommonAudit {
   private String title;

   private Long mainPagePriority;

   private String content;

   @Builder
   public NoticeBoard(Long idx, String createdBy, String lastModifiedBy, ActiveStatus activeStatus, String title, Long mainPagePriority, String content) {
       setIdx(idx);
       setCreatedBy(createdBy);
       setLastModifiedBy(lastModifiedBy);
       setActiveStatus(activeStatus);
       this.title = title;
       this.mainPagePriority = mainPagePriority;
       this.content = content;
   }

   public void update(NoticeBoard noticeBoard) {
       setActiveStatus(noticeBoard.getActiveStatus());
       this.title = noticeBoard.getTitle();
       this.mainPagePriority = noticeBoard.getMainPagePriority();
       this.content = noticeBoard.getContent();
   }
}


  • DTO 클래스가 공통적으로 사용하는 데이터를 담은 클래스다. 모든 DTO 클래스는 CommonDto 클래스를 상속 받는다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<module-domain-core/src/main/java/kr/ac/univ/common/dto/CommonDto>

package kr.ac.univ.common.dto;

import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;

import java.time.LocalDateTime;

@Getter
@Setter
@NoArgsConstructor
@ToString
public class CommonDto {
   private Long idx;
   private LocalDateTime createdDate;
   private LocalDateTime lastModifiedDate;
   private String createdBy;
   private String lastModifiedBy;
   private boolean isAccess;
}


  • NoticeBoard에서 사용하는 DTO다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<module-domain-core/src/main/java/kr/ac/univ/noticeBoard/dto/NoticeBoardDto>

import kr.ac.univ.common.domain.enums.ActiveStatus;
import kr.ac.univ.common.dto.CommonDto;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;

@Getter
@Setter
@NoArgsConstructor
@ToString
public class NoticeBoardDto extends CommonDto {
   /* CommonDto: JPA Audit */

   /* 기본 정보 */
   private String title;
   private String content;
   private ActiveStatus activeStatus;
   private Long viewCount;
}


  • Gradle build를 수행하면 다음 이미지와 같이 프로젝트에서 MapperImpl 경로를 자동으로 인식하고 Mapper 인터페이스가 구현되어 MapperImpl 클래스가 자동으로 생성한다.
  • DTO <-> Entity간 객체 mapping을 담당하는 소스 코드가 MapperImpl에 자동으로 생성되기 위해서는, domain에 builder pattern이 구현되야 한다. 자동으로 생성된 MapperImpl 클래스를 확인해 보면, builder pattern을 사용하여 mapping을 수행하는 것을 확인할 수 있다.

image

image

JUnit Test

  • MapperImpl 클래스의 DTO <-> Entity간 객체 mapping을 테스트 하였다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<module-app-web/src/test/java/kr/ac/univ/MapStructTest>

package kr.ac.univ;

import kr.ac.univ.noticeBoard.domain.NoticeBoard;
import kr.ac.univ.noticeBoard.dto.NoticeBoardDto;
import kr.ac.univ.noticeBoard.dto.mapper.NoticeBoardMapper;
import lombok.extern.slf4j.Slf4j;
import org.junit.Assert;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit.jupiter.SpringExtension;


@SpringBootTest
@EnableAutoConfiguration
@ExtendWith(SpringExtension.class)
@Slf4j
public class MapStructTest {

   @Test
   @DisplayName("Mapstrcut 테스트")
   public void Test() {
       NoticeBoardDto noticeBoardDto = new NoticeBoardDto();
       noticeBoardDto.setTitle("제목입니다");
       noticeBoardDto.setContent("글입니다");

       NoticeBoard noticeBoard = NoticeBoardMapper.INSTANCE.toEntity(noticeBoardDto); // DTO -> Entity

       Assert.assertEquals(noticeBoardDto.getTitle(), noticeBoard.getTitle());
       Assert.assertEquals(noticeBoardDto.getContent(), noticeBoard.getContent());
   }
}

Service

  • NoticeBoard의 비즈니스 로직이다.
  • MapStruct를 사용하여 DTO <-> Entitiy간 객체 mapping 소스 코드를 추가하였다.
  • findNoticeBoardList는 페이징 처리하여 NoticeBoard 리스트를 반환하는 메소드다. 해당 메소드에서 Pageable 객체는 Paging을 담당하고 NoticeBoard 리스트를 반환하는 객체로 DTO 변환 과정이 기존과 다르다. 해당 객체를 DTO로 변환하는 소스 코드는 하단 출처를 참고하였다.

출처: https://effectivecode.tistory.com/1220

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
<module-domain-core/src/main/java/kr/ac/univ/noticeBoard/service/NoticeBoardService>

package kr.ac.univ.noticeBoard.service;

import kr.ac.univ.noticeBoard.domain.NoticeBoard;
import kr.ac.univ.noticeBoard.dto.NoticeBoardDto;
import kr.ac.univ.noticeBoard.dto.mapper.NoticeBoardMapper;
import kr.ac.univ.noticeBoard.repository.NoticeBoardRepository;
import kr.ac.univ.noticeBoard.repository.NoticeBoardRepositoryImpl;
import org.springframework.data.domain.*;
import org.springframework.stereotype.Service;

import javax.transaction.Transactional;

@Service
public class NoticeBoardService {
   private final NoticeBoardRepository noticeBoardRepository;
   private final NoticeBoardRepositoryImpl noticeBoardRepositoryImpl;

   public NoticeBoardService(NoticeBoardRepository noticeBoardRepository, NoticeBoardRepositoryImpl noticeBoardRepositoryImpl) {
       this.noticeBoardRepository = noticeBoardRepository;
       this.noticeBoardRepositoryImpl = noticeBoardRepositoryImpl;
   }

   public Page<NoticeBoardDto> findNoticeBoardList(Pageable pageable) {
       Page<NoticeBoard> noticeBoardList = null;

       pageable = PageRequest.of(pageable.getPageNumber() <= 0 ? 0 : pageable.getPageNumber() - 1, pageable.getPageSize(), Sort.Direction.DESC, "idx");
       noticeBoardList = noticeBoardRepository.findAll(pageable);

       return new PageImpl<NoticeBoardDto>(NoticeBoardMapper.INSTANCE.toDto(noticeBoardList.getContent()), pageable, noticeBoardList.getTotalElements());
   }

   public Long insertNoticeBoard(NoticeBoard noticeBoard) {

       return noticeBoardRepository.save(noticeBoard).getIdx();
   }

   public NoticeBoardDto findNoticeBoardByIdx(Long idx) {
       noticeBoardRepositoryImpl.updateViewCountById(idx);

       return NoticeBoardMapper.INSTANCE.toDto(noticeBoardRepository.findById(idx).orElse(new NoticeBoard()));
   }

   @Transactional
   public Long updateNoticeBoard(Long idx, NoticeBoard noticeBoard) {
       noticeBoardRepository.getOne(idx).update(noticeBoard);

       return noticeBoardRepository.save(noticeBoard).getIdx();
   }

   public void deleteNoticeBoardByIdx(Long idx) {
       noticeBoardRepository.deleteById(idx);
   }
}

Controller

  • NoticeBoard 관련 클라이언트의 요청을 view로 매핑한다.
  • Controller에서 view로 전달하는 noticeBoard 변수명을 noticeBoardDto로 변경하였다.
1
2
3
<module-app-web/src/main/java/kr/ac/univ/controller/NoticeBoardController>

model.addAttribute("noticeBoardDtoList", noticeBoardService.findNoticeBoardByIdx(idx));

View

  • NoticeBoard 관련 데이터를 화면에 출력한다.
1
2
3
<module-app-web/src/main/resources/templates/noticeBoard/list, form, read>

<tr th:each="noticeBoardDto : ${noticeBoardDtoList}">
This post is licensed under CC BY 4.0 by the author.

무기체계 소프트웨어의 정적시험 개요

Project Lab 7. 게시판 개발(새로운 글 표시) - 4

Comments powered by Disqus.

Trending Tags