🚩 2.3. 웹 MVC와 JDBC의 결합

🏁 ModelMapper 라이브러리

• TodoDTO의 경우 Lombok을 이용하는 것
  이 더 좋기 때문에 간단하게 다시 구성

• 프로젝트 내에 dto 패키지를 추가하고 TodoDTO 클래스를 선언
  

• TodoDTO와 TodoVO는 완전히 같은 구조를 가지고 있지만, 어노테이션 상의 차이가 존재한다.

• @Data는 getter/setter/toString/equals/hashCode 등을 모두 컴파일 때 생성하는 반면 VO의 경우 getter만을 이용해 읽기 전용으로 구성한다.

✔️ DTO와 VO를 분리하는 이유

1. JPA에서의 사용성을 위함.
2. DTO는 (유효성)검증이나 변환에서 전혀 다른 어노테이션 필요

ModelMapper 라이브러리

• MVN Repository | ModelMapper/3.0.0

// https://mvnrepository.com/artifact/org.modelmapper/modelmapper
implementation 'org.modelmapper:modelmapper:3.0.0'

• ModelMapper 라이브러리
  : DTO ➡️ VO, VO ➡️ DTO 변환 쉽게 보조

• (단, 요즘은 성능상 이점 때문에 MapStruct를 사용한다.)

• VO에 애너테이션 @AllArgsConstructor, @NoArgsConstructor를 추가 적용해야 한다.
  (모든 필드값이 필요한 생성자와 파라미터가 없는 생성자를 적용하여, VO⬅️➡️DTO의 ModelMapper를 통한 변환을 할 수 있게 해주기 위함)

MapperUtil 클래스 생성

• util.MapperUtil 클래스를 추가하여 ModelMapper의 설정을 변경하고 쉽게 사용할 수 있는 MapperUtil을 enum으로 설정

public enum MapperUtil {
    INSTANCE;
    
    private ModelMapper modelMapper;
    
    MapperUtil() {
        this.modelMapper = new ModelMapper();
        				//modelMapper 구성정보 가져오기
        this.modelMapper.getConfiguration()
                .setFieldMatchingEnabled(true) // 필드 매칭 가능
                		//PRIVATE 필드도 접근 가능하도록
                .setFieldAccessLevel(Configuration.AccessLevel.PRIVATE)
                .setMatchingStrategy(MatchingStrategies.STRICT);
    }
    
    public ModelMapper get() {
        return this.modelMapper
    }
}

TodoService와 ModelMapper 테스트

• TodoService는 서비스 계층에서 DTO와 VO를 둘 다 이용해야 한다.
  service.TodoService enum으로 선언.
  

• 테스트 코드를 통한 등록 확인 : service.TodoServiceTests 진행 (140)

🏁 Log4j2와 @Log4j2

• System.out.println()은 로그의 기능으로 적합하지 않다. ❶자원 소모가 많고, ❷휘발성이 있기 때문이다.

• Log4j2는 레벨(level)이라는 설정이 있어 개발할 때, 필요한 레벨의 로그와 실제 운영 시에 필요한 로그를 쉽게 구분할 수 있다.
  
  Lombok은 @Log4j2라는 어노테이션을 이용해서 간단히 소스 코드 내에 로그를 적용할 수 있다.

• Log4j2의 핵심 개념 : ❶레벨(Level) ❷어펜더(Appender)

  • ❶레벨(Level)⚡ : 로그의 '중요도' 로그의 레벨을 지정하면 해당 레벨 이상의 로그들만 출력되기 때문에 개발할 때는 로그의 레벨을 낮게하여 개발하고 운영할 때는 중요한 로그들만 기록하게 설정한다.
    
    
  • ❷어펜더(Appender)⚡ : 로그를 어떤 방식으로 기록할 것인지.
    콘솔(console) 또는 파일(File) 출력이 가능.

• 일반적으로 개발할 때는 Info 이하의 레벨 사용,
  운영할 때는 Error나 Warn이상의 레벨을 사용.

• Log4j2 라이브러리

//log4j관련 의존성 추가
    implementation group: 'org.apache.logging.log4j', name: 'log4j-core', version: '2.17.2'
    implementation group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.17.2'
    implementation group: 'org.apache.logging.log4j', name: 'log4j-slf4j-impl', version: '2.17.2'

log4j2.xml 설정파일

• log4j2.xml 파일로 어펜더나 로그 레벨을 설정할 수 있다. 필요. (파일 명이 반드시 일치해야함.)

• main/resources/log4j2.xml 생성
  log4j2의 자세한 설정 : log4j/2.x/manul/configuration

@Log4j2 어노테이션

• log4j2.xml 설정 확인을 위한 Lombok 수정

  • 기존의 TodoService 코드에 @Log4j2 어노테이션을 추가하고, System.out~ 대신에 log.info() 같은 코드로 변경

package org.zerock.jdbcex.service;

