스프링 MVC 구조

sec5 사진1

Dispatcher Servlet

스프링 MVC의 프론트 컨트롤러 (스프링 MVC에서 가장 중요 )
부모 클래스에서 HttpServlet을 상속 받아 서블릿으로 동작한다.
- DispatcherServlet - FrameworkServlet - HttpServletBean - HttpServlet
스프링 부트는 DispacherServlet 을 서블릿으로 자동으로 등록하면서 모든 경로( urlPatterns="/" )에 대해서 매핑한다.
- 자세한 경로가 우선순위가 높다.
- 핸들러 매핑, 핸들러 어댑터, 뷰 리졸버만 DispacherServlet에 등록하면 커스텀 컨트롤러를 만들 수 있다.

요청 흐름

서블릿이 호출되면 HttpServlet이 제공하는 service() 메서드가 호출 (서블릿 방식)
스프링 MVC는 DispatcherServlet의 부모인 FrameworkServlet에서 service()를 오버라이드
FrameworkServlet.service() 를 시작으로 여러 메서드가 호출되면서 DispacherServlet.doDispatch() 가 호출된다. (핵심 부분)

doDispatch()

protected void doDispatch(HttpServletRequest request, HttpServletResponse
response) throws Exception {
  HttpServletRequest processedRequest = request;
  HandlerExecutionChain mappedHandler = null;
  ModelAndView mv = null;
  // 1. 핸들러 조회 - 없다면 404에러 
  mappedHandler = getHandler(processedRequest);
  if (mappedHandler == null) {
  noHandlerFound(processedRequest, response);
  return;
  }
  // 2. 핸들러 어댑터 조회 - 핸들러를 처리할 수 있는 어댑터
  HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());

  // 3. 핸들러 어댑터 실행 -> 4. 핸들러 어댑터를 통해 핸들러 실행 -> 5. ModelAndView 반환
  mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
  processDispatchResult(processedRequest, response, mappedHandler, mv,
  dispatchException);
}
private void processDispatchResult(HttpServletRequest request,
  HttpServletResponse response, HandlerExecutionChain mappedHandler, ModelAndView
  mv, Exception exception) throws Exception {

  // 뷰 렌더링 호출
  render(mv, request, response);
  }
  protected void render(ModelAndView mv, HttpServletRequest request,
  HttpServletResponse response) throws Exception {
  View view;
  String viewName = mv.getViewName();

  // 6. 뷰 리졸버를 통해서 뷰 찾기, 7. View 반환
  view = resolveViewName(viewName, mv.getModelInternal(), locale, request);

  // 8. 뷰 렌더링
  view.render(mv.getModelInternal(), request, response);
}

동작 순서

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

핸들러 매핑, 핸들러 어댑터

Old Controller

import org.springframework.web.servlet.mvc.Controller;
@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;
    }
}

과거 버전의 스프링 컨트롤러 (인터페이스)
과거의 핸들러는 빈 이름으로 조회하고 SimpleControllerHandlerAdapter를 컨트롤러 내부에서 실행하고 그 결과를 반환한다.

HttpRequestHandler

public interface HttpRequestHandler {
  void handleRequest(HttpServletRequest, HttpServletResponse response) throws ServletException, IOException;
}

서블릿과 가장 유사한 형태의 핸들러 생성

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");
         }
}

핸들러 매핑으로 핸들러 조회
- HandlerMapping 을 순서대로 실행해서, 핸들러를 찾는다.
- 이 경우 빈 이름으로 핸들러를 찾아야 하기 때문에 이름 그대로 빈 이름으로 핸들러를 찾아주는 BeanNameUrlHandlerMapping 가 실행에 성공하고 핸들러인 OldController 를 반환한다.
핸들러 어댑터 조회
- HandlerAdapter 의 supports() 를 순서대로 호출한다.
- SimpleControllerHandlerAdapter 가 Controller 인터페이스를 지원하므로 대상이 된다.
핸들러 어댑터 설정
- 디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter 를 실행하면서 핸들러 정보도 함께 넘겨준다.
- SimpleControllerHandlerAdapter 는 핸들러인 OldController 를 내부에서 실행하고, 그 결과를 반환한다.
HandlerMapping(핸들러 매핑)
- 핸들러 매핑에서 이 컨트롤러를 찾을 수 있어야 한다.
- 예) 스프링 빈의 이름으로 핸들러를 찾을 수 있는 핸들러 매핑이 필요하다.
HandlerAdapter(핸들러 어댑터)
- 핸들러 매핑을 통해서 찾은 핸들러를 실행할 수 있는 핸들러 어댑터가 필요하다.
- 예) Controller 인터페이스를 실행할 수 있는 핸들러 어댑터를 찾고 실행해야 한다.
스프링은 이미 필요한 핸들러 매핑과 핸들러 어댑터를 대부분 구현해두었다. 개발자가 직접 핸들러 매핑과 핸들러 어댑터를 만드는 일은 거의 없다.
스프링 부트가 자동 등록하는 핸들러 매핑과 핸들러 어댑터
- HandlerMapping
- 0 = RequestMappingHandlerMapping : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용 1 = BeanNameUrlHandlerMapping : 스프링 빈의 이름으로 핸들러를 찾는다.
- HandlerAdapter
```
0 = RequestMappingHandlerAdapter : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = HttpRequestHandlerAdapter : HttpRequestHandler 처리
2 = SimpleControllerHandlerAdapter : Controller 인터페이스(애노테이션X, 과거에 사용) 처리
```

