[Spring MVC] [1] 5. 스프링 MVC - 구조 이해

55608 단어 TILspringMVCTIL

[1] 스프링 MVC 전체 구조

이전 게시물까지 직접 프레임 워크를 만들었었는데 스프링 MVC와 비교해보자

📌 바뀐 부분

직접 만든 프레임워크스프링 MVC
FrontController → DispatcherServlet
handlerMappingMap → HandlerMapping
MyHandlerAdapter → HandlerAdapter
ModelView → ModelAndView
viewResolver → ViewResolver
MyView → View

DispatcherServlet 구조

스프링 MVC도 프론트 컨트롤러 패턴으로 구현돼 있다.
스프링 MVC 프론트 컨트롤러 = 디스패처 서블릿(⭐️ 스프링 MVC 핵심)

DispacherServlet도 부모 클래스에서 HttpServlet을 상속받아 사용하고 서블릿으로 동작함.
: DispatcherServlet → FrameworkServlet → HttpServletBean → HttpServlet

스프링부트는 DispacherServlet을 서블릿으로 자동등록하며 모든 경로에 대해 매핑. (더 자세한 경로가 우선이기 때문에 기존에 등록한 서블릿도 함께 동작)

요청 흐름

  1. 서블릿 호출 → HttpServlet이 제공하는 service() 호출
  2. 스프링 MVC는 FrameworkServlet(DispatcherServlet의 부모)에서 service()를 오버라이드
  3. FrameworkServlet.service()를 시작으로 여러 메소드 호출 → DispacherServlet.doDispatch() 호출

SpringMVC 동작 순서

  1. 핸들러 조회: 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러)를 조회
  2. 핸들러 어댑터 조회: 핸들러를 실행할 수 있는 핸들러 어댑터를 조회
  3. 핸들러 어댑터 실행: 핸들러 어댑터를 실행
  4. 핸들러 실행: 핸들러 어댑터가 실제 핸들러를 실행
  5. ModelAndView 반환: 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서
    반환
  6. viewResolver 호출: 뷰 리졸버를 찾고 실행
    (JSP의 경우: InternalResourceViewResolver 가 자동 등록되고, 사용)
  7. View 반환: 뷰 리졸버는 뷰의 논리이름을 물리이름으로 바꾸고, 렌더링 역할을 담당하는 뷰 객체를 반환
    (JSP의 경우: InternalResourceView(JstlView) 를 반환하는데, 내부에 forward() 로직이 있음)
  8. 뷰 렌더링: 뷰를 통해서 뷰를 렌더링

📌 주요 인터페이스

  • 핸들러 매핑 org.springframework.web.servlet.HandlerMapping
  • 핸들러 어댑터 org.springframework.web.servlet.HandlerAdapter
  • 뷰 리졸버 org.springframework.web.servlet.ViewResolver
  • org.springframework.web.servlet.View

[2] 핸들러 매핑과 핸들러 어댑터

과거에 주로 사용했던 스프링이 제공하는 간단한 컨트롤러로 핸들러 매핑과 어댑터 이해하기.

✔️ OldController

package hello.servlet.web.springmvc.old;

import org.springframework.stereotype.Component;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@Component("/springmvc/old-controller") // 스프링 이름을 url 이름으로 맞춘 것
public class OldController implements Controller {

    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        System.out.println("OldController.handleRequest");
        return null;
    }
}

➡️ 빈의 이름으로 URL 매핑

📌 컨트롤러 호출을 위한 두 가지

  • HandlerMapping
    : 핸들러 매핑에서 이 컨트롤러를 찾을 수 있어야 함. (스프링 빈 이름으로 핸들러를 찾을 수 있는 핸들러 매핑 필요)
  • HandlerAdapter
    : 핸들러 매핑을 통해 찾은 핸들러를 실행할 핸들러 어댑터 필요. (Controller 인터페이스를 실행할 핸들러 어댑터를 찾고 실행)

스프링 부트가 자주 사용하는 핸들러 매핑과 핸들러 어댑터

✔️ HandlerMapping
0 = RequestMappingHandlerMapping : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = BeanNameUrlHandlerMapping : 스프링 빈의 이름으로 핸들러를 찾는다.

✔️ HandlerAdapter
0 = RequestMappingHandlerAdapter : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = HttpRequestHandlerAdapter : HttpRequestHandler 처리
2 = SimpleControllerHandlerAdapter : Controller 인터페이스(애노테이션X, 과거에 사용) 처리

1. 핸들러 매핑으로 핸들러 조회
HandlerMapping 을 순서대로 실행해서, 핸들러를 찾는다.
이 경우 빈 이름으로 핸들러를 찾아야 하기 때문에 이름 그대로 빈 이름으로 핸들러를 찾아주는 BeanNameUrlHandlerMapping 가 실행에 성공하고 핸들러인 OldController 를 반환한다.

