MVC 프레임워크 만들기 - 프론트 컨트롤러 Ver 5

유연한 컨트롤러

Q)어떤 개발자는 `ControllerV3` 방식으로 개발하고 싶고, 어떤 개발자는 `ControllerV4` 방식으로 개발하고 싶다면 어떻게 해야할까?

A) 어댑터 패턴
지금까지 우리가 개발한 프론트 컨트롤러는 한가지 방식의 컨트롤러 인터페이스만 사용할 수 있다. `ControllerV3` , `ControllerV4` 는 완전히 다른 인터페이스이다. 따라서 호환이 불가능하다.
이럴 때 사용하는 것이 바로 어댑터이다. 어댑터 패턴을 사용해서 프론트 컨트롤러가 다양한 방식의 컨트롤러를 처리할 수 있도록 변경해보자.

 

VER 5 구조

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

핸들러 어댑터

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

 

 

구현

어댑터는 이렇게 구현해야 한다는 어댑터용 인터페이스이다.

public interface MyHandlerAdapter {
    boolean supports(Object handler);
    ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws HttpServerErrorException, IOException;

}​

 

 boolean supports(Object handler);

handler는 컨트롤러를 말한다.
어댑터가 해당 컨트롤러를 처리할 수 있는지 판단하는 메서드이다.

  ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws HttpServerErrorException, IOException;​

 

어댑터는 실제 컨트롤러를 호출하고 , 그 결과로 ModelView를 반환해야 한다. (ver 3 과 동일)
실제 컨트롤러가 ModelView를 반환하지 못하면 어댑터가 ModelView를 직접 생성해서라도 반환해야 한다.
이전에는 프론트 컨트롤러가 실제 컨트롤러를 호출했지만 이제는 이 어댑터를 통해서 실제 컨트롤러가 호출 된다.

ControllerVer3을 지원하는 어댑터를 구현하자.

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

    @Override
    public ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws HttpServerErrorException, IOException {
        ControllerV3 controller = (ControllerV3) handler;
        Map<String, String> paramMap = createParamMap(request);
        ModelView mv = controller.process(paramMap);
        return mv ;
    }

    private static 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;
    }
}​

분석

 public boolean supports(Object handler) {
        return (handler instanceof ControllerV3);
    }

 

ControllerVer3을 처리할 수 있는 어댑터를 뜻한다. 

    public ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws HttpServerErrorException, IOException {
        ControllerV3 controller = (ControllerV3) handler;
        Map<String, String> paramMap = createParamMap(request);
        ModelView mv = controller.process(paramMap);
        return mv ;
    }​

핸들러를 ControllerVer3 으로 변환한 다음 V3 형식에 맞도록 호출한다.
컨트롤러 V3 은 ModelView를 반환하므로 그대로 반환하면 된다.

 

FrontControllerServlet 1 - V5 

@WebServlet(name = "frontControllerServletV5",urlPatterns = "/front-controller/v5/*")
public class FrontControllerServletV5 extends HttpServlet {
    private final Map<String, Object> HandlerMappingMap = new HashMap<>();
    private final List<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());
    }
//handler -- controller
    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        Object handler = getHandler(request);
        if (handler == null) {
            response.setStatus(HttpServletResponse.SC_NOT_FOUND);
            return;
        }
        MyHandlerAdapter adapter = getHandlerAdapter(handler);
        ModelView mv = adapter.handle(request, response, handler);
        String viewName = mv.getViewName();
        MyView view = viewResolve(viewName);
        view.render(mv.getModel(), request, response);
    }




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

    private MyHandlerAdapter getHandlerAdapter(Object handler) {
        MyHandlerAdapter a;
        for (MyHandlerAdapter adapter : handlerAdapters) {
            if(adapter.supports(handler)){
             return adapter;
            }

        }throw new IllegalArgumentException("handler adapter를 찾을 수 없습니다.");


    }



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

 

컨트롤러(Controller) ->핸들러(Handler)
이전에는 컨트롤러를 직접 맵핑하여 사용했으나 이제는 어댑터를 사용하기 때문에 컨트롤러 뿐만 아니라 어댑터가 지원하기만 하면

어떤 것이라도 URL에 매핑해서 사용할 수 있다. 그래서 이름을 컨트롤러에서 더 넒은 범위의 핸들러로 변경했다.

생성자 초기화

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

프론트 컨트롤러가 초기화될 때 호출되며, 핸들러 맵핑과 핸들러 어댑터를 초기화한다.

매핑정보

 private final Map<String, Object> HandlerMappingMap = new HashMap<>();

매핑 정보가 ControllerV3` ControllerV4` 같은 인터페이스에서 아무 값이나 받을 수 있는 Object 로 변경되었다.

           ver3은 한가지 인터페이스만 받음

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

핸들러 매핑

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

 

핸들러 매핑 정보인 `handlerMappingMap` 에서 URL에 매핑된 핸들러(컨트롤러) 객체를 찾아서 반환한다.

핸들러를 처리할 수 있는 어댑터 조회

MyHandlerAdapter adapter = getHandlerAdapter(handler)

 for (MyHandlerAdapter adapter : handlerAdapters) {
     if (adapter.supports(handler)) {
         return adapter;
     }
}

`handler` 를 처리할 수 있는 어댑터를 `adapter.supports(handler)` 를 통해서 찾는다.
handler가 `ControllerV3` 인터페이스를 구현했다면, `ControllerV3HandlerAdapter` 객체가 반환된다.

(ControllerV4도 마찬가지 ..)

어댑터 호출

 ModelView mv = adapter.handle(request, response, handler);

어댑터의 `handle(request, response, handler)` 메서드를 통해 실제 어댑터가 호출된다.
어댑터는 handler(컨트롤러)를 호출하고 그 결과를 어댑터에 맞추어 반환한다. `ControllerV3HandlerAdapter` 의 경우 어댑터의 모양과 컨트롤러의 모양이 유사해서 변환 로직이 단순하다.

 

 

FrontControllerServlet 2 - V5 

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 HttpServerErrorException, IOException {
        ControllerV4 controller = (ControllerV4) handler;

        Map<String, String> paramMap = createParamMap(request);
        Map<String, Object> model = new HashMap<>();
        String viewName = controller.process(paramMap, model);
        ModelView mv = new ModelView(viewName);
        mv.setModel(model);

        return mv;
    }

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

분석

public boolean supports(Object handler) {
        return (handler instanceof ControllerV4);
    }

handler가 ControllerV4인 경우에만 처리하는 어댑터이다.

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

        Map<String, String> paramMap = createParamMap(request);
        Map<String, Object> model = new HashMap<>();
        String viewName = controller.process(paramMap, model);
      
    }

handler를 ControllerV4로 케스팅 하고, paramMap, model을 만들어서 해당 컨트롤러를 호출한다. 그리고 viewName을 반환 받는다.

  ModelView mv = new ModelView(viewName);
  mv.setModel(model);
  return mv;

어댑터에서 이 부분이 단순하지만 중요한 부분이다.-반환타입 맞추는 과정

어댑터가 호출하는 `ControllerV4` 는 뷰의 이름을 반환한다. 그런데 어댑터는 뷰의 이름이 아니라 `ModelView` 를 만들어서 반환해야 한다. 여기서 어댑터가 꼭 필요한 이유가 나온다. `ControllerV4` 는 뷰의 이름을 반환했지만, 어댑터는 이것을 ModelView로 만들어서 형식을 맞추어 반환한다. 마치 110v 전기 콘센트를 220v 전기 콘센트로 변경하듯이!

 

ver3 , ver5 비교

ver3

ver5