[인프런 - 스프링 MVC 1편] 유연한 컨트롤러 - v5

 

 

/* 이 글은 김영한님의 강의를 보고 정리하려고 작성한 글입니다.

   개인적인 공부를 위해 올리는 글이므로 중간 중간 코드는 생략되었습니다. */

 

 

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 강의 | 김영한 - 인프런

 

 

 

 

1. V5 구조

 

- 만약 어떤 개발자는 V3 방식으로 개발하고 싶고, 어떤 개발자는 V4 방식으로 개발하고 싶다면 어떻게 해야될까?

 지금까지 우리가 개발한 프론트 컨트롤러는 한가지 방식의 컨트롤러 인터페이스만 사용할 수 있다.

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

 

 (이런식으로 Map에 Controller를 정해서 넣어놨기 때문)

 ControllerV3과 V4는 완전히 다른 인터페이스이다. 따라서 호환이 불가능하다.

 마치 V3은 110V이고, V4는 220V 전기 콘센트 같은 것이다.

 이럴때 사용하는 것이 바로 어댑터이다.

 어댑터 패턴을 사용해서 프론트 컨트롤러가 다양한 방식의 컨트롤러를 처리할 수 있도록 변경해보자.

 

 

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

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

 

 

 

2. 구현

 

MyHandlerAdapter

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를 반환해야 한다.

- 실제 컨트롤러가 ModleView를 반환하지 못하면, 어댑터가 ModelView를 직접 생성해서라도 반환해야 한다.

- 이전에는 프론트 컨트롤러가 실제 컨트롤러를 호출했지만, 이제는 이 어댑터를 통해 실제 컨트롤러가 호출된다.

 

 

 

ControllerV3HandlerAdapter, ControllerV4HandlerAdapter

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

    }
    
}

 

- supports( )를 통해 ControllerV3, ConrollerV4만 지원하기때문에

ControllerV3 controller = (ControllerV3) handler;
ControllerV4 controller = (ControllerV4) handler;

 

 이부분의 타입 변환은 걱정없이 실행해도 된다.

- ControllerV3은 ModelView를 반환하므로 그대로 반화하면 되고, V4는 원래 뷰의 이름을 반환하나 어댑터는 이것을 ModelView로 만들어서 형식을 맞추어 반환한다. 마치 110v 전기 콘센트를 220v 전기 콘센트로 변환하듯이

 

 

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

        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 {

        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 = 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 not found. handler = " + handler);
    }

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

    private static MyView viewResolver(String viewName) {

        return new MyView("/WEB-INF/views/" + viewName + ".jsp");

    }
}

 

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

- 매핑 정보

// 이전 버전
private Map<String, ControllerV4> controllerMap = new HashMap<>();
// V5버전
private final Map<String, Object> handlerMappingMap = new HashMap<>();

 

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

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

- getHandlerAdapter( )를 통해 handler를 처리할 수 있는 어댑터를 찾고, handler가 V3, V4 인터페이스를 구현했다면 ControllerV3HandlerAdapter , V4객체가 반환된다.
- 어댑터의 handle(request, response, handler) 메서드를 통해 실제 어댑터가 호출된다. 

 

 

 

3. 정리

 

지금까지 V1 ~ V5로 프레임워크를 발전시켜왔다.

- V1 : 프론트 컨트롤러 도입

(기존 구조를 최대한 유지하면서 프론트 컨트롤러를 도입)

- V2 : View 분류

 (단순 반복되는 뷰 로직 분리)

- V3 : Model 추가

 (서블릿 종속성 제거, 뷰 이름 중복 제거)

-V4 : 단순하고 실용적인 컨트롤러

 (V3과 거의 비슷하지만 구현 입장에서 ModelView를 직접 생성해서 반환하지 않도록 편리한 인터페이스 제공)

- V5 : 유연한 컨트롤러

 (어댑터를 도입하여 프레임워크를 유연하고 확장성 있게 설계)

 

여기서 더 발전시키면 좋겠지만 스프링 MVC의 핵심 구조를 파악하는데 필요한 부분은 모두 만들어 보았다.

여기까지 작성한 코드는 스프링 MVC 프레임워크의 핵심 코드의 축약버전이고 구조도 거의 같다.

다음 시간에는 스프링 MVC에 대해 공부해 보자!