2. 핸들러 어댑터 조회
HandlerAdapter 의 supports() 를 순서대로 호출한다. SimpleControllerHandlerAdapter 가 Controller 인터페이스를 지원하므로 대상이 된다.

3. 핸들러 어댑터 실행
디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter 를 실행하면서 핸들러 정보도 함께 넘겨준다.
SimpleControllerHandlerAdapter 는 핸들러인 OldController 를 내부에서 실행하고, 그 결과를 반환한다.

✔️ MyHttpRequestHandler

HttpRequestHandler 핸들러는 서블릿과 가장 유사한 형태의 핸들러(컨트롤러)

package hello.servlet.web.springmvc.old;

import org.springframework.stereotype.Component;
import org.springframework.web.HttpRequestHandler;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@Component("/springmvc/request-handler")
public class MyHttpRequestHandler implements HttpRequestHandler {
    @Override
    public void handleRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("MyHttpRequestHandler.handleRequest");   // soutm
    }
}

1. 핸들러 매핑으로 핸들러 조회
HandlerMapping 을 순서대로 실행해서, 핸들러를 찾는다.
이경우빈이름으로핸들러를찾아야하기때문에이름그대로빈이름으로핸들러를찾아주는 BeanNameUrlHandlerMapping 가 실행에 성공하고 핸들러인 MyHttpRequestHandler 를 반환한다.

2. 핸들러 어댑터 조회
HandlerAdapter 의 supports() 를 순서대로 호출한다.
HttpRequestHandlerAdapter 가 HttpRequestHandler 인터페이스를 지원하므로 대상이 된다.

3. 핸들러 어댑터 실행
디스패처 서블릿이 조회한 HttpRequestHandlerAdapter 를 실행하면서 핸들러 정보도 함께 넘겨준다.
HttpRequestHandlerAdapter 는 핸들러인 MyHttpRequestHandler 를 내부에서 실행하고, 그 결과를 반환한다.


[3] 뷰 리졸버

✔️ OldController (수정)

package hello.servlet.web.springmvc.old;

import org.springframework.stereotype.Component;
import org.springframework.ui.Model;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@Component("/springmvc/old-controller") // 스프링 이름을 url 이름으로 맞춘 것
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");
    }
}

➡️ 이렇게 return 값을 바꾸면 ??

이제 원하는 결과를 얻을 수 있도록 코드를 추가해보자

✔️ application.properties 코드 추가

spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp

스프링부트는 InternalResourceViewResolver라는 뷰 리졸버를 자동으로 등록하는데, 이때 방금 등록한 설정 정보를 사용해 등록한다.

스프링 부트가 자동 등록하는 뷰 리졸버

1 = BeanNameViewResolver : 빈 이름으로 뷰를 찾아서 반환 (예: 엑셀 파일 생성 기능에 사용)
2 = InternalResourceViewResolver : JSP를 처리할 수 있는 뷰를 반환

1. 핸들러 어댑터 호출
핸들러 어댑터를 통해 new-form 이라는 논리 뷰 이름을 획득한다.

2. ViewResolver 호출
new-form 이라는 뷰 이름으로 viewResolver를 순서대로 호출한다.
BeanNameViewResolver 는 new-form 이라는 이름의 스프링 빈으로 등록된 뷰를 찾아야 하는데 없다. InternalResourceViewResolver 가 호출된다.

3. InternalResourceViewResolver
이 뷰 리졸버는 InternalResourceView 를 반환한다.

4. 뷰 - InternalResourceView
InternalResourceView 는 JSP처럼 포워드 forward() 를 호출해서 처리할 수 있는 경우에 사용한다.

5. view.render()
view.render() 가 호출되고 InternalResourceView 는 forward() 를 사용해서 JSP를 실행한다.


[4] 스프링 MVC - 시작하기

스프링이 제공하는 컨트롤러는 애노테이션 기반으로 매우 유연하고 실용적.

@RequestMapping

스프링 애노테이션이 매우 유연, 실용적인 컨트롤러를 만들었는데 이는 @RequestMapping 애노테이션을 사용하는 컨트롤러.

  • RequestMappingHandlerMapping
  • RequestMappingHandlerAdapter

➡️ 이 둘은 우선 순위가 높은 핸들러 매핑과 어댑터
스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 핸들러 매핑과 어댑터.
(실무에서 99.9% 이 방식의 컨트롤러 사용)

✔️ SpringMemberFormControllerV1

package hello.servlet.web.springmvc.v1;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class SpringMemberFormControllerV1 {

    @RequestMapping("/springmvc/v1/members/new-form")
    public ModelAndView process() {
        return new ModelAndView("new-form");
    }
}

