[Spring] Spring MVC

Spring MVC란?

Spring MVC는 Spring Framework에서 제공하는 웹 애플리케이션 개발을 위한 웹 프레임워크이다.

전통적인 Model-View-Controller 패턴을 기반으로 웹 요청을 처리하고 응답을 생성하는 구조로 설계되어 있다.

---

만들어진 배경

• 자바 진영에서는 초창기에 JSP + Servlet 기반의 웹 개발이 주를 이뤘지만, 코드 분리와 재사용성, 테스트 어려움 등의 문제가 있었다.
• Spring Framework는 IoC, DI 등의 개념을 기반으로 경량 프레임워크로 등장했고, 그 안에 웹 요청 처리 구조로 MVC 패턴을 적용한 Spring MVC가 포함되었다.
• 복잡하고 무거운 EJB 대신 가볍고 유연한 웹 개발을 가능하게 하기 위해 도입되었다.

---

특징

1. DispatcherServlet 중심의 요청 처리
   • 모든 웹 요청은 DispatcherServlet이 받아서 적절한 컨트롤러로 라우팅함
2. 핸들러 매핑 (HandlerMapping)
   • 어떤 요청을 어떤 컨트롤러가 처리할지 결정
3. 핸들러 어댑터 (HandlerAdapter)
   • 컨트롤러 메서드 실행을 위한 어댑터 역할
4. 모델과 뷰 분리
   • 비즈니스 로직(Model), 요청 처리(Controller), 화면 렌더링(View)이 명확히 분리됨
5. 유연한 ViewResolver
   • JSP, Thymeleaf, JSON 등 다양한 형태의 뷰를 처리 가능
6. @Controller, @RequestMapping 기반의 선언적 방식
   • Annotation 기반으로 컨트롤러를 쉽게 정의하고 요청 URL을 매핑할 수 있음
7. Validator, BindingResult를 통한 검증 처리 지원
   • 폼 검증 및 에러 처리 지원

---

장점

장점	설명
구조적 명확성	MVC 패턴으로 각 관심사를 분리함
유연한 설정	JavaConfig, XML, Annotation 등 다양한 설정 방식 지원
스프링과의 통합	DI, AOP, 트랜잭션 등 Spring의 모든 기능을 그대로 활용 가능
확장성	인터셉터, 필터, 커스텀 핸들러 등 유연한 확장 구조 보유

 

단점

단점	설명
설정 복잡성	DispatcherServlet, ViewResolver 등 초기에 구성할 요소가 많음
steep learning curve	DI, Bean, Lifecycle 등 Spring 전반에 대한 이해가 필요함
초기 오버헤드	설정 및 구조화 작업이 간단한 CRUD에는 과할 수 있음

 

---

Spring MVC 주요 기능별 동작 원리

 

 

1. DispatcherServlet 중심의 요청 처리

• DispatcherServlet은 Spring MVC의 프론트 컨트롤러 역할을 수행함.
• 모든 클라이언트 요청은 web.xml 또는 Java Config에 설정된 DispatcherServlet으로 진입함.
• 요청 흐름은 다음과 같음:
• (요청 → DispatcherServlet → HandlerMapping → Controller → ModelAndView → ViewResolver → View)
• DispatcherServlet은 모든 컴포넌트를 조율하는 중앙 허브 역할

---

2. HandlerMapping

• 어떤 URL 요청이 어떤 Controller의 어떤 메서드로 연결될지를 결정함.
• Annotation 기반일 경우, @RequestMapping, @GetMapping, @PostMapping 등의 어노테이션이 적용된 메서드를 탐색하여 핸들러로 등록함.
• 내부적으로 RequestMappingHandlerMapping 클래스가 작동함.
• 요청 URL /hello → 해당 메서드와 매핑됨.

@GetMapping("/hello") 
public String hello() { ... }

 

---

3. HandlerAdapter

• HandlerMapping을 통해 결정된 컨트롤러(=핸들러 객체)를 실제로 호출 가능하게 만들어주는 어댑터.
• 다양한 방식의 컨트롤러 구현체를 지원하기 위해 HandlerAdapter가 필요함.
• 일반적으로 @Controller를 사용할 경우에는 RequestMappingHandlerAdapter가 사용됨.

---

4. 모델과 뷰 분리

• 비즈니스 로직(Model), 뷰(View), 요청 처리(Controller)를 명확히 분리하여 유지보수성을 향상시킴.
• Model은 컨트롤러에서 데이터를 담아 View에 전달하는 객체.
• View는 JSP, Thymeleaf, JSON 등 결과를 화면에 출력하는 부분.

model.addAttribute("data", data); // View로 데이터 전달 
return "viewName"; // ViewResolver가 viewName에 해당하는 실제 뷰를 찾음

 

---

5. 유연한 ViewResolver

• 컨트롤러에서 리턴한 논리적인 뷰 이름을 실제 뷰 파일 경로로 변환함.
• 예: return "hello" → /WEB-INF/views/hello.jsp로 변환
• Thymeleaf, JSON 뷰(JSONView), PDF 등 다양한 View 타입도 지원 가능.
• Spring MVC에서는 @ResponseBody나 @RestController를 쓰면 ViewResolver를 거치지 않고 JSON 자체를 응답으로 직렬화(HttpMessageConverter)해서 반환해. 이게 바로 REST API 응답

InternalResourceViewResolver resolver = new InternalResourceViewResolver(); 
resolver.setPrefix("/WEB-INF/views/"); 
resolver.setSuffix(".jsp");

---

6. @Controller, @RequestMapping 기반의 선언적 방식

• 과거 XML 설정 기반의 매핑 방식 대신, Annotation 기반으로 선언적으로 설정할 수 있음.
  

  주요 어노테이션	어노테이션 설명
  @Controller	해당 클래스가 컨트롤러 역할을 한다고 Spring에 알림
  @RequestMapping	URL, HTTP Method 매핑
  @GetMapping	GET 요청 전용 매핑
  @PostMapping	POST 요청 전용 매핑

• Spring이 부팅될 때 스캔하여 빈으로 등록하고, URL 요청 시 해당 메서드 실행.

---

7. Validator, BindingResult를 통한 검증 처리

• @Valid 또는 @Validated를 통해 DTO에 대한 유효성 검사를 수행함.
• 검사 결과는 BindingResult에 담김.
• 검증 실패 시 컨트롤러 내부에서 바로 처리할 수 있음.
• 검증 어노테이션 예시: @NotNull, @Size, @Email, @Pattern 등

public String submit(@Valid @ModelAttribute Form form, BindingResult result) { 
	if (result.hasErrors()) { 
    	return "form"; // 검증 실패 시 다시 폼으로 
    } 
    // 검증 성공 로직
}

기능	동작 원리 요약
DispatcherServlet	모든 요청의 진입점, 흐름을 조율하는 프론트 컨트롤러
HandlerMapping	요청 URL → 어떤 컨트롤러 메서드인지 매핑
HandlerAdapter	매핑된 메서드를 실제로 실행하는 어댑터
모델과 뷰 분리	데이터 처리와 UI 렌더링을 명확히 분리
ViewResolver	논리적 뷰 이름 → 물리적 뷰 경로로 변환
어노테이션 기반 선언 방식	설정을 최소화하고 선언적으로 컨트롤러 구성
유효성 검사	입력 데이터에 대한 검증을 자동 처리 가능