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

윤현우·2023년 2월 28일

Spring boot

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술

목록 보기

5/6

1. 스프링 MVC 전체 구조

이전 시간에 직접 만들었던 MVC 프레임워크와 지금 우리가 사용하고 있는 스프링 MVC를 비교해보자.

직접 만든 MVC 프레임워크 구조

Spring MVC 구조

직접 만들었던 MVC 프레임워크와 스프링 MVC 프레임워크와 이름만 다를 뿐, 동작 방식이 같다.

우리가 흔히 알고있는 어노테이션을 이용한 MVC 패턴은 이 구조들을 보다 쉽고 간편하게 사용하기위해 만들어진 것이다.

Spring MVC 프레임워크의 클래스들을 하나하나 올라가보면 우리가 만들었던 메서드들이 있다. (예외처리 및 인터셉터 제외)

1-1. 동작 순서

핸들러 조회: 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러)를 조회한다.
핸들러 어댑터 조회: 핸들러를 실행할 수 있는 핸들러 어댑터를 조회한다.
핸들러 어댑터 실행: 핸들러 어댑터를 실행한다.
핸들러 실행: 핸들러 어댑터가 실제 핸들러(컨트롤러)를 실행한다.
ModelAndView 반환: 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다.
ViewResolver 호출: 뷰 리졸버를 찾고 실행 한다.

JSP의 경우: InternalResourceViewResolver가 자동등록되고, 실행한다.

View 반환: 뷰 리졸버는 뷰의 논리 이름을 물리 이름으로 변경하고, 렌더링 역할을 담당하는 뷰 객체를 반환한다.

JSP의 경우: InternalResourceView(JstlView)를 반환하는데, 내부에 forward()로직이 있다.

뷰 렌더링: 뷰를 통해 렌더링 한다.

2. 핸들러 매핑과 핸들러 어댑터

핸들러 매핑과 핸들러 어댑터가 어떤 것들이 어떻게 사용되는지 알아보자.

지금은 전혀 사용하지 않지만, 과거에 주로 사용했던 스프링이 제공하는 간단한 컨트롤러로 핸들러 매핑과 어댑터를 이해해보자.

@Controller, @RequestMapping 어노테이션을 사용하기 이전에 controller라는 인터페이스를 사용했었다.

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")
public class OldController implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        System.out.println("OldController.handleRequest");
        return null;
    }
}

@Component

이 컨트롤러는 빈의 이름으로 URL을 매핑한다.

2-1. controller 인터페이스 호출 방식

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

2-2. 스프링 부트가 자동 등록하는 핸들러 매핑과 핸들러 어댑터

실제로는 더 많지만, 중요한 부분 위주로 설명하기 위해 일부를 생략했다.

HandlerMapping

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

HandlerAdapter

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

핸들러 매핑도, 핸들러 어댑터도 모두 순서대로 찾고 만약 없으면 다음 순서로 넘어간다.

핸들러 매핑으로 핸들러 조회

HandlerMapping을 순서대로 실행해서, 핸들러를 찾는다.
이 경우 빈으로 핸들러를 찾아야하므로 BeanNameUrlHandlerMapping이 실행되고 핸들러를 반환한다.

핸들러 어댑터 조회

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

핸들러 어댑터 실행

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

2-3. 정리

이렇게 @Controller, @RequestMapping같은 어노테이션이 나오기 이전에 많은 핸들러와 핸들러 어댑터가 있었다.

하지만 너무 편한 어노테이션이 나오면서 다른 핸들러와 핸들러 어댑터를 사용하지 않게 된다.

아무튼 핸들러와 핸들러 어댑터의 사용 이유는 개발자 자신들에게 편한 핸들러(컨트롤러)를 사용하기 위해 나온 것이고, 현재는 @Controller와 @RequestMapping의 편리함이 너무 막강해 실무에서 대부분 어노테이션을 사용한다.

3. 스프링 MVC - 시작하기

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

과거에는 자바 언어에 애노테이션이 없기도 했고, 스프링도 처음부터 이런 유연한 컨트롤러를 제공한 것은 아니다.

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

@RequestMapping
- RequestMappingHandlerMapping
- RequestMappingHandlerAdapter

앞서 보았듯이 가장 우선순위의 핸들러와 핸들러 어댑터는 위의 두가지이다.

이것이 지금 스프링에서 주로 사용하는 어노테이션 기반의 컨트롤러를 지원하는 핸들러 매핑과 어댑터이다.

이 어노테이션을 사용해서 스프링 MVC 컨트롤러를 변경해보자.

3-1. 회원 등록, 저장, 목록 작성

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;

@Controller
public class SpringMemberFormControllerV1 {

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

@Controller

스프링이 자동으로 스프링 빈을 등록해준다. (해당 어노테이션 내부에 @Component어노테이션이 있다.)
스프링 MVC에서 어노테이션 기반 컨트롤러로 인식한다.

@RequestMapping

요청정보를 매핑한다. 해당 URL이 호출되면 이 메서드가 호출된다.

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

mv.addObject("member", member)

스프링이 제공하는 ModelAndView를 통해 Model 데이터를 추가할 때는 addObject()를 사용한다.
이 데이터는 이후 뷰를 렌더링 할 때 사용된다.

4. 스프링 MVC - 컨트롤러 통합

@RequestMapping 을 잘 보면 클래스 단위가 아니라 메서드 단위에 적용된 것을 확인할 수 있다. 따라서 컨트롤러 클래스를 유연하게 하나로 통합할 수 있다.

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

@RequestMapping("/springmvc/v2/members")

클래스 상위에 중복 url을 매핑해둘 수 있다.

5. 스프링 MVC - 실용적인 방식

@Controller안에서 다양한 파라미터를 받을 수 있다.

HttpServletRequest(Response)나 파라미터를 직접 받을 수 있는 @RequestParam이 있다.

요즘 사용하는 방식으로 업데이트를 해보자.

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 java.util.List;

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

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping(value = "/new-form", method = RequestMethod.GET)
    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";
    }

}

@RequestParam

스프링은 HTTP 요청 파라미터를 @RequestParam으로 받을 수 있다.
@RequestParam("username")은 request.getParameter("username")과 같은 코드라 생각하면된다.

@RequestMapping -> @GetMapping, @PostMapping

@RequestMapping 은 URL만 매칭하는 것이 아니라, HTTP Method도 함께 구분할 수 있다.

예를 들어서 URL이 /new-form 이고, HTTP Method가 GET인 경우를 모두 만족하는 매핑을 하려면 다음과 같이 처리하면 된다.

@RequestMapping(value = "/new-form", method = RequestMethod.GET)

References(참고자료)
https://www.inflearn.com/

윤현우

개발자가 되는 그날까지

이전 포스트

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술[MVC프레임워크 만들기]

다음 포스트

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