@Controller:
스프링이 자동으로 스프링 빈으로 등록.
(내부에 @Component 애노테이션이 있어서 컴포넌트 스캔의 대상이 됨)
스프링 MVC에서 애노테이션 기반 컨트롤러로 인식.

@RequestMapping: 요청 정보를 매핑.
해당 URL이 호출되면 이 메서드가 호출된다. 애노테이션을 기반으로 동작하기 때문에, 메서드의 이름은 임의로 짓기.

ModelAndView: 모델과 뷰 정보를 담아서 반환

RequestMappingHandlerMapping은 스프링 빈 중 @RequestMapping 또는 @Controller 가 클래스 레벨에 붙어 있는 경우에 매핑 정보로 인식한다.

✔️ SpringMemberSaveControllerV1

package hello.servlet.web.springmvc.v1;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import hello.servlet.web.frontcontroller.ModelView;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Map;

@Controller
public class SpringMemberSaveControllerV1 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping("/springmvc/v1/members/save")
    public ModelAndView process(HttpServletRequest request, HttpServletResponse 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;
    }
}

✔️ SpringMemberListControllerV1

package hello.servlet.web.springmvc.v1;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import hello.servlet.web.frontcontroller.ModelView;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import java.util.List;
import java.util.Map;

@Controller
public class SpringMemberListControllerV1 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping("/springmvc/v1/members")
    public ModelAndView process() {

        List<Member> members = memberRepository.findAll();

        ModelAndView mv = new ModelAndView("members");
        mv.addObject("members", members);

        return mv;
    }
}


[5] 스프링 MVC - 컨트롤러 통합

@RequestMapping이 클래스 단위가 아니라 메소드 단위에 적용되어 있다. 따라서 컨트롤러 클래스를 유연하게 하나로 통합할 수 있다.

✔️ SpringMemberControllerV2

package hello.servlet.web.springmvc.v2;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.List;

@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, HttpServletResponse 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;
    }

}

컨트롤러 클래스를 통합하는 것뿐만 아니라 조합도 가능하다.

/springmvc/v2/members 의 중복은
✔️ 클래스 레벨 @RequestMapping("/springmvc/v2/members")

  • 메서드 레벨 @RequestMapping("/new-form") → /springmvc/v2/members/new-form
  • 메서드 레벨 @RequestMapping("/save") → /springmvc/v2/members/save
  • 메서드 레벨 @RequestMapping → /springmvc/v2/members

이렇게 중복을 제거할 수 있다.


[6] 스프링 MVC - 실용적인 방식

코드가 엄!청 깔끔해짐

✔️ SpringMemberControllerV3

package hello.servlet.web.springmvc.v3;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.List;

@Controller
@RequestMapping("/springmvc/v3/members")
public class SpringMemberControllerV3 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    // new-form은 무조건 GET으로만 받을 것 (GET의 경우에만 호출됨)
//    @RequestMapping(value = "/new-form", method = RequestMethod.GET)
    @GetMapping("/new-form ")   // 개발자들이 그마저도 귀찮다고 이렇게 줄여버림
    public String newForm() {   // 문자를 반환해도 됨. 알아서 뷰 이름으로 알고 프로세서가 진행됨.
        return "new-form";
    }

//    @RequestMapping(value = "/save", method = RequestMethod.POST)
    @PostMapping("/save")
    public String save(
            // 1. "username이라는 요청 파라미터 받고싶어"
            @RequestParam("username") String username,
            @RequestParam("age") int age,
            Model model
    ) {

        // 2. 비즈니스 로직 수행시킴
        Member member = new Member(username, age);
        memberRepository.save(member);

        // 3. 모델에 담음
        model.addAttribute("member", member);
        // 4. 뷰의 이름을 반환
        return "save-result";
    }

//    @RequestMapping(method = RequestMethod.GET) // 단순 조회니까 GET
    @GetMapping
    public String members(Model model) {

        List<Member> members = memberRepository.findAll();

        model.addAttribute("members", members);
        return "members";
    }
}

Model 파라미터
: save(), members()를 보면 Model을 파라미터로 받음. 스프링 MVC는 이런 편의 기능을 제공

ViewName 직접 반환
: 뷰의 논리 이름을 반환

@RequestParam 사용
: (이름 그대로 요청 파라미터를 처리하는 애노테이션)
@RequestParam("username") = request.getParameter("username") 거의 같은 코드

물론 GET, POST Form 방식을 모두 지원 → 별로 좋은 방법은 아님

@RequestMapping → @GetMapping, @PostMapping
그런데 이마저도 귀찮다고 느낀 개발자들이 더 줄여버림 ^^; ➡️ (@GetMapping, @PostMapping)

참고로 Get,Post, Delete, Put, Patch 애노테이션 모두 있음.


좋은 웹페이지 즐겨찾기