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

인프런 강의 31일차.

 - 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 1 (김영한 강사님)

 - 서블릿, JSP, MVC 패턴

 - 서블릿으로 1차 구현

   -> 서블릿으로 구현했을 때 불편한 점 개선을 위해 JSP로 2차 구현

   -> JSP로도 불편한 점을 개선하기 위해 MVC 패턴으로 3차 구현

 

---- 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 12 Model 추가 - v3에 이어서 작성.

2. MVC 프레임워크 만들기

 2.6 단순하고 실용적인 컨트롤러 - v4

  - 앞서 만든 v3 컨트롤러는 서블릿 종속성을 제거하고 뷰 경로의 중복을 제거하는 등, 잘 설계된 컨트롤러이다.

  - 아키텍처 관점에서는 정말로 잘 설계된 컨트롤러이나 실제 개발자 입장에서는 항상 ModelView 객체를 생성하고 반환해야 하는 부분이 있어서 사용이 불편하다는 단점이 있다.

  - 실용성이 조금 떨어지는 것을 개선한 v4 컨트롤러를 만들어보자.

기본적인 구조는 v3와 같으나 컨트롤러가 ModelView를 반환하지 않고, viewName을 반환하는 구조 (v4)

package hello.servlet.web.frontcontroller.v4;

import java.util.Map;

public interface ControllerV4 {

    /**
     * @param paramMap
     * @param model
     * @return viewName
     */
    String process(Map<String, String> paramMap, Map<String, Object> model);
}

  - web.frontcontroller.v4.ControllerV4.java

  - paramMap만 리턴하던 것에서 model도 같이 리턴하도록 수정

  - 인터페이스에 modelView가 없다. model객체는 파라미터로 전달되기 때문에 그냥 사용하면 되고, 결과로 뷰의 이름만 반환해주면 된다.

 

package hello.servlet.web.frontcontroller.v4.controller;

import hello.servlet.web.frontcontroller.ModelView;
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";
    }
}

  - web.frontcontroller.v4.controller.MemberFormControllerV4.java

  - 단순하게 new-form이라는 뷰의 논리 이름만 반환하는 컨트롤러

 

package hello.servlet.web.frontcontroller.v4.controller;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import hello.servlet.web.frontcontroller.v4.ControllerV4;

import java.util.Map;

public class MemberSaveControllerV4 implements ControllerV4 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    public String process(Map<String, String> paramMap, Map<String, Object> model) {
        String username = paramMap.get("username");
        int age = Integer.parseInt(paramMap.get("age"));

        Member member = new Member(username, age);
        memberRepository.save(member);

        model.put("member", member);
        return "save-result";

        /*
        V3과 달라진 점은 이미 컨트롤러에서 model을 바로 세팅하기 때문에 아래 로직이 필요가 없다(이미 세팅되어 있음)
        ModelView mv = new ModelView("save-result");
        mv.getModel().put("member", member);    //멤버 모델에 저장
        return mv;
         */
    }
}

  - web.frontcontroller.v4.controller.MemberSaveControllerV4.java

  - 모델이 파라미터로 전달되기 때문에 모델을 직접 생성하지 않아도 된다. (model.put()으로 전달됨)

 

package hello.servlet.web.frontcontroller.v4.controller;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import hello.servlet.web.frontcontroller.v4.ControllerV4;

import java.util.List;
import java.util.Map;

public class MemberListControllerV4 implements ControllerV4 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    public String process(Map<String, String> paramMap, Map<String, Object> model) {
        List<Member> members = memberRepository.findAll();

        /*
        form과 마찬가지로 model에 이미 처리되어 있으므로 필요가 없는 로직
        ModelView mv = new ModelView("members");
        mv.getModel().put("members", members);      //members 리스트로 저장
        return mv;
         */
        model.put("members", members);
        return "members";
    }
}

  - web.frontcontroller.v4.controller.MemberListControllerV4.java

 

package hello.servlet.web.frontcontroller.v4;

