[Spring] 스프링 MVC 구조 (핸들러 매핑, 핸들러 어댑터, 뷰 리졸버)

 

📑 스프링 MVC 구조

 

스프링 MVC의 구조는 다음과 같다. 전체적 흐름을 먼저 살펴보고 DispatcherServlet, Handler Mapping, Handler Adapter, ViewResolver 등등 각각 하나씩 알아가보도록 하자.

 

 

 

📌 1. 핸들러 조회

: 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러를) 조회한다. 예를들어 http://localhost:8080/response-view 이런식으로 클라이언트가 브라우저에 요청을 하면 response-view에 해당하는 핸들러를 조회한다.

 

 

📌 2. 핸들러 어뎁터 조회

: 핸들러 어댑터 목록에서 핸들러 어댑터를 조회한다. 즉) 핸들러를 처리할 수 있는 핸들러 어댑터를 조회한다는 의미인데, 이는 여러 인터페이스 같은 큰 틀들 중 클라이언트가 요청한 url에 해당하는 핸들러를 어떤 핸들러 어댑터에서 적합한지 찾아주는 작업이다. 

 

 

📌 3. 핸들러 어댑터 실행 

: 적합한 핸들러 어댑터를 찾았다면 이를 실행한다. 

 

 

📌 4. 핸들러 실행

: 여기서 핸들러, 즉) 컨트롤러를 실행하게 된다. 

 

 

📌5. ModelAndView 반환

: 핸들러에 반환형으로 보통 String 형태의 view name이나 ModelAndView 객체를 생성해 그 객체에 view name을 담아서 반환한다. 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다. 

 

 

📌6. ViewResolver 호출

: 뷰 리졸버를 찾고 실행한다. 보통 컨트롤러에서 ModelAndView를 반환할때 정적인 뷰 이름을 반환한다. jsp 파일이 있는 경로를 직접 반환하는 것이 아닌 response-view와 같이 view 이름을 반환하는데 ViewResolver에선 이런 정적인 이름 앞에 prefix로 상세 경로와 suffix로 파일 형식을 지정해둬서 해당하는 view를 호출하는 것.

 

 

📌 7. View 반환

: 뷰 리졸버는 뷰의 논리 이름을 물리 이름으로 바꾸고, 렌더링 역할을 담당하는 뷰 객체를 반환한다. 따라서 뷰를 통해서 뷰를 렌더링 하면 클라이언트에게 원하는 url의 데이터들이 보여지게 되는 것이다.

 

 

 

📑 DispatcherServlet

 

디스패처 서블릿의 dispatch는 "보내다"라는 뜻을 가지고 있다. 즉) DispatcherServlet은 HTTP 프로토콜로 들어오는 모든 요청을 가장 먼저 받아 적합한 컨트롤러에 위임해주는 프론트 컨트롤러라고 할 수 있다. 

 

DispatcherServlet도 부모 클래스에서 HttpServlet을 상속받아 사용하고, 서블릿으로 동작한다. 스프링 부트는 DispatcherServlet을 서블릿으로 자동 등록하면서 모든 경로(urlPatterns="/")에 대해서 매핑한다. 

 

 

따라서 요청 흐름을 정리해 보자면 다음과 같다.

 

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

 

 

스프링의 큰 장점은 DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다. 지금까지 위에서 본 대부분을 확장 가능할 수 있게 인터페이스로 제공한다.

 

 

 

 

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

 

dispatcher servlet으로 들어온 요청을 각각의 Controller로 위임 처리하는 게 바로 핸들러 매핑이며,  컨트롤러(핸들러)가 처리한 결과값을 받아서 ModelAndView 형태로 바꿔 DispatcherServlet에 보내주는 것이 바로 핸들러 어댑터이다.  이런 기능 덕분에 어떤 형태의 객체로 결과값을 받던지간에 상관없이  웹요청을 처리할 수 있게 된다.

 

 

만약 컨트롤러가 호출되면 다음 2가지가 필요하다.

 

 

🎃 1. HandlerMapping(핸들러 매핑)

: 핸들러 매핑에서 이 컨트롤러를 찾을 수 있어야 한다.

ex) 스프링 빈의 이름(@component("")를 통해 설정 가능) 이나, @RequestMapping을 통해 핸들러를 찾을 수 있다. 

 

 

🎃 2. HandlerAdapter(핸들러 어댑터)

: 핸들러 매핑을 통해 찾은 핸들러를 실행할 수 있는 핸들러 어댑터가 필요하다. 

ex) Controller 인터페이스를 실행할 수 있는 핸들러 어댑터를 찾고 실행해야 한다. 

 

---

 

 

가장 우선순위가  높은 핸들러매핑과 어댑터는

