스프링 MVC 1 - Model 추가 v3

Model 추가 - v3

서블릿 종속성 제거

각 컨트롤러 입장에서 HttpServletRequest, HttpServletResponse이 필요하지 않다.
요청 파라미터 정보는 자바의 Map으로 대신 넘기도록 하면 지금 구조에서는 컨트롤러가 서블릿 기술을 몰라도 동작할 수 있다.
그리고 request 객체를 Model로 사용하는 대신 별도의 Model 객체를 만들어서 반환하면 된다.

컨트롤러에서 서블릿 기술을 전혀 사용하지 않도록 해보자.
구현 코드도 단순해지고, 테스트 코드 작성이 쉬워지는 효과가 생긴다.

뷰 이름 중복 제거

return new MyView("/WEB-INF/views/new-form.jsp"); -> new-form
return new MyView("/WEB-INF/views/members.jsp"); -> save-result
return new MyView("/WEB-INF/views/save-result.jsp"); -> members

컨트롤러에서 지정하는 뷰 이름에 중복이 있다.

프론트 컨트롤러는 하나지만, 각 컨트롤러는 다수이기 때문에 프론트 컨트롤러에서 부가적인 기능을 하고, 핵심 비즈니스 로직은 각 컨트롤러에서 동작하도록 하자.

컨트롤러는 뷰의 논리 이름을 반환하고 실제 물리 위치의 이름은 프론트 컨트롤러에서 처리하도록 하자.
향후 뷰의 폴더 위치가 함께 이동해도 프론트 컨트롤러만 고치면 되는 효과가 생긴다.

V3 구조

1. 클라이언트가 요청한다.
2. 프론트 컨트롤러는 매핑 정보를 조회해서 컨트롤러를 호출한다.
3. 프론트 컨트롤러에 기존에는 View를 반환했지만, 이제는 ModelView를 반환한다.
4. 프론트 컨트롤러가 viewResolver를 호출한다.
5. 뷰의 논리 이름만 반환하기 때문에 물리 이름으로 바꿔줘야 하는데 이를 viewResolver가 바꿔서 MyView를 프론트 컨트롤러에 반환한다.
6. 프론트 컨트롤러는 반환 값을 받아 MyView를 호출한다.
7. 클라이언트에 HTMl 응답을 한다.

ModelView

컨트롤러에서 서블릿에 종속적인 HttpServletRequest를 사용했다.
그리고 Model도 request.setAttribute()를 통해 데이터를 저장하고 뷰에 전달했다.
서블릿 종속성을 제거하기 위해 Model을 직접 만들고 추가로 View 이름까지 전달하는 객체를 만들어보자.

이번 버전에서는 컨트롤러에서 HttpServletRequest를 사용할 수 없다.
따라서 직접 request.setAttribute()를 호출할 수 도 없기 때문에 Model이 별도로 필요하다.

// package hello.servlet.web.frontcontroller;

@Getter @Setter
public class ModelView {
    private String viewName;
    private Map<String, Object> model = new HashMap<>();

    public ModelView(String viewName) {
        this.viewName = viewName;
    }
}

뷰의 이름과 뷰 렌더링에 필요한 model 객체를 가지고 있다.
model은 단순하게 map으로 되어 있기 때문에 컨트롤러에서 view에 필요한 데이터를 key, value로 넣어줘야 한다.

ControllerV3

// package hello.servlet.web.frontcontroller.v3;

public interface ControllerV3 {
    ModelView process(Map<String, String> paramMap);
}

이 컨트롤러는 서블릿 기술을 전혀 사용하지 않는다.
따라서 구현이 단순하고 테스트 코드 작성시 테스트도 쉽다.
HttpServletRequest가 제공하는 파라미터는 프론트 컨트롤러가 paramMap에 담아서 호출하면 된다.
응답 결과로 뷰 이름과 뷰에 전달할 Model 데이터를 포함하는 ModelView 객체를 반환하면 된다.

MemberFormControllerV3 - 회원 등록 폼

// package hello.servlet.web.frontcontroller.v3.controller;

public class MemberFormControllerV3 implements ControllerV3 {
    @Override
    public ModelView process(Map<String, String> paramMap) {
        return new ModelView("new-form");
    }
}

