인프런 MVC 1 강의 정리 #5

1 . 스프링 MVC 전체 구조

스프링 MVC의 구조는 아래와 같다.

 

직접 만든 MVC 프레임워크 구조와 형태는 동일하지만 이름이 조금 달라졌다.

• FrontController -> DispatcherServlet
• handlerMappingMap -> HandlerMapping
• MyHandlerAdapter -> HandlerAdapter
• ModelView -> ModelAndView
• viewResolver -> ViewResolver
• MyView -> View

스프링 MVC의 핵심이자 프론트 컨트롤러인 디스패처 서블릿(DispatcherServlet)에 대해 알아보도록 하자.

 

- 서블릿 등록

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

- 요청 흐름

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

- DispatcherServlet.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);
}

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

 

1. 핸들러 조회: 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러)를 조회한다.

2. 핸들러 어댑터 조회: 핸들러를 실행할 수 있는 핸들러 어댑터를 조회한다.

3. 핸들러 어댑터 실행: 핸들러 어댑터를 실행한다.

4. 핸들러 실행: 핸들러 어댑터가 실제 핸들러를 실행한다.

5. ModelAndView 반환: 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다.

6. viewResolver 호출: 뷰 리졸버를 찾고 실행한다. 

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

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

 

- 인터페이스

스프링 MVC의 큰 강점은 DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다. 지금까지 설명한 대부분을 확장 가능할 수 있게 인터페이스로 제공한다. 주요 인터페이스 목록은 다음과 같다.

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

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

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

 

과거에 사용했던 스프링 컨트롤러를 알아보고자 코드를 직접 작성해보자. 

java/hello/servlet/web에 springmvc 패키지를 생성하고, 그 안에 old 패키지를 만들고 OldController 클래스를 생성한다.

import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

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

@Componenet를 통해 이 컨트롤러는 /springmvc/old-controller라는 이름의 스프링 빈으로 등록되었다. 빈의 이름으로 URL을 매핑할 것인데, 이 컨트롤러가 호출되기 위해서는 스프링 부트가 자동으로 등록하는  핸들러 매핑과 핸들러 어댑터가 필요하다.

 

- HandlerMapping

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

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

 

- HandlerAdapter

1. HandlerAdapter 의 supports() 를 순서대로 호출한다.

2. SimpleControllerHandlerAdapter 가 Controller 인터페이스를 지원하므로 대상이 된다.

3. 디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter 를 실행하면서 핸들러 정보도 함께 넘겨준다.

4. SimpleControllerHandlerAdapter 는 핸들러인 OldController 를 내부에서 실행하고, 그 결과를 반환한다.

 

다음으로 Controller 인터페이스가 아닌 HttpRequestHandler에 대해 알아보자.

java/hello/servlet/web/springmvc/old에 MyHttpRequestHandler 클래스를 생성한다.

import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Component;
import org.springframework.web.HttpRequestHandler;

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

 

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

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

3. HandlerAdapter 의 supports() 를 순서대로 호출한다.

4. HttpRequestHandlerAdapter 가 HttpRequestHandler 인터페이스를 지원하므로 대상이 된다.

5. 디스패처 서블릿이 조회한 HttpRequestHandlerAdapter 를 실행하면서 핸들러 정보도 함께 넘겨준다.

6. HttpRequestHandlerAdapter 는 핸들러인 MyHttpRequestHandler 를 내부에서 실행하고, 그 결과를 반환한다.

 

- @RequestMapping

가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터는 RequestMappingHandlerMapping , RequestMappingHandlerAdapter 이다. @RequestMapping 의 앞글자를 따서 만든 이름인데, 이것이 바로 지금 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 매핑과 어댑터이다. 실무에서는 99.9% 이 방식의 컨트롤러를 사용한다.

 

 3 . 뷰 리졸버

 OldController에서 view를 조회할 수 있도록 변경하기 위해 OldController 클래스에 return new ModelAndView("new-form"); 코드를 다음과 같이 추가한다.

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 new ModelAndView("new-form");
 }
}

 

위 코드를 실행하면 컨트롤러는 정상 호출되지만 화면이 출력되지 않기 때문에 application.properties 에 다음 코드를 추가한다.

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

 

스프링 부트는 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를 실행한다.

 

4 . 스프링 MVC - 시작하기

스프링은 애노테이션을 활용한 매우 유연하고, 실용적인 컨트롤러를 만들었는데 이것이 바로 @RequestMapping 애 노테이션을 사용하는 컨트롤러이다. 지금까지 만들었던 프레임워크에서 사용했던 컨트롤러를 @RequestMapping 기반의 스프링 MVC 컨트롤러 변경해보도록 하자.

 

@RequestMapping

• RequestMappingHandlerMapping
• RequestMappingHandlerAdapter

1) 회원 등록 폼

java/hello/servlet/web/springmvc에 v1 패키지를 생성하고, 그 안에 SpringMemberFormControllerV4 클래스를 생성한다.

import hello.servlet.web.frontcontroller.v4.ControllerV4;
import java.util.Map;

public class MemberFormControllerV4 implements ControllerV4 {

    @Override
    public String process(Map<String, String> paramMap, Map<String, Object> model) {
       return "new-form";
    }
}

 

- @Controller

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

- @RequestMapping

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

- ModelAndView

• 모델과 뷰 정보를 담아서 반환하면 된다.

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

 

2) 회원 저장

java/hello/servlet/web/springmvc/v1에 StringMemberSaveControllerV1 클래스를 생성한다. 코드는 이전에 작성했던 MembeSaveController와 비슷하다.

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

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

 

- mv.addObject("member", member)

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

3) 회원 목록

java/hello/servlet/web/springmvc/v1에 StringMemberListControllerV1 클래스를 생성한다. 

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

 

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

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

 

java/hello/servlet/web/springmvc에 v2 패지키를 생성하고, 그 안에 SpringMemberControllerV2 클래스를 생성한다.

앞서 v1에서 만들었던 SpringMember(Form/Save/List)Controller 클래스의 코드를 모두 통합한 것이다.

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

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/new-form")
• @RequestMapping("/springmvc/v2/members")
• @RequestMapping("/springmvc/v2/members/save")

이와 같은 중복을 제거하고자 @RequestMapping("/springmvc/v2/members")을 이용하면 조합은 다음과 같다.

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

 

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

MVC 프레임워크 만들기에서 v3은 ModelView를 개발자가 직접 생성해서 반환했기 때문에, 불편함이 있다. 이를 개선하는 코드를 작성해보자.

java/hello/servlet/web/springmvc에 v3 패지키를 생성하고, 그 안에 SpringMemberControllerV3 클래스를 생성한다.

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(value = "/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";
    }
}

 

- Model 파라미터 

• save() , members() 는 Model을 파라미터로 받는다. 

 

- ViewName

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

 

- @RequestParam 사용

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

- @RequestMapping -> @GetMapping, @PostMapping

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

회원 등록은 GET, 회원 저장은 POST, 그리고 회원 목록은 GET이다. 예를 들어서 URL이 /new-form 이고, HTTP Method가 GET인 경우를 모두 만족하는 매핑을 하려면 다음과 같이 처리하면 된다.

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

 

이것을 @GetMapping , @PostMapping 어노테이션을 이용해서 더 간단하게 나타낼 수 있다.