[Spring] MVC 1편 - 05. 스프링 MVC - 구조 이해

somyeong·2022년 4월 28일
MVCSpring
0

Spring

목록 보기
15/17
post-thumbnail
post-custom-banner

이 글은 스프링 [스프링 MVC 1편]을 듣고 정리한 내용입니다

앞으론 정리 주요내용만 간단하게 하도록 하자 꼭 ....

📌 스프링 MVC 전체 구조

  • 저번시간까지 직접 만든 MVC 프레임워크와 스프링 MVC를 비교해보자


DispatcherServlet 구조

org.springframework.web.servlet.DispatcherServlet

  • 스프링 MVC도 프론트 컨트롤러 패턴으로 구현되어 있다.
  • 스프링 MVC의 프론트 컨트롤러가 **디스패쳐 서블릿(DispatcherServlet)이다 -> 이것이 바로 스프링 MVC의 핵심이다.

DispatcherServlet 서블릿 등록

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

요청 흐름

  • 서블릿이 호출되면 HttpServlet이 제공하는service()가 호출된다.

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. ModelView 반환: 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다.
  6. viewResolver 호출: 뷰 리졸버를 찾고 실행한다.
    • JSP의 경우, InternalResourceViewResolver가 자동 등록되고, 사용된다.
  7. View 반환: 뷰 리졸버는 뷰의 논리 이름을 물리 이름으로 바꾸고, 렌더링 역할을 담당하는 뷰 객체를 반환한다.
    • JSP의 겨우 InternalResourceView(JstlView)를 반환하는데, 내부에 forward() 로직이 있다.
  8. 뷰 렌더링: 뷰를 통해서 뷰를 렌더링한다.

스프링의 인터페이스

  • 스프링 MVC의 큰 장점은 DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다.
  • 스프링이 제공하는 인터페이스들로 거의 모든것을 해결할수 있다.(직접 만들필요 x)

주요 인터페이스

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

정리

  • 이렇게, 스프링 MVC의 핵심 동작방식을 알아두면, 향후 문제가 발생했을 때 어떤 부분인지 쉽게 파악하여 문제를 해결할 수 있다. 또한 확장하려고 할때 어떤 부분을 확장해야 할지 감 잡을 수 있다.
  • 전체적인 구조를 이해하자!!

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

  • 과거에 주로 사용했던 핸들러 매핑과 어댑터를 알아보자

Controller 인터페이스
(과거 버전 스프링 컨트롤러, 어노테이션과 다른것임 주의.)

 public interface Controller {
    ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse
  response) throws Exception;
}

Old Controller

package hello.servlet.web.springmvc.old;

@Component("/springmvc/old-controller") //해당 스프링 빈의 이름이 /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;
    }
}
  • 빈의 이름으로 URL을 매핑한다


위의 Old Controller가 호출되려면 2가지가 필요하다

  • 1. HandlerMapping (핸들러 매핑)

    • 핸들러 매핑에서 이 컨트롤러를 찾을 수 있어야 한다.
    • ex) 스프링 빈의 이름으로 핸들러를 찾을 수 있는 핸들러 매핑이 필요하다.

  • 2. HandelrAdapter (핸들러 어댑터)

    • 핸들러 매핑을 통해서 찾은 핸들러를 실행할 수 있는 핸들러 어댑터가 필요하다
    • ex) Controller인터페이스를 실행할 수 있는 핸들러 어댑터를 찾고 실행해야 한다.

알아야할 핸들러 매핑과 핸들러 어댑터

  • 스프링에서 제공하는 핸들러 매핑과 핸들러 어댑터는 종류가 많다.
  • 일단은 우선순위 높은것만 알자!!
    핸들러 매핑: RequestMappingHandlerMapping
    핸들러 어댑터: RequestMappingHandlerAdapter
  • 이것들은 @RequestMapping 앞글자를 따서 만들었다. 애노테이션 기반의 컨트롤러를 지원하는 매핑과 어댑터이다.
  • 실무에서 거의(99퍼) 이 방식의 컨트롤러를 사용한다.

📌 뷰 리졸버

OldController - View 조회할 수 있도록 변경

package hello.servlet.web.springmvc.old;

@Component("/springmvc/old-controller") //해당 스프링 빈의 이름이 /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"); //View를 사용할 수 있도록 해당 코드 추가함.
    }
}

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 설정 정보를 사용해서 등록한다.

