Spring

[스프링 MVC - 백엔드 웹 개발 핵심 기술] 05. 스프링 MVC 구조 이해

binning 2025. 2. 13. 00:16

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