@RequestMapping

우선순위가 가장 높은 핸들러 매핑과 핸들러 어댑터는 RequestMappingHandlerMapping, RequestMappingHandlerAdapter 이고, 이 부분이 현재의 어노테이션 기반의 컨트롤러를 지원하는 @RequestMapping이다.

뷰 리졸버

@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"); //InternalResourceViewResolver 반환 필요
    }
}

application.properties 설정 후 handleRequest 메서드에 기존에 있던 new-form.jsp를 불러올 수 있다.
- spring.mvc.view.prefix=/WEB-INF/views/
- spring.mvc.view.suffix=.jsp
- 실제론 뷰 리졸버를 빈에 등록하여 설정해줘야 하는데 스프링부트에서 설정(application.properties)해준다.
스프링 부트가 자동 등록하는 뷰 리졸버 (일부)

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

동작 과정

핸들러 어댑터를 통해 new-form이라는 논리 뷰를 획득하고 이 뷰의 이름으로 viewResolver를 호출
빈에 등록된 상황이 아니므로 InternalResourceViewResolver를 호출하고 InternalResourceView 는 JSP 처럼 포워드를 호출(view.render())해서 처리할 수 있는 경우 사용

스프링 MVC 시작하기

스프링이 제공하는 컨트롤러는 애노테이션 기반으로 동작 - 매우 유연, 실용적
@RequestMapping
- 애노테이션 기반의 컨트롤러를 지원 (실무에서 대부분 사용)
- RequestMappingHandlerMapping
- RequestMappingHandlerAdapter

@Controller
public class SpringMemberFormControllerV1 {

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

@Controller
- 스프링이 자동으로 스프링 빈으로 등록한다. (내부에 @Component 애노테이션이 있어서 컴포넌트 스캔의 대상이 됨)
- 스프링 MVC에서 애노테이션 기반 컨트롤러로 인식한다.
@RequestMapping
- 요청 정보를 매핑한다. 해당 URL이 호출되면 이 메서드가 호출된다. 애노테이션을 기반으로 동작하기 때문에, 메서드의 이름은 임의로 지으면 된다.
ModelAndView : 모델과 뷰 정보를 담아서 반환하면 된다.

@Component // 빈등록
@RequestMapping //핸들러 어댑터 생성 - 반드시 클래스 레벨
public class SpringMemberFormControllerV1 {

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

@Controller 대신 해당 애노테이션을 사용해도 같은 동작을 한다. (@Component, @RequestMapping)

컨트롤러 통합

@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
    public ModelAndView save() {
        List<Member> members = memberRepository.findAll();

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

        return mv;
    }

    @RequestMapping("/save")
    public ModelAndView members(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을 통해 컨트롤러 통합

실용적인 방식

@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";
    }
}

@RequestMapping("/url", method=RequestMapping.Get) 을 @GetMapping("/url")로 간단하게 설계
ModelAndView 타입 리턴이 아닌 String 타입으로 반환해도 해당 뷰리졸버가 해당 뷰를 찾아 반환해준다.
@RequestParam을 통해 파라미터도 어노테이션 기반으로 받을 수 있고, Model을 통해 값을 보낼 수 있다.

본 포스팅은 인프런 김영한님 강의(스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술)를 토대로 정리한 내용입니다.

스프링 MVC 구조

Dispatcher Servlet

요청 흐름

doDispatch()

동작 순서

핸들러 매핑, 핸들러 어댑터

Old Controller

HttpRequestHandler

@RequestMapping

뷰 리졸버

동작 과정

스프링 MVC 시작하기

컨트롤러 통합

실용적인 방식

검색 태그

티스토리툴바