[Spring MVC] MVC Framework V5

유연한 컨트롤러 - V5

여러 개발자가 각각 다른 방식(V3, V4)으로 개발하고 싶다면 더 유연하게 개발할 수 있도록 제공해줘야 한다.

ControllerV3

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

ControllerV4

public interface ControllerV4 {
     String process(Map<String, String> paramMap, Map<String, Object> model);
}

어댑터 패턴
ControllerV3, ControllerV4는 완전히 다른 인터페이스이기 때문에 호환이 불가능하다. (ex. 비유하자면 110V, 220V 콘센트)
이럴 때 사용하는 것이 어댑터이다.

V5 구조

• 핸들러: controller의 이름을 더 넓은 범위인 핸들러로 변경한 것이다. 그 이유는 어댑터가 있기 때문에 controller의 개념 뿐만 아니라 해당 종류의 어댑터만 있으면 다 처리할 수 있기 때문이다.
• 핸들러 어댑터: 중간에 어댑터 역할을 해주는 덕분에 다양한 종류의 controller를 호출할 수 있다.

MyHandlerAdapter

어댑터의 구현 방식을 보여주는 어댑터용 인터페이스.

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

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

ControllerV3HandlerAdapter

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

@Override
public ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) {

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

• boolean supports(): ControllerV3를 처리할 수 있는 어댑터인지 확인하는 메서드
• handle(): handler를 V3로 변환한 다음에 V3 형식에 맞도록 호출.

ControllerV4HandlerAdapter

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

@Override
public ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) {

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

// --- createParamMap() 생략

ControllerV4는 View의 이름을 반환한다. 하지만 어댑터는 String이 아닌 ModelView를 만들어서 반환해야 하기 때문에 ControllerV4는 String을 반환했지만, 어댑터가 ModelView로 형식을 갖춰서 반환해준다.

FrontControllerServletV5

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

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

    private void initHandlerAdapters() {
        handlerAdapters.add(new ControllerV3HandlerAdapter());
        handlerAdapters.add(new ControllerV4HandlerAdapter()); //V4 추가
    }

    // --- void service()

    // handler: MemberFormControllerV3, MemberFormControllerV4
    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);

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


    // --- Method
    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=" + handler);
    }

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

Controller -> Handler
Controller 뿐만 아니라 어댑터가 지원만 하면, 어떤 것이라도 URL에 매핑해서 사용할 수 있다.

매핑 정보
private final Map<String, Object> handlerMappingMap = new HashMap<>();
매핑 정보의 값이 ControllerV3, ControllerV4같은 아무 인터페이스 값이나 받을 수 있도록 Object로 설정하였다.

<출처 : 인프런 - 스프링 MVC 1편 : 백엔드 웹 개발 핵심 기술(김영한)>