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

sorzzzzy·2021년 9월 9일
SpringSpringbootTIL
1

Spring Boot - RoadMap 1

목록 보기
31/46
post-thumbnail

🏷 스프링 MVC 전체 구조

직접 만든 MVC 프레임워크 VS 스프링 MVC

❗️직접 만든 프레임워크 스프링 MVC 비교❗️

  • FrontController ➡️ DispatcherServlet
  • handlerMappingMap ➡️ HandlerMapping
  • MyHandlerAdapter ➡️ HandlerAdapter
  • ModelView ➡️ ModelAndView
  • viewResolver ➡️ ViewResolver
  • MyView ➡️ View

✔️ DispatcherServlet 구조 살펴보기

org.springframework.web.servlet.DispatcherServlet

  • 스프링 MVC도 프론트 컨트롤러 패턴으로 구현되어 있다.
  • 스프링 MVC의 프론트 컨트롤러가 바로 디스패처 서블릿(DispatcherServlet)이다.
  • 그리고 이 디스패처 서블릿이 바로 스프링 MVC의 핵심이다!!

1️⃣ DispatcherServlet 서블릿 등록

  • DispacherServlet 도 부모 클래스에서 HttpServlet 을 상속 받아서 사용하고, 서블릿으로 동작한다.
    • DispatcherServlet ➡️ FrameworkServlet ➡️
      HttpServletBean ➡️HttpServlet
  • 스프링 부트는 DispacherServlet 을 서블릿으로 자동으로 등록하면서 모든 경로(urlPatterns="/")에 대해서 매핑한다.
    • 더 자세한 경로가 우선순위가 높다. 그래서 기존에 등록한 서블릿도 함께 동작한다.

2️⃣ 요청 흐름

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

DispacherServlet.doDispatch() 이게 제일 중요함🌟

protected void doDispatch(HttpServletRequest request, HttpServletResponse
  response) throws Exception {
    HttpServletRequest processedRequest = request;
    HandlerExecutionChain mappedHandler = null;
    ModelAndView mv = null;
    // 1. 핸들러 조회
    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);

✔️ SpringMVC 구조


1️⃣ 동작 순서

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

2️⃣ 인터페이스 살펴보기

  • 스프링 MVC의 큰 강점은DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다. 지금까지 설명한 대부분을 확장 가능할 수 있게 인터페이스로 제공한다.
  • 이 인터페이스들만 구현해서 DispatcherServlet 에 등록하면 우리들만의 컨트롤러를 만들 수도 있다.

3️⃣ 주요 인터페이스 목록

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

🏷 핸들러 매핑과 핸들러 어댑터

핸들러 매핑과, 어댑터를 더 잘 이해하기 위해 Controller 인터페이스가 아닌 다른 핸들러를 알아보자! HttpRequestHandler 핸들러(컨트롤러)는 서블릿과 가장 유사한 형태의 핸들러이다.

간단히 구현해보자^_^

✔️ MyHttpRequestHandler 생성

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

⬆️ http://localhost:8080/springmvc/request-handler로 실행한 결과 👍🏻

1️⃣ 핸들러 매핑으로 핸들러 조회

  • HandlerMapping 을 순서대로 실행해서, 핸들러를 찾는다.

2️⃣ 핸들러 어댑터 조회

  • 이 경우 빈 이름으로 핸들러를 찾아야 하기 때문에 이름 그대로 빈 이름으로 핸들러를 찾아주는 BeanNameUrlHandlerMapping 가 실행에 성공하고 핸들러인 MyHttpRequestHandler 를 반환한다.

3️⃣ 핸들러 어댑터 실행

  • HandlerAdapter의 supports()를 순서대로 호출한다.
  • HttpRequestHandlerAdapter가 HttpRequestHandler 인터페이스를 지원하므로 대상이 된다.

4️⃣ 정리
MyHttpRequestHandler 를 실행하면서 사용된 객체는 다음과 같다.

  • HandlerMapping = BeanNameUrlHandlerMapping
  • HandlerAdapter = HttpRequestHandlerAdapter

🏷 뷰 리졸버

📌 application.properties 수정

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

뷰 리졸버 - InternalResourceViewResolver
➡️ 스프링 부트는 InternalResourceViewResolver 라는 뷰 리졸버를 자동으로 등록하는데, 이때 application.properties 에 등록한 spring.mvc.view.prefix , spring.mvc.view.suffix 설정 정보를 사용해서 등록한다!

✔️ 뷰 리졸버 동작 방식


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를 실행한다.

🏷 스프링 MVC - 시작하기

@RequestMapping
스프링은 애노테이션을 활용한 매우 유연하고, 실용적인 컨트롤러를 만들었는데 이것이 바로 @RequestMapping 애노테이션을 사용하는 컨트롤러이다❗️
@RequestMapping

  • RequestMappingHandlerMapping
  • RequestMappingHandlerAdapter

