Ch04. MVC 프레임워크 만들기 - 유연한 컨트롤러 (v5)

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

• 현재는 인터페이스 타입이 고정이 되어 있기 때문에  원하는 방식이 선택이 안된다.

어댑터 패턴

• 지금까지 우리가 개발한 프론트 컨트롤러는 한 가지 방식의 컨트롤러 인터페이스만 사용할 수 있다.
• ControllerV3 , ControllerV4는 완전히 다른 인터페이스이다. 따라서 호환이 불가능하다.
• 마치 v3는 110v이고, v4는 220v 전기 콘센트 같은 것이다. 이럴 때 사용하는 것이 바로 어댑터이다.
• 어댑터 패턴을 사용해서 프론트 컨트롤러가 다양한 방식의 컨트롤러를 처리할 수 있도록 변경해보자

v5 구조

• 핸들러 어댑터: 중간에 어댑터 역할을 하는 어댑터가 추가되었는데 이름이 핸들러 어댑터이다. 여기서 어댑터 역할을 해주는 덕분에 다양한 종류의 컨트롤러를 호출할 수 있다.
• 핸들러: 컨트롤러의 이름을 더 넓은 범위인 핸들러로 변경했다. 그 이유는 이제 어댑터가 있기 때문에 꼭 컨트롤러의 개념뿐만 아니라 어떠한 것이든 해당하는 종류의 어댑터만 있으면 다 처리할 수 있기 때문이다

MyHandlerAdapter 작성

여러 컨트롤러로 변환 가능한 Adapter 작성

여러 컨트롤러로 변환 가능한 Adapter 작성

• boolean supports(Object handler)
  
  • handler는 컨트롤러를 말한다.
  • 어댑터가 해당 컨트롤러를 처리할 수 있는지 판단하는 메서드다
• ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler)
  • 어댑터는 실제 컨트롤러를 호출하고, 그 결과로 ModelView를 반환해야 한다.
  • 실제 컨트롤러가 ModelView를 반환하지 못하면, 어댑터가 ModelView를 직접 생성해서라도 반환해야 한다.
  • 이전에는 프론트 컨트롤러가 실제 컨트롤러를 호출했지만 이제는 이 어댑터를 통해서 실제 컨트롤러가 호출된다.

ControllerV3를 지원하는 ControllerV3HandlerAdapter 작성

ControllerV3HandlerAdapter 

• supports 
  • ControllerV3을 처리할 수 있는 어댑터를 뜻한다.
• handle
  • handler를 컨트롤러 V3로 변환한 다음에 V3 형식에 맞도록 호출한다.
  • supports()를 통해 ControllerV3 만 지원하기 때문에 타입 변환은 걱정 없이 실행해도 된다.
  • ControllerV3는 ModelView를 반환하므로 그대로 ModelView를 반환하면 된다.

 

FrontControllerV5 작성

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

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response)
        throws ServletException, IOException {
        Object handler = getHandler(request);
        if(handler == null){
            response.setStatus(SC_NOT_FOUND);
            return;
        }
        MyHandlerAdapter adapter = getHandlerAdapter(handler);

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

        String viewName = mv.getViewName();//논리이름만 얻을 수 있다
        MyView view = viewResolver(viewName);

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

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

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

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

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

• 컨트롤러(Controller) -> 핸들러(Handler)
  • 이전에는 컨트롤러를 직접 매핑해서 사용했다. 그런데 이제는 어댑터를 사용하기 때문에, 컨트롤러뿐만 아니라 어댑터가 지원하기만 하면, 어떤 것이라도 URL에 매핑해서 사용할 수 있다. 그래서 이름을 컨트롤러에서 더 넓은 범위의 핸들러로 변경했다.
• 생성자
  • 생성자는 핸들러 매핑과 어댑터를 초기화(등록)한다.
  • initHandlerMappingMap() : 핸들러 매핑 초기화
  • initHandlerAdapters() :  어댑터 초기화
• 핸들러 매핑
  • Object handler = getHandler(request);

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

  • 핸들러 매핑 정보인 handlerMappingMap에서 URL에 매핑된 핸들러(컨트롤러) 객체를 찾아서 반환한다.
• 핸들러를 처리할 수 있는 어댑터 조회
  • MyHandlerAdapter adapter = getHandlerAdapter(handler);

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

  • handler를 처리할 수 있는 어댑터를 adapter.supports(handler)를 통해서 찾는다.
  • handler가 ControllerV3 인터페이스를 구현했다면, ControllerV3 HandlerAdapter 객체가 반환된다
• 어댑터 호출
  • ModelView mv = adapter.handle(request, response, handler);
  • 어댑터의 handle(request, response, handler) 메서드를 통해 실제 어댑터가 호출된다.
  • 어댑터는 handler(컨트롤러)를 호출하고 그 결과를 어댑터에 맞추어 반환한다.
  • ControllerV3 HandlerAdapter의 경우 어댑터의 모양과 컨트롤러의 모양이 유사해서 변환 로직이 단순하다

ControllerV4를 지원하는 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 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;
    }
}

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

  • String viewName = controller.process(paramMap, model);
    
    ModelView mv = new ModelView(viewName);
    mv.setModel(model);

FrontControllerV5 수정

handler 추가

Adapter 추가

• 클라이언트 코드의 수정은 거의 없이 새로운 기능을 추가했다.
• 후에 해당 코드를 DI 받도록 수정하면 완벽하게 객체지향 적이 설계가 된 것이다.