프론트 컨트롤러 패턴 소개5

유연한 컨트롤러1 - v5

개발을 하다보면 개발자 마다 선호하는 컨트롤러가 다르다 어떤 개발자는 ControllerV3방식으로 개발하고 싶어하고, 어떤 개발자는 ControllerV4방식으로 개발하고 싶어할 수 있다. 그러면 지금까지 우리가 만든 MVC패턴의 프레임 워크는 사용이 불가능하다. 그래서 v5에서는 이러한 점을 보완하려고 한다. 그래서 등장한것이 어댑터 패턴이다.

 

어댑터 패턴

어댑터 패턴이란 인터페이스 호환성 문제 때문에 같이 사용할 수 없는 클래스를 어댑터를 사용하여 연결해서 사용하는것을 말한다. 마치 우리가 핸드폰을 충전할때 누구는 C-type으로 충전하는 핸드폰을 사용하고 누구는 라이트링 포트로 충전하는 핸드폰을 사용할 때 각각의 단자마다 전기를 공급하는게 다르면 매우 불편 할 것이다. 그래서 우리는 어댑터라는것을 사용하여 C-type, 라이트닝 포트 모두를 동일하게 전기를 공급할 수 있다. 이처럼 어댑터 패턴을 사용해서 프론트 컨트롤러가 다양한 방식의 컨트롤러를 처리 할 수 있도록 해보자

V5 구조

 

핸들러 어댑터 : 중간에 어댑터 역할을 하는 어댑터가 추가되었는데 이름이 핸들러 어댑터이다. 여기서 어댑터 역할을 해주는 덕분에 다양한 종류의 컨트롤러를 호출할 수 있다.

핸들러: 컨트롤러의 이름을 더 넓은 범위인 핸들러로 변경했다. 그 이유는 이제 어댑터가 있기 때문에 꼭 컨트롤러의 개념 뿐만 아니라 어떠한 것이든 해당하는 종류의 어댑터만 있으면 다 처리할 수 있기 때문이다.

MyHandlerAdapter

package hello.servlet.web.frontcontroller.v5;

import hello.servlet.web.frontcontroller.ModelView;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

//핸들러가 맞는지 확인하고 핸들러를 실행시키는 역할을 한다.
public interface MyHandlerAdapter  {

    //컨트롤러가 넘어왔을때 지원할 수 있는 컨트롤러인지 확인한다.
    boolean supports(Object handler);

    //지원되는거면 적용한다, 다룬다.
    ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws ServletException, IOException;

}

어댑터용 인터페이스 이다.

 

ControllerV3HandlerAdapter 

public class ControllerV3HandlerAdapter implements MyHandlerAdapter {

    //V3에 맞는 핸들러인지 확인한다.
    @Override
    public boolean supports(Object handler) {
        return (handler instanceof ControllerV3);
    }

    //v3 핸들러가 맞다면 controller를 process해준다.
    //v3 핸들러는 process할 때 paramMap을 인자로 받는다.
    @Override
    public ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws ServletException, IOException {

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

    }


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

어답터v3

ControllerV4HandlerAdapter

public class ControllerV4HandlerAdapter implements MyHandlerAdapter {
    @Override
    public boolean supports(Object handler) {
        return (handler instanceof ControllerV4);
    }

    @Override
    public ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws ServletException, IOException {
        ControllerV4 controller = (ControllerV4) handler;

        Map<String, String> paramMap = createParamMap(request);
        HashMap<String, Object> model = new HashMap<>();

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

        //어댑터에서 ModelView를 만들어준다.
        //어댑터 다운 역할
        ModelView mv = new ModelView(viewName);
        mv.setModel(model);

        return mv;
    }

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

어답터v4

ControllerV4의 process함수 반환값은 String이다. 그래서 어답터에서 ModelView반환값에 맞게 ModelView객체를 생성해서 값을 넣어주는 코드가 추가된다.

 

FrontControllerServletV5

package hello.servlet.web.frontcontroller.v5;

import hello.servlet.web.frontcontroller.ModelView;
import hello.servlet.web.frontcontroller.MyView;
import hello.servlet.web.frontcontroller.v3.ControllerV3;
import hello.servlet.web.frontcontroller.v3.controller.MemberFormControllerV3;
import hello.servlet.web.frontcontroller.v3.controller.MemberListControllerV3;
import hello.servlet.web.frontcontroller.v3.controller.MemberSaveControllerV3;
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 hello.servlet.web.frontcontroller.v5.adapter.ControllerV3HandlerAdapter;
import hello.servlet.web.frontcontroller.v5.adapter.ControllerV4HandlerAdapter;

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.ArrayList;
import java.util.HashMap;
import java.util.Map;

@WebServlet(name = "frontControllerServletV5", urlPatterns = "/front-controller/v5/*")
public class FrontControllerServletV5 extends HttpServlet {