그럼 이제 본격적으로 애노테이션 기반의 컨트롤러를 사용해보자!
지금까지 만들었던 프레임워크에서 사용했던 컨트롤러를 @RequestMapping 기반의 스프링 MVC 컨트롤러 변경해보자 ☺️

✔️ SpringMemberFormControllerV1 - 회원 등록

package hello.servlet.web.springmvc.v1;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

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

    }
}

✔️ SpringMemberSaveControllerV1 - 회원 저장

package hello.servlet.web.springmvc.v1;
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;

@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);
        System.out.println("member = " + member);
        memberRepository.save(member);

        ModelAndView mv = new ModelAndView("save-result");
        // 스프링이 제공하는 ModelAndView 를 통해 Model 데이터를 추가할 때는 addObject() 를 사용하면 된다.
        // 이 데이터는 이후 뷰를 렌더링 할 때 사용된다.
        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 org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
import java.util.List;

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

⬆️ (등록 : http://localhost:8080/springmvc/v1/members/new-form/ 목록 : http://localhost:8080/springmvc/v1/members) 으로 실행 시 결과 👍🏻


🏷 스프링 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;

/**
 *클래스 단위->메서드 단위
 * @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("/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 mav = new ModelAndView("save-result");
        mav.addObject("member", member);
        return mav;
    }

    // 회원 조회
    @RequestMapping
    public ModelAndView members() {

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

        ModelAndView mav = new ModelAndView("members");
        mav.addObject("members", members);
        return mav;
    }
}

여기서 보면
@RequestMapping("/springmvc/v2/members/new-form")
@RequestMapping("/springmvc/v2/members")
@RequestMapping("/springmvc/v2/members/save")
이 부분들에 중복(/springmvc/v2/members)이 있다!!!!

이렇게 그대로 사용해도 문제는 없지만, 클래스 레벨에 아래와 같이@RequestMapping 을 두면 메서드 레벨과 조합이 된다👍🏻

@Controller
@RequestMapping("/springmvc/v2/members")
public class SpringMemberControllerV2 {}

조합 결과

  • 클래스 레벨 @RequestMapping("/springmvc/v2/members")
    • 메서드 레벨 @RequestMapping("/new-form") ➡️ /springmvc/v2/members/new-form
    • 메서드 레벨 @RequestMapping("/save") ➡️ /springmvc/v2/members/save
    • 메서드 레벨 @RequestMapping ➡️ /springmvc/v2/members

⬆️ 실행 결과 👍🏻


🏷 스프링 MVC - 실용적인 방식

MVC 프레임워크 만들기에서 v3은 ModelView를 개발자가 직접 생성해서 반환했기 때문에, 불편했던 기억이 날 것이다🤔 (v4를 만들면서 실용적으로 개선했음)
스프링 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.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

import java.util.List;

/**
 * v3
 * Model 도입
 * ViewName 직접 반환
 * @RequestParam 사용
 * @RequestMapping -> @GetMapping, @PostMapping
 * */

@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 : 파라미터를 직접 받을 수 있음
            @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";
    }
}

1️⃣ Model 파라미터

  • save(), members() 를 보면 Model을 파라미터로 받는 것을 확인할 수 있다. 스프링 MVC도 이런 편의 기능을 제공한다.

2️⃣ ViewName 직접 반환

  • 뷰의 논리 이름을 반환할 수 있다.

3️⃣ @RequestParam 사용

  • 스프링은 HTTP 요청 파라미터를 @RequestParam 으로 받을 수 있다.
  • @RequestParam("username") 은 request.getParameter("username") 와 거의 같은 코드라 생각하면 된다.
  • 물론 GET 쿼리 파라미터, POST Form 방식을 모두 지원한다.

4️⃣ @RequestMapping ➡️ @GetMapping, @PostMapping

  • @RequestMapping 은 URL만 매칭하는 것이 아니라, HTTP Method도 함께 구분할 수 있다.
  • 예를 들어서 URL이 /new-form 이고, HTTP Method가 GET인 경우를 모두 만족하는 매핑을 하려면 ⬇️아래와 같이⬇️ 처리하면 된다
@RequestMapping(value = "/new-form", method = RequestMethod.GET)

➡️ 이것을 @GetMapping , @PostMapping 으로 더 편리하게 사용할 수 있다.

⬆️ 실행 결과 👍🏻


좋은 실습이었다....!

profile
sorzzzzy
Backend Developer
이전 포스트

[Spring Boot][4] 4-2. MVC 프레임워크 만들기

다음 포스트

[Spring Boot][4] 6-1. 스프링 MVC - 기본 기능

0개의 댓글