스프링 MVC 1 - 유연한 컨트롤러(핸들러) 1 v5.1

유연한 컨트롤러1 - v5

어떤 개발자는 ControllerV3, 어떤 개발자는 ControllerV4로 개발하고 싶다면 어떻게 해야 할까?

어댑터 패턴

완전히 다른 인터페이스를 구현해서 같이 개발할 때 사용할 수 있는 패턴이다.
어탭터 패턴을 사용하면 프론트 컨트롤러가 다양한 방식의 컨트롤러를 처리할 수 있어진다.

V5 구조

1. 클라이언트 요청
2. 프론트 컨트롤러가 핸들러 매핑 정보에서 핸들러 조회
3. 프론트 컨트롤러가 핸들러 어댑터 목록에서 핸들러를 처리할 수 있는 핸들러 어댑터 조회
4. 조회된 핸들러 어댑터에 파라미터를 넘겨줌
5. 핸들러 어탭터는 핸들러(컨트롤러)를 대신 호출
6. 핸들러(컨트롤러)는 결과를 프론트 컨트롤러에 반환
7. 프론트 컨트롤러는 반환된 결과로 뷰 리졸버 호출
8. 뷰 리졸버는 결과를 반환
9. 프론트 컨트롤러는 반환 받은 값으로 MyView 호출
10. HTML 응답

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

MyHandlerAdapter

package hello.servlet.web.frontcontroller.v5;

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

• boolean supports(Object handler)
  • handler는 컨트롤러를 말한다.
  • 어댑터가 해당 컨트롤러를 처리할 수 있는지 판단하는 메서드
    • 프론트 컨트롤러가 핸들러 매핑 정보에서 핸들러를 찾아서 핸들러 어탭터 목록을 통해 처리할 수 있는 핸들러 어탭터를 찾아주는 메서드
• ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler)
  • 실제 컨트롤러를 호출하고, 그 결과로 ModelView를 반환해야 한다.
  • 실제 컨트롤러가 ModelView를 반환하지 못하면 어댑터가 대신 ModelView를 직접 작성해서라도 반환해야 함.
  • 전에는 프론트 컨트롤러가 실제 컨트롤러를 호출했지만, 이제는 이 어댑터를 통해 실제 컨트롤러가 호출됨.

ControllerV3HandlerAdapter

// package hello.servlet.web.frontcontroller.v5.adapter;

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

ControllerV3HandlerAdapter 분석

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

ControllerV3를 처리할 수 있는 어댑터인지, 없는 어댑터인지 판단해준다.

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

handler를 컨트롤러 V3로 변환한 다음에 V3 형식에 맞도록 호출한다.
supports() 메서드를 통해 ControllerV3를 사용할 때만 호출할 수 있도록 하니 타입 변환 걱정없이 실행해도 된다.
ControllerV3는 ModelView를 반환하므로 그대로 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());
        handlerMappingMap.put("/front-controller/v5/v3/members", new MemberListControllerV3());
    }

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

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

        MyView view = viewResolver(mv.getViewName());
        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=" + handler);
    }

    private Object getHandler(HttpServletRequest request) {
        String requestURI = request.getRequestURI(); // 클라이언트 URL에서 controllerMap에 있는 URL중 하나를 찾아서 클래스를 생성해준다.
        return handlerMappingMap.get(requestURI);
    }

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

Controller to Handler

전에는 컨트롤러를 직접 매핑해서 사용했지만 이제는 어댑터를 사용하기 때문에 어댑터가 지원하기만 하면, 어떤 것이라도 URL에 매핑해서 사용할 수 있다.
그래서 컨트롤러에서 더 넓은 범위의 이름인 핸들러로 변경했다.

생성자

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

생성자는 핸들러 매핑과 어탭터를 초기화(등록)한다.

매핑 정보

private final Map<String, Object> handlerMappingMap = new HashMap<>();
매핑 정보의 값이 ControllerV3, ControllerV4 같은 인터페이스에서 아무 값이나 받을 수 있는 Object로 변경

핸들러 매핑

Object handler = getHandler(request);

private Object getHandler(HttpServletRequest request) {
        String requestURI = request.getRequestURI(); // 클라이언트 URL에서 controllerMap에 있는 URL중 하나를 찾아서 클래스를 생성해준다.
        return handlerMappingMap.get(requestURI);
    }

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

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

MyHandlerAdapter adapter = getHandlerAdapter(handler);

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

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

어댑터 호출

ModelView mv = adapter.handle(request, response, handler);
어댑터의 handle(request, response, handler) 메서드를 통해 실제 어댑터가 호출된다.
어댑터는 handler(컨트롤러)를 호출하고 그 결과를 어댑터에 맞춰 반환
ControllerV3HandlerAdapter는 어탭터 모양과 컨트롤러의 모양이 유사하기 때문에 변환 로직이 단순하다.

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