🔎 Overview

  최근, 테스트의 중요성을 여실히 느끼고 있다.
원래 처음에는 테스트 파일을 따로 생성하여 테스트를 진행하지 않았다. 이유는 간단했다. 잘 사용할 줄 몰랐기 때문에.

  최근 학습을 진행하면서 테스트 파일을 작성하는 법을 체득하고 있다. 처음에는 간단하게 @Autowired로 실제 서비스나 레포지터리를 불러오고 기능이 잘 작동하는지를 테스트하였고, 이후에는 MockMvc를 통한 컨트롤러 테스트 또한 진행하였다.

  테스트 사용법이 조금씩 익숙해지면서, TDD로 기존의 프로젝트를 재구현하는 실습을 진행하며 테스트와 좀 더 친숙해지고 있는 요즘이다.

  개인적으로 처음에 되게 생소하게 느꼈던 것이 바로 컨트롤러 테스트이며, 이를 MockMvc를 이용하여 진행하고 있다.
이 MockMvc가 무엇이며 어떻게 작동하고, 어떻게 응답하는지 정리해보는 시간을 가져보았다.

---

📕 MockMvc

• 컨트롤러를 테스트할 때, Servlet Container , 즉 실제 서버를 띄우지 않고도 컨트롤러 레이어를 테스트할 수 있도록 도와주는 도구
• Spring MVC 의 요청-응답 흐름을 시뮬레이션하며, 컨트롤러가 예상대로 동작하는지 확인하는 과정
• HTTP 요청 및 응답을 Mocking해서 테스트 환경을 단순화
  
  
  

🔎 MockMvc를 사용한 컨트롤러 테스트의 목적

1. 요청-매핑 검증

• 클라이언트로부터 URI 요청이 올 때, 이것이 올바른 Handler Method 로 매핑되는지 확인
• ex) /api/v1/member/login URI 를 요청받았을 때, 이를 처리하는 메서드로 잘 연결되는가
  
  

2. 핸들러 메서드 로직 테스트

• 매핑된 컨트롤러 메서드가 올바른 결과를 반환하는지 확인하기 위함
  
  

3. 예외 처리 검증

• 잘못된 요청 및 비정상적 입력에 대한 예외 처리
• 정의된 에러 응답을 반환하는지 확인
  
  
  

🔗 Mock과 DispatcherServlet

• MockMvc 는 실제 서블릿 컨테이너는 구동하지 않지만, DispatcherServlet 의 핵심 로직을 Mock 환경에서 동작시킴
  • ServletContainer : Tomcat, Jetty 등, 실제 HTTP 요청을 처리하고 서블릿을 실행하는 환경
  • MockMvc 는 이러한 실제 HTTP 요청 대신, MockHttpServletRequest 와 MockHttpServletResponse 를 사용하여 DispatcherServlet 내부 로직 호출
• DispatcherServlet 은 서블릿 컨테이너 없이도 Spring MVC 의 요청-응답 처리 과정을 시뮬레이션 가능
  
  
  

➡️ 동작 방식

1. Mock 요청 생성

• MockMvc 는 실제 HTTP 요청이 아닌, MockHttpServletRequest 를 생성
  
  

2. DispatcherServlet 호출

• DispatcherServlet 인스턴스를 Mock 환경에서 초기화
• service() 메서드 호출
  • 서블릿 컨테이너 없이 DispatcherServlet 내부 로직 실행
    
    

3. 핸들러 매핑 및 실행

• DispatcherServlet 은 핸들러 매핑을 통해 요청 URL에 맞는 컨트롤러를 찾고, 해당 컨트롤러 메서드(핸들러 메서드, 액션 메서드)를 실행
  
  

4. Mock 응답 반환

• 컨트롤러 메서드의 반환값은 MockHttpServletResponse 에 담겨 응답 객체로 사용

---

✒️ MockMvc 사용

1. MockMvc 생성

@SpringBootTest
@AutoConfigureMockMvc
public class MockControllerTest() {
	@Autowired
    private MockMvc mvc;
    
    @Test
    void t1() {
    	ResultActions resultActions = mvc.perform(...);
    }
}

• AutoConfigureMockMvc 를 통해 MockMvc 를 사용할 수 있도록 설정
• 테스트 환경에서는 AllArgsConstructor , RequiredArgsConstructor 등을 사용할 수 없으므로, @Autowired 를 통해 DI 로 MockMvc 주입
• perform() 메서드를 통해 URL 요청, 결과를 ResultActions 객체로 받아옴
  
  

2. HTTP 요청 메서드

resultActions = mvc.perform(
	get("/api/v1/posts")
);

resultActions = mvc.perform(
	delete("/api/v1/posts/1")
);

• HTTP 요청 메서드를 선택
• get(String url) : Get 요청
• post(String url) : Post 요청
• put(String url) : Put 요청
• delete(String url) : Delete 요청
• patch(String url) : Patch 요청
  
  

3. andExpect()

mvc.perform(
	delete("/api/v1/posts/1")
)
.andExpect(status().isOk());

• 요청 결과를 검증하기 위해 사용
• status() : 응답 상태 코드 검증
• header() : 응답 헤더 검증
• handler() : 응답 핸들러 검증
• jsonPath() : JSON 응답의 특정 필드 검증
  
  

4. andDo()

mvc.perform(
	get("/api/v1/posts")
)
.andDo(print());

• 요청 및 응답 결과를 출력하거나 추가 작업 진행
• 디버깅 용도로 주로 사용
  
  

5. header()

String apiKey = UUID.randomUUID().toString();

mvc.perform(
	post("/api/v1/posts")
    	.header("Authorization", "Bearer " + apiKey)
);

• HTTP 헤더 추가
• 쿠키 확인 및 검증 등에 주로 사용
  
  

6. content(), contentType()

mvc.perform(
	post("/api/v1/posts")
    	.content("""
        		{
                	"title": "제목",
                    "content": "내용"
                }
                """)
        .contentType(new MediaType(MediaType.APPLICATION_JSON, StandardCharsets.UTF_8))
);

• content() : 요청에 본문 추가
• contentType() : 본문 파일 형식 및 인코딩 방식 지정

---

참고) OpenAI. (2024).ChatGPT(4o)[Large language model].https://chatgpt.com/