import lombok.extern.log4j.Log4j2;
import org.modelmapper.ModelMapper;
import org.zerock.jdbcex.MapperUtil;
import org.zerock.jdbcex.dao.TodoDAO;
import org.zerock.jdbcex.domain.TodoVO;
import org.zerock.jdbcex.dto.TodoDTO;

@Log4j2 // ⭐
public enum TodoService {
    INSTANCE;

    private TodoDAO dao; // DB와 연계하여 VO를 가져올 역할
    private ModelMapper modelMapper; // VO와 DTO의 변환을 담당

    TodoService() {
        dao = new TodoDAO(); //서비스가 생성될 때 dao 자동 생성
        modelMapper = MapperUtil.INSTANCE.get();
    }

    public void register(TodoDTO todoDTO) throws Exception {
            //⭐modelMapper.map 이라는 메서드 이용하여 DTO -> VO
        TodoVO todoVO = modelMapper.map(todoDTO, TodoVO.class);
        log.info("todoVO: " + todoVO); //⭐ log.info로 변경

        dao.insert(todoVO); //🔥 int를 반환하므로 이를 이용한 예외처리도 가능
    }

}

• 이후 TodoServiceTests testRegister()실행
  

• Log4j2 적용 후 HikariCP의 로그가 다르게 출력되는 이유?
  
  HikariCP가 내부적으로 slf4j 라이브러리를 이용하는데, build.gradle의 log4j-slf4j-impl 라이브러리가 Log4j2를 이용할 수 있도록 설정하기 때문이다.

테스트 환경에서 @Log4j2 사용하기

• 테스트 환경에서 @Log4j2 기능을 활용하기 위해서 테스트 환경에서도 어노테이션을 처리하는 testAnnotationProcessor와 testComplieOnly 설정을 추가해줘야 한다.

• build.gradle

testCompileOnly 'org.projectlombok:lombok:1.18.28'
    testAnnotationProcessor 'org.projectlombok:lombok:1.18.28'

• TodoServiceTests.java

package org.zerock.service;

import lombok.extern.log4j.Log4j2;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.zerock.jdbcex.dto.TodoDTO;
import org.zerock.jdbcex.service.TodoService;

import java.time.LocalDate;

@Log4j2 //⭐
public class TodoServiceTests {

    private TodoService todoService;

    @BeforeEach
    public void ready() {
        todoService = TodoService.INSTANCE;
    }

    @Test
    public void testRegister() throws Exception {
        TodoDTO todoDTO = TodoDTO.builder()
                .title("JDBC Test Title")
                .dueDate(LocalDate.now())
                .build();

        log.info("-------------------------------------"); //⭐ 테스트 코드의 log4j2 설정 확인
        log.info(todoDTO); //⭐

        todoService.register(todoDTO);
    }
}

🏁 컨트롤러와 서비스 객체 연동 (147p)

• 서블릿으로 작성되는 컨트롤러와 TodoService 연동하는 작업을 처리

• 이전 예제들의 구조는 TodoRegisterController와 같이 여러 개의 컨트롤러가 존재하여 하나의 TodoService를 통해 자신이 원하는 기능을 전달하고 처리하는 구조

• jdbcex.controller 패키지 생성

• 구현해야 하는 컨트롤러

• 프로젝트 실행경로 /를 이용하도록 수정, [Deployment] 역시 exploded로 변경

• 변경된 파일의 빠른 재실행
  On 'Update' action : Update classes and resources
  On frame deactivation : Update classes and resources

• build.gradle JSTL 라이브러리 추가

// https://mvnrepository.com/artifact/jstl/jstl
implementation group: 'jstl', name: 'jstl', version: '1.2'

목록 기능 구현 149

• 실제 개발은 DAO -> Service -> Controller의 순서대로 진행하는 것이 일반적

등록 기능 구현 154

조회 기능 구현 158

수정/삭제 기능 구현 162

코드의 개선 사항들

• 여러 개의 컨트롤러를 작성하는 번거로움 - TodoDAO나 TodoService와 달리 HttpServLet을 상속하는 여러 개의 컨트롤러를 작성해야 하는 불편함
• 동일한 로직의 반복적인 사용 - 게시물의 조회나 수정 작업은 둘다 GET 방식으로 동작하지만, 결과를 보여주는 JSP만 다른 형태인 상황. 결국 동일한 코드를 여러 번 작성하는 번거로움이 발생
• 예외 처리의 부재 - 예외가 발생하면 어떤 식으로 처리해야 하는 지에 대한 설계가 없었기 때문에 비정상적인 호출이 발생했을 경우 대비가 안 되는 문제
• 반복적인 메소드 호출 - HttpServletRequest나 HttpServletResponse를 이용해서 TodoDTO를구성하는 작업 등이 동일한 코드들로 작성되어서 이에 대한 개선이 필요하고 Long.parseLong()
  과 같은 코드들도 많이 반복되는 문제

---

출처 및 참고자료 : 자바 웹 개발 워크 북