    //기존 private Map<String, ControllerV3> controllerMap = new HashMap<>();
    //핸들러 매핑 정보를 담는애
    private final Map<String, Object> handlerMappingMap = new HashMap<>();
    //핸들러 어댑터를 담는애(사용하고 싶은 핸들러 어댑터를 담는다.)
    private final ArrayList<MyHandlerAdapter> handlerAdapters = new ArrayList<>();

    public FrontControllerServletV5() {
        initHandlerMappingMap();
        initHandlerAdapters();
    }

    private void initHandlerMappingMap() {
        handlerMappingMap.put("/front-controller/v5/v3/members/new-form", new MemberFormControllerV3());
        handlerMappingMap.put("/front-controller/v5/v3/members/save", new MemberSaveControllerV3());
        handlerMappingMap.put("/front-controller/v5/v3/members", new MemberListControllerV3());

        //v4추가
        handlerMappingMap.put("/front-controller/v5/v4/members/new-form", new MemberFormControllerV4());
        handlerMappingMap.put("/front-controller/v5/v4/members/save", new MemberSaveControllerV4());
        handlerMappingMap.put("/front-controller/v5/v4/members", new MemberListControllerV4());
    }

    private void initHandlerAdapters() {
        handlerAdapters.add(new ControllerV3HandlerAdapter());
        handlerAdapters.add(new ControllerV4HandlerAdapter());
    }

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        //핸들러 즉 uri에 따른 컨트롤러를 가져오는 로직
        Object handler = getHandler(request);

        if(handler == null){
            response.setStatus(HttpServletResponse.SC_NOT_FOUND);
            return;
        }

        //가져온 핸들러에 맞는 어답터를 찾는 과정
        MyHandlerAdapter Adapter = getHandlerAdapter(handler);

        //어답터를 찾았으면 해당 어답터로 handle함수(controller process)를 실행
        ModelView mv = Adapter.handle(request, response, handler);

        //상대경로 찾고
        String viewName = mv.getViewName();
        //절대 경로 찾고
        MyView view = viewResolver(viewName);
        //모델 넘겨주고 view로 render해줌
        view.render(mv.getModel(), request, response);

    }

    private Object getHandler(HttpServletRequest request) {
        String requestURI = request.getRequestURI();
        return handlerMappingMap.get(requestURI);
    }

    private MyHandlerAdapter getHandlerAdapter(Object handler) {
        for (MyHandlerAdapter adapter : handlerAdapters) {
            if(adapter.supports(handler)){
                return adapter;
            }
        }
        throw new IllegalArgumentException("handler adapter를 찾을 수 없습니다. = "+ handler);
    }

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

코드에 대해 간략히 설명하겠다. 생성자부분에서 handlerMappingMap에 uri값에 따른 핸들러를 매핑 시킬 수 있는 값을 넣어주고, handlerAdapters에 위에서 만든 어답터를 넣어준다. 그리고 대분분의 코드는 밖으로 빼줬다. 그리고 uri에 따른 handler를 getHandler()를 통해 가져오고, 이제 이 핸들러를 process할 수 있게 어답터를 찾아야하는데 getHandlerAdapter()를 통해 handlerAdapters에 담은 어답터에서 지금 핸들러를 사용할 수 있게 하는 어답터를 찾고 해당 어답터로 handle함수를 실행한다. 그러면 비즈니스 로직이 수행되고 ModelView 객체를 반환하면 나머지는 동일하다.

 

이로써 프론트 컨트롤러에서 다양한 방식의 컨트롤러의 사용이 가능해졌다.

 

 

코드 : refactor : 유연한 컨트롤러1-2 -v5

https://github.com/dlqjagml/spring/commits/master

출처 : https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-mvc-1