스프링 MVC 구조 - 뷰 리졸버 동작 방식

    1. 핸들러 어댑터 호출
    • 핸들러 어댑터를 통해 new-form이라는 논리 뷰 이름을 획득한다.
    1. ViewResolver 호출
    • new-form이라는 뷰 이름으로 viewResolver를 순서대로 해출한다.
    • BeanNameViewResolver는 new-form이라는 이름의 스프링 빈으로 등록한 뷰를 찾아야 하는데 없으므로 InternalResourveViewResolver가 호출된다.
    1. InternalResourceViewResolver
    • 이 뷰 리졸버는 InternalResourceView를 반환한다.
    1. 뷰 - InternalResourceView
    • InternalResourceView는 JSP처럼포워드 forward()를 호출해서 처리할 수 있는 경우에 사용한다.
    1. view.render()
    • view.render()가 호출되고 InternalResourceView는 forward()를 사용해서 JSP를 실행한다.

*참고
다른 뷰는 실제 뷰를 랜더링 하지만, JSP의 경우 forward()를 통해서 해당 JSP로 이동(실행)해야 랜더링이 된다. 다른 뷰 템플릿들은 forward()과정 없이 바로 랜더링 된다

*참고
Thymeleaf 뷰 템플릿을 사용하면 ThymeleafViewResolver를 등록해야 한다. 최근에는 라이브러리만 추가하면 스프링 부트가 알아서 자동화 해준다.

📌 스프링 MVC - 시작하기

❗️ 여기부터 중요

@RequestMapping

@RequestMapping 어노테이션을 사용하는 컨트롤러는 스프링이 만든 어노테이션을 활용한 매우 유연하고 실용적인 컨트롤러이다.

  • @RequestMapping
    - RequestMappingHandlerMapping
    - RequestMappingHandlerAdapter
    이것이 바로 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 핸들러 매핑과 어댑터이다.
    실무에서는 99.9% 이 방식의 컨트롤러를 사용한다
  • @ReuqestMapping 기반의 스프링 MVC 컨트롤러로 변경해보자

SpringMemberFormControllerV1 - 회원 등록 폼

package hello.servlet.web.springmvc.v1;

@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");
      }
}
  • 컴포넌트 스캔 대신 스프링 빈으로 직접 등록해도 동작한다.(수동 등록 참고)

SpringMemberSaveControllerV1 - 회원 저장

package hello.servlet.web.springmvc.v1;

@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를 통해 데이터를 추가할 때는 addObject()를 사용하면 된다. 이 데이터는 이후 뷰를 렌더링 할때 사용된다.

SpringMemberListControllerV1 - 회원 목록

package hello.servlet.web.springmvc.v1;

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

📌 스프링 MVC - 컨트롤러 통합

  • 컨트롤러 클래스를 유연하게 하나로 통합 할 수 있다.

SpringMemberControllerV2

package hello.servlet.web.springmvc.v2;

@Controller
@RequestMapping("/springmvc/v2/members")// 이렇게 통합해서 url공통되는 부분 지정 가능하다.
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 //url에 더할게 없으니까 비워두면 됨.
    public ModelAndView members() {
        List<Member> members = memberRepository.findAll();

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


}

조합

  • url 중복되는 부분을 통합하여 클래스단에 @RequestMapping으로 중복을 제거할 수 있다.

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

  • 실무에서 주로 사용하는 방식을 알아보자

SpringMemberControllerV3

package hello.servlet.web.springmvc.v3;

/**
*v3
*Model 도입
*@RequestParam 사용
*@RequestMapping -> @GetMapping, @PostMapping
*/
@Controller
@RequestMapping("/springmvc/v3/members")
public class SpringMemberControllerV3 {
    private MemberRepository memberRepository  = MemberRepository.getInstance();

//    @RequestMapping(value="/new-form", method= RequestMethod.GET) //두번째 인자를 이렇게 설정하면 GET호출만 가능하다.
    @GetMapping("/new-form")
    public String newForm() { //이렇게 String타입으로 반환받으면, 알아서 뷰 이름으로 알고 프로세스가 진행이 된다.
        return "new-form";
    }

//    @RequestMapping(value = "/save", method = RequestMethod.POST)
    @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";

    }

//    @RequestMapping(method=RequestMethod.GET)
    @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 구분을 함께 할 수 있다.
  • 이런식으로 하면 되면 된다.
@RequestMapping(value = "/new-form", method = RequestMethod.GET)
  • @GetMapping, @PostMapping을 사용 하면 더 편하다
  • Get, Post, Put, Delete, Patch 등도 모두 어노테이션이있다.
profile
somyeong
공부한 내용 잊어버리지 않게 기록하는 공간!
이전 포스트

[Spring] MVC 1편 - 04. MVC 프레임워크 만들기

다음 포스트

[Spring] MVC 1편 - 06. 스프링 MVC - 기본 기능

post-custom-banner

0개의 댓글