@RequestMapping의 앞글자를 따서 만RequestMappingHandlerMapping, RequestMappingHandlerAdapter 이다. 주로 실무에서는 이방식을 사용하기에 이것만 알고있어도 무관하다. 

 

 

 

📑 뷰 리졸버 

 

앞서 스프링 MVC의 구조 흐름에서 잠시 설명했지만 ModelAndView를 반환할 때 리턴값에 정적뷰 이름을 지정한 후 그냥 실행하면 오류가 발생한다. 스프링 부트는 InternalResourceViewResolver라는 뷰 리졸버를 자동으로 등록하는데, 이때 application.properties에 등록한 설정 정보를 사용해서 등록한다. 

 

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

 

 

스프링 MVC에서 뷰 리졸버 동작 방식에 대해 알아보자. 

 

//스프링 빈의 이름을 @component 이용해서 url 패턴으로 맞춰주었다.
@Component("/spring/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");
}
}

 

 

📌 1. 핸들러 어댑터 호출

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

 

📌 2. ViewResolver 호출

: new-form 이라 뷰 이름으로 viewResolver를 순서대로 호출한다. 우선순위가 1번인 BeanNameViewResolver는 new-form이라는 이름의 스프링 빈으로 등록된 뷰를 찾아야하는데 위의 컨트롤러 설정에선 없다. 따라서 2순위인 InternalResourceViewResolver가 호출된다.

 

📌 3. InternalResourceViewResolver

: InternalResourceViewResolver 리졸버는 InternalResourceView를 반환한다.

 

📌 4. 뷰 - InternalResourceView

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

 

📌 5. view.render()

: view.render()가 호출고 InternalResourceView는 forward()를 사해 JSP를 실행한다. 여기서 렌더링이란 서버로부터 HTML 파일을 받아 브라우저에 뿌려주는 과정이다.

 

다른 뷰는 실제 뷰를 렌더링하지만, Jsp의 경우 forward() 통해서 해당 JSP로 이동해야 렌더링이 된다. JSP를 제외한 나머지 뷰 템플릿들은 forward() 과정 없이 바로 렌더링 된다. 

 

 

 

📑 스프링 MVC 패턴 예제 1 - 반환형 ModelAndView

 

앞서 보았듯이 가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터는 RequestMappingHandlerMapping , RequestMappingHandlerAdapter 이다. @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 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;
    }

}

 

 

🎃 @Controller

:  스프링이 자동으로 스프링 빈으로 등록된다. (내부에 @Component 어노테이션이 있어 컴포넌트 스캔의 대상이 된다. )

 

🎃 @RequestMapping 

: 요청 정보를 매핑한다. 해당 URL이 호출되면 이 메서드가 호출된다. 에너테이션 기반으로 동작하기에, 메서드 이름은 임의로 지어도 되지만, 같은 클래스 내에 메서드의 역할을 알 수 있도록 지어주는 것이 좋다. 

 

🎃 ModelAndView 

: 모델과 뷰 정보를 담아서 반환한다. 

 

 

물론 @Controller가 아니라 @Component 어노테이션을 붙이거나, 컴포넌트 스캔 없이 스프링 빈으로 직접 등록해서 동작한다. 

 

 

<ServletApplication>

//스프링 빈 직접 등록
@Bean
SpringMemberFormControllerV1 springMemberFormControllerV1() {
return new SpringMemberFormControllerV1();
}

 

 

 

 

📑 스프링 MVC 패턴 예제 2 - 반환형 String

 

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.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
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();

    //ModelAndView 반환해도 되고 String으로 반환해도 된다.
    @RequestMapping("/new-form")
    public String newForm() {
        return "new-form";
    }
    @RequestMapping("/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";
    }
    @RequestMapping
    public String members(Model model) {
        List<Member> members = memberRepository.findAll();
        model.addAttribute("members", members);
        return "members";
    }
}

 

 

🎃 Model 파라미터

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

 

🎃 ViewName 직접 반환

: 반환형 타입을 String으로 지정해 뷰의 논리 이름을 반환할 수 있다. 만약 뷰 이름이 아닌 HTTP 바디 메시지로 반환하고 싶을 경우 @ResponseBody 어노테이션을 메서드 위에 적어주면 된다.

 

🎃 @RequestParam 사용

: 스프링은 HTTP 요청 파라미터를 @RequestParam을 통해 받을 수 있다. 

@RequestParam("username") String username 은 request.getParameter("username")과 거의 같은 코드라고 볼 수 있다. 

 

 

 

아래 포스팅을 참고하여 HTTP 요청 파라미터에서 사용할 수 있는 어노테이션을 알아보자.

 

https://wonisdaily.tistory.com/120

[Spring Boot] HTTP 요청 파라미터, 메시지 ( @RequestParam, @ModelAttribute, @RequestBody, HttpEntity)