ModelView를 생성할 때 new-form이라는 view의 논리적인 이름을 지정한다.
실제 물리적인 이름은 프론트 컨트롤러에서 처리한다.

MemberSaveControllerV3 - 회원 저장

public class MemberSaveControllerV3 implements ControllerV3 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

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

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

        ModelView mv = new ModelView("save-result");
        mv.getModel().put("member", member);
        return mv;
    }
}

파라미터 정보는 map에 담겨있기 때문에 paramMap.get("username");에서 필요한 요청 파라미터를 조회하면 된다.

mv.getModel().put("member", member);
모델은 단순한 map이기 때문에 모델에 뷰에서 필요한 member 객체를 담고 반환한다.

MemberListControllerV3 - 회원 목록

public class MemberListControllerV3 implements ControllerV3 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    public ModelView process(Map<String, String> paramMap) {
        List<Member> members = memberRepository.findAll();
        ModelView mv = new ModelView("members");
        mv.getModel().put("members", members);

        return mv;
    }
}

MyView

FrontController V3에서 사용할 메서드가 있어 MyView를 수정해야 한다.
다음 코드로 수정하자.

public class MyView {
    private String viewPath;

    public MyView(String viewPath) {
        this.viewPath = viewPath;
    }

    public void render(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
        dispatcher.forward(request, response);
    }

    public void render(Map<String, Object> model, HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        modelToRequestAttribute(model, request);
        RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
        dispatcher.forward(request, response);
    }
    private void modelToRequestAttribute(Map<String, Object> model,
                                         HttpServletRequest request) {
        model.forEach((key, value) -> request.setAttribute(key, value));
    }
}

FrontControllerServletV3

@WebServlet(name = "frontControllerServletV3", urlPatterns = "/front-controller/v3/*")
public class FrontControllerServletV3 extends HttpServlet {

    private Map<String, ControllerV3> controllerMap = new HashMap<>();

    public FrontControllerServletV3() {
        controllerMap.put("/front-controller/v3/members/new-form", new MemberFormControllerV3());
        controllerMap.put("/front-controller/v3/members/save", new MemberSaveControllerV3());
        controllerMap.put("/front-controller/v3/members", new MemberListControllerV3());
    }

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("FrontControllerServletV3.service");
        String requestURI = request.getRequestURI(); // 클라이언트 URL에서 controllerMap에 있는 URL중 하나를 찾아서 클래스를 생성해준다.

        ControllerV3 controller = controllerMap.get(requestURI);
        if(controller == null) {
            response.setStatus(HttpServletResponse.SC_NOT_FOUND);
            return;
        }

        Map<String, String> paramMap = createParamMap(request);
        ModelView mv = controller.process(paramMap);

        String viewName = mv.getViewName();
        MyView view = viewResolver(viewName);
        view.render(mv.getModel(), request, response);

    }

    private Map<String, String> createParamMap(HttpServletRequest request) {
        Map<String, String> paramMap = new HashMap<>();
        request.getParameterNames().asIterator()
                .forEachRemaining(paramName -> paramMap.put(paramName, request.getParameter(paramName)));

        return paramMap;
    }

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

createParamMap()
HttpServletRequest에서 파라미터 정보를 꺼내서 Map으로 변환한다.
그리고 해당 Map(paramMap)을 컨트롤러에 전달하며 호출한다.

뷰 리졸버

MyView view = viewResolver(viewName)
컨트롤러가 반환한 논리 뷰 이름을 실제 물리 뷰 경로로 변경한다.
그리고 실제 물리 경로가 있는 MyView 객체를 반환한다.

view.render(mv.getModel(), request, response)

• 뷰 객체를 통해 HTML 화면을 렌더링 한다.
• 뷰 객체의 render()는 모델 정보도 받는다.
• JSP는 request.getAttribute()로 데이터를 조회하기 때문에 데이터를 꺼내서 request.setAttribute()로 담아둔다.
• JSP를 포워드 해서 JSP를 렌더링 한다.

출처 : 인프런 김영한 지식 공유자님 강의 - 스프링 MVC 1편 백엔드 웹 개발 핵심 기술