HTTP 상태코드 / Exception 관리

1. 상태코드

1-1. 전체적인 구조

2. Exception 관리

2-1. GlobalExceptionHandler

package shop.mtcoding.blog.core.error;

import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import shop.mtcoding.blog.core.error.ex.*;
import shop.mtcoding.blog.core.util.Script;

@RestControllerAdvice  // 모든 throw가 이쪽으로 날라옴, 무조건 데이터로 응답
public class GlobalExceptionHandler {

    // 유효성 검사 실패 (잘못된 클라이언트의 요청)
    @ExceptionHandler(Exception400.class)
    public String ex400(Exception e) {
        return Script.back(e.getMessage());
    }

    // 인증 실패 (클라이언트가 인증 없이 요청했거나, 인증 도중 실패
    @ExceptionHandler(Exception401.class)
    public String ex401(Exception e) {
        return Script.href("인증되지 않았습니다", "/login-form");
    }

    // 권한 실패 (인증은 되어있으나, 삭제하려는 게시글이 내가 적은 글이 아님)
    @ExceptionHandler(Exception403.class)
    public String ex403(Exception e) {
        return Script.back(e.getMessage());
    }

    // 서버에서 리소스(자원)를 찾을 수 없을 때
    @ExceptionHandler(Exception404.class)
    public String ex404(Exception e) {
        return Script.back(e.getMessage());
    }

    // 서버에서 심각한 오류 발생시 (알고 있을 때)
    @ExceptionHandler(Exception500.class)
    public String ex500(Exception e) {
        return Script.back(e.getMessage());
    }

    // 서버에서 심각한 오류 발생시 (모를 때)
    @ExceptionHandler(Exception.class)
    public String ex(Exception e) {
        return Script.back(e.getMessage());
    }
}

2-2. Test 코드 (게시글 삭제 테스트)

• try-catch 사용 테스트

@Test
public void deleteById_test() {
    int id = 6;

    try {
        boardRepository.deleteById(id);
        boardRepository.findById(id);
    } catch (Exception e) {
        Assertions.assertThat(e.getMessage()).isEqualTo("게시글 id를 찾을 수 없습니다");
    }
}

// deleteById 메소드 호출 후, 해당 게시글이 삭제되었는지 확인하기 위해 findById 메소드 호출. 
// 만약 게시글이 존재하지 않으면 Exception404가 발생해야 하며, 이를 try-catch 블록으로 잡아서 테스트.

• Service & Repository 레이어에서의 예외 처리 및 트랜잭션 관리

@Transactional
public void 게시글삭제(int id, User sessionUser) {
    Board board = boardRepository.findById(id);

    if (sessionUser.getId() != board.getUser().getId()) {
        throw new Exception403("권한이 없습니다");
    }

    boardRepository.deleteById(id);
}

// '게시글삭제' 메소드는 먼저 게시글의 존재 여부를 확인하고, 권한이 있는지 검사한 후에 삭제 작업. 
// 각 단계에서 조건이 만족되지 않으면 적절한 예외를 발생시킴

• 게시글 조회 Repository (BoardRepository의 findById 메소드)

public Board findById(int id) {
    Query query = em.createQuery("SELECT b FROM Board b JOIN fetch b.user u WHERE b.id = :id", Board.class);
    query.setParameter("id", id);
    try {
        Board board = (Board) query.getSingleResult();
        return board;
    } catch (Exception e) {
        e.printStackTrace();
        throw new Exception404("게시글 id를 찾을 수 없습니다");
    }
}


// 'findById' 메소드는 JPQL을 사용하여 게시글을 조회, 게시글이 존재하지 않으면 Exception404 발생 시킴.

• Service 테스트

@Test
public void 게시글삭제_test() {
    int id = 1;
    User sessionUser = new User();
    sessionUser.setId(2);  // 권한이 없는 사용자

    try {
        boardService.게시글삭제(id, sessionUser);
    } catch (Exception e) {
        Assertions.assertThat(e).isInstanceOf(Exception403.class);
    }
}

// '게시글삭제' 메소드가 사용자의 권한을 확인하여 권한이 없을 경우 Exception403이 발생하는지 테스트

• Repository 테스트

@Test
public void findById_test() {
    int id = 1;

    Assertions.assertThatThrownBy(() -> boardRepository.findById(id))
        .isInstanceOf(Exception404.class)
        .hasMessage("게시글 id를 찾을 수 없습니다");
}

// 'findById' 메소드가 존재하지 않는 게시글 조회시, 적절한 예외를 발생시키는지 확인

결론

• try-catch의 중요성

• 예외 처리 & 단위 테스트