import hello.servlet.web.frontcontroller.MyView;
import hello.servlet.web.frontcontroller.ModelView;
import hello.servlet.web.frontcontroller.v4.controller.MemberFormControllerV4;
import hello.servlet.web.frontcontroller.v4.controller.MemberListControllerV4;
import hello.servlet.web.frontcontroller.v4.controller.MemberSaveControllerV4;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;


//v4 하위에 모든 컨트롤러를 호출할 수 있음
@WebServlet(name="frontControllerServletV4", urlPatterns = "/front-controller/v4/*")
public class FrontControllerServletV4 extends HttpServlet {

    private Map<String, ControllerV4> controllerV1Map = new HashMap<>();

    public FrontControllerServletV4() {
        //url과 호출해야하는 컨트롤러를 매핑하여 Map에 저장
        controllerV1Map.put("/front-controller/v4/members/new-form", new MemberFormControllerV4());
        controllerV1Map.put("/front-controller/v4/members/save", new MemberSaveControllerV4());
        controllerV1Map.put("/front-controller/v4/members", new MemberListControllerV4());
    }

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("FrontControllerServletV4.service");

        String requestURI = request.getRequestURI();    //호출되는 URL 주소 얻기

        ControllerV4 controllerV4 = controllerV1Map.get(requestURI);    //url 주소에 해당하는 Controller생성
        if(controllerV4 == null){
            //매칭되는 컨트롤러가 없으면 404 에러 리턴
            response.setStatus(HttpServletResponse.SC_NOT_FOUND);
            return;
        }
        Map<String, String> paramMap = createParamMap(request);
        HashMap<String, Object> model = new HashMap<>();

        //매칭되는 컨트롤러를 찾았으면 해당 컨트롤러 호출
        String viewName = controllerV4.process(paramMap, model);    //기존에 Model을 받던 로직을 viewName을 바로 받도록 수정 (V4에서 수정된 코드)

        //viewResolver 구현 (실제 View를 찾아주는 해결자 역할)
        MyView view = viewResolver(viewName);

        //myView 반환하면서 렌더링 수행
        view.render(model, request, response);
    }

    private MyView viewResolver(String viewName) {
        return new MyView("/WEB-INF/views/" + viewName + ".jsp");
    }


    //ctrl + alt + M 으로 람다 표현식 메소드로 추출
    private Map<String, String> createParamMap(HttpServletRequest request) {
        Map<String, String> paramMap = new HashMap<>();
        request.getParameterNames().asIterator()        //모든 파라미터 이름을 가져온 뒤 forEach 돌린 뒤 paramMap에 모든 데이터를 put함
                .forEachRemaining(paramName->paramMap.put(paramName, request.getParameter(paramName)));
        return paramMap;
    }
}

  - web.frontcontroller.v4.controller.MemberListControllerV4.java

  - FrontControllerV4는 FrontControllerV3과 거의 동일하며 controller.process의 return이 model이 아닌 viewName이 되었다는 것만 변경되었다.

  - 모델 객체 전달

   > Map<String, Object> Model = new HashMap<>();

   > 모델 객체를 프론트 컨트롤러에서 생성해서 넘겨준다. 컨트롤러에서 모델 객체에 값을 담으면 여기에 그대로 담겨있게 된다.

  - 뷰의 논리 이름을 직접 반환

   > String viewName = controller.process(paramMap, model);

   > MyView view = viewResolver(viewName);

   > 컨트롤러가 직접 뷰의 논리 이름을 반환하므로 이 값을 사용해서 실제 물리 뷰를 찾을 수 있다.

 

 * V4 버전의 컨트롤러는 매우 단순하고 실용적이다. 기존 구조에서 모델을 파라미터로 넘기고, 뷰의 논리 이름을 반환한다는 작은 아이디어를 적용한 것 뿐인데 컨트롤러를 구현하는 개발자 입장에서 보면 이제 군더더기 없는 코드를 작성할 수 있다.

 ** 프레임워크나 공통 기능이 수고로워야 사용하는 개발자가 편리해진다.