Day 57 - Contract pt.2

이 글은 2026년 05월 26일 작성된 글입니다.

오늘은 REST API 테스트를 더 정교하게 다듬고, 예외 처리와 HTTP 상태코드 처리, 그리고 IoC 컨테이너의 BeanDefinition 구조를 확장하는 작업을 진행했다.

1. 글 수정 테스트케이스 보강

글 수정 API 테스트를 더 강화했다.

기존에는 응답만 확인했다면, 이제는 실제로 수정된 데이터가 DB에 반영되었는지도 검증했다.

assertThat(post.getTitle()).isEqualTo("수정된 제목");

2. 테스트 검증 범위

REST API 테스트에서 어디까지 검증해야 하는지 기준을 정리했다.

필수

응답 JSON 구조와 필드값 검증

{
  "resultCode": "200-1",
  "msg": "글 수정 완료"
}

선택

실제 DB 조회 후 데이터 검증

Post post = postService.findById(1);

응답 구조 검증은 필수, DB 반영 여부까지 확인하는 것은 상황에 따라 선택이다.

3. 글 삭제 테스트

글 삭제 API 테스트를 추가했다.

mockMvc.perform(delete("/api/v1/posts/1"))

4. 단건 조회 테스트

단건 조회 테스트도 추가했다.

.andExpect(jsonPath("$.data.id").value(1))

5. 다건 조회 테스트

게시글 목록 조회 테스트를 구현했다.

.andExpect(jsonPath("$.data.length()").value(3))

6. Postman baseURL 변수

Postman Collection에 baseURL 변수를 추가했다.

{{baseURL}}/api/v1/posts

7. 존재하지 않는 글 조회

존재하지 않는 글 조회 시 404 응답을 반환하도록 수정했다.

return ResponseEntity.status(404).body(rsData);

8. Validation 예외 처리

제목 없이 글 작성 시 400 Bad Request가 발생하도록 구현했다.

@NotBlank
private String title;

9. MethodArgumentNotValidException 처리

유효성 검증 실패 시 발생하는 예외를 처리했다.

@ExceptionHandler(MethodArgumentNotValidException.class)

10. FieldError 메세지 처리

검증 에러를 문자열 형태로 정리했다.

.map(error -> error.getField()
        + "-" + error.getCode()
        + "-" + error.getDefaultMessage())

11. 잘못된 JSON 처리

JSON 형식이 잘못된 경우에도 400 응답을 반환하도록 처리했다.

12. 댓글 단건조회 테스트

댓글 API 테스트도 시작했다.

/api/v1/posts/1/comments/2

13. 댓글 다건조회 테스트

댓글 목록 조회 테스트 추가.

/api/v1/posts/1/comments

14. BeanDefinition 메서드 기반 생성

@Bean 메서드 기반 생성도 처리할 수 있도록 확장했다.

new BeanDefinition<>(
    TestJacksonConfig.class,
    "testBaseJavaTimeModule"
);

15. 생성 의존성이 있는 BeanDefinition

assertThat(beanDefinition.getParameterNames())
    .containsExactly("testBaseJavaTimeModule");

✅ 정리

• REST API 테스트에서는 응답 JSON 구조 검증이 가장 중요하다.
• Validation 예외는 MethodArgumentNotValidException으로 처리할 수 있다.
• ResponseEntity를 사용하면 상태코드와 응답 구조를 더 유연하게 관리할 수 있다.
• BeanDefinition이 확장되면서 @Bean 메서드 기반 빈 생성도 처리할 수 있게 되었다.