1. 스프링 MVC 전체 구조

- 스프링 MVC의 프론트 컨트롤러는 디스패처 서블릿(DispatcherServlet)이다.
- DispatcherServlet은 부모 클래스에서 HttpServlet을 상속 받아서 사용하고, 서블릿으로 동작한다.
- 스프링 부트는 DispatcherServlet을 서블릿으로 자동으로 등록하면서 모든 경로(urlPatterns="/")에 대해서 매핑한다.
- 스프링 MVC의 큰 강점은 DispatcherServlet코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다.
동작순서
핸들러 조회: 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러)를 조회한다.
핸들러 어댑터 조회: 핸들러를 실행할 수 있는 핸들러 어댑터를 조회한다.
핸들러 어댑터 실행: 핸들러 어댑터를 실행한다.
핸들러 실행: 핸들러 어댑터가 실제 핸들러를 실행한다.
ModelAndView 반환: 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다.
viewResolver 호출: 뷰 리졸버를 찾고 실행한다.
View 반환: 뷰 리졸버는 뷰의 논리 이름을 물리 이름으로 바꾸고, 렌더링 역할을 담당하는 뷰 객체를 반환한다.
뷰 렌더링: 뷰를 통해서 뷰를 렌더링 한다.
2. 핸들러 매핑과 핸들러 어댑터
스프링 부트가 자동 등록하는 핸들러 매핑과 핸들러 어댑터
HandlerMapping
- RequestMappingHandlerMapping: 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
- BeanNameUrlHandlerMapping: 스프링 빈의 이름으로 핸들러를 찾는다.
HandlerAdapter
- RequestMappingHandlerAdapter: 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
- HttpRequestHandlerAdapter: HttpRequestHandler 처리
- SimpleControllerHandlerAdapter: Controller 인터페이스(애노테이션X, 과거에 사용) 처리
@Component("/springmvc/old-controller")
public class OldController implements Controller {
@Override
public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
System.out.println("OldController handleRequest");
return null;
}
}
① 핸들러 매핑으로 핸들러 조회
- HandlerMapping을 순서대로 실행해서, 핸들러를 찾는다.
- 이 경우 빈 이름으로 핸들러를 찾아야 하기 때문에 이름 그대로 빈 이름으로 핸들러를 찾아주는 BeanNameUrlHandlerMapping이 실행에 성공하고 핸들러인 OldController를 반환한다.
② 핸들러 어댑터 조회
- HandlerAdapter의 supports()를 순서대로 호출한다.
- SimpleControllerHandlerAdapter가 Controller 인터페이스를 지원하므로 대상이 된다.
③ 핸들러 어댑터 실행
- 디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter를 실행하면서 핸들러 정보도 함께 넘겨준다.
- SimpleControllerHandlerAdapter는 핸들러인 OldController를 내부에서 실행하고, 그 결과를 반환한다.
정리
- OldController를 실행하면서 사용된 객체는 다음과 같다.
- HandlerMapping = BeanNameUrlHandlerMapping
- HandlerAdapter = SimpleControllerHandlerAdapter
3. 뷰 리졸버
스프링 부트가 자동 등록하는 뷰 리졸버
- BeanNameViewResolver: 빈 이름으로 뷰를 찾아서 반환한다. (예: 엑셀 파일 생성 기능에 사용)
- InternalResourceViewResolver: JSP를 처리할 수 있는 뷰를 반환한다.
@Component("/springmvc/old-controller")
public class OldController implements Controller {
@Override
public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
System.out.println("OldController handleRequest");
return new ModelAndView("new-form");
}
}
//application.properties
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp
① 핸들러 어댑터 호출
- 핸들러 어댑터를 통해 new-form이라는 논리 뷰 이름을 획득한다.
② ViewResolver 호출
- new-form이라는 뷰 이름으로 viewResolver를 순서대로 호출한다.
- BeanNameViewResolver는 new-form이라는 이름의 스프링 빈으로 등록된 뷰를 찾아야 하는데 없다.
- InternalResourceViewResolver가 호출된다.
③ InternalResourceViewResolver
- 이 뷰 리졸버는 InternalResourceView를 반환한다.
④ 뷰 - InternalResourceView
- InternalResourceView는 JSP처럼 포워드 forward()를 호출해서 처리할 수 있는 경우에 사용한다.
⑤ view.render()
- view.render()가 호출되고 InternalResourceView는 forward()를 사용해서 JSP를 실행한다.
참고
- 다른 뷰는 실제 뷰를 렌더링하지만, JSP의 경우 forward()를 통해서 JSP로 이동해야 렌더링이 된다.
- Thymeleaf 뷰 템플릿을 사용하면 ThymeleafViewResolver를 등록해야 한다. 최근에는 라이브러리만 추가하면 스프링 부트가 이런 작업도 모두 자동화해준다.
4. 컨트롤러
@RequestMapping 애노테이션을 사용하는 컨트롤러
- HandlerMapping = RequestMappingHandlerMapping
- HandlerAdapter = RequestMappingHandlerAdapter
- 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 핸들러 매핑과 어댑터이다.
- 실무에서는 거의 이 방식의 컨트롤러를 사용한다.
@Controller
@RequestMapping("/springmvc/v2/members")
public class SpringMemberControllerV2 {
private MemberRepository memberRepository = MemberRepository.getInstance();
@RequestMapping("/new-form")
public ModelAndView newForm() {
return new ModelAndView("new-form");
}
@RequestMapping("/save")
public ModelAndView save(HttpServletRequest request, HttpServletRequest response) {
String username = request.getParameter("username");
int age = Integer.parseInt(request.getParameter("age"));
Member member = new Member(username, age);
memberRepository.save(member);
ModelAndView mv = new ModelAndView("save-result");
mv.addObject("member", member);
return mv;
}
@RequestMapping
public ModelAndView members() {
List<Member> members = memberRepository.findAll();
ModelAndView mv = new ModelAndView("members");
mv.addObject("members", members);
return mv;
}
}
@Controller
- 스프링이 자동으로 스프링 빈으로 등록한다.
- 스프링 MVC에서 애노테이션 기반 컨트롤러로 인식한다.
@RequestMapping
- 요청 정보를 매핑한다.
- 해당 URL이 호출되면 이 메서드가 호출된다.
- 애노테이션을 기반으로 동작하기 때문에, 메서드의 이름은 임의로 지으면 된다.
- 클래스 레벨과 메서드 레벨의 경로가 합쳐진다. ("/spring/v2/members" + "/new-form" ㅡ> "/spring/v2/members/new-form")
ModelAndView
- 모델과 뷰 정보를 담아서 반환하면 된다.
mv.addObject()
- ModelAndView를 통해 Model 데이터를 추가할 때는 addObject()를 사용하면 된다.
- 이 데이터는 이후 뷰를 렌더링 할 때 사용된다.
5. 실용적인 컨트롤러
@Controller
@RequestMapping("/springmvc/v3/members")
public class SpringMemberControllerV3 {
private MemberRepository memberRepository = MemberRepository.getInstance();
@GetMapping("new-form")
public String newForm() {
return "new-form";
}
@PostMapping("/save")
public String save(
@RequestParam("username") String username,
@RequestParam("age") int age,
Model model) {
Member member = new Member(username, age);
memberRepository.save(member);
model.addAttribute("member", member);
return "save-result";
}
@GetMapping
public String members(Model model) {
List<Member> members = memberRepository.findAll();
model.addAttribute("members", members);
return "members";
}
}
- Model 파라미터 + addAttribute() 사용
- ModelAndView 대신 String으로 ViewName 직접 반환
- @RequestParam으로 HTTP 요청 파라미터 받기
- @RequestMapping ㅡ> @GetMapping, @PostMapping
'Spring' 카테고리의 다른 글
[스프링 MVC - 백엔드 웹 개발 핵심 기술] 07. 웹 페이지 만들기 (0) | 2025.02.19 |
---|---|
[스프링 MVC - 백엔드 웹 개발 핵심 기술] 06. 스프링 MVC 기본 기능 (0) | 2025.02.17 |
[스프링 MVC - 백엔드 웹 개발 핵심 기술] 04. MVC 프레임워크 만들기 (1) | 2025.02.09 |
[스프링 MVC - 백엔드 웹 개발 핵심 기술] 03. 서블릿, JSP, MVC 패턴 (1) | 2025.02.07 |
[스프링 MVC - 백엔드 웹 개발 핵심 기술] 02. 서블릿 (0) | 2025.02.06 |