[Spring MVC 1] - MVC 프레임워크 - 유연한 컨트롤러 1

어댑터 패턴 개요

지금까지 우리가 개발한 프론트 컨트롤러는 한가지 방식의 컨트롤러 인터페이스만 사용할 수 있다. ControllerV3, ControllerV4는 완전히 다른 인터페이스다. 따라서 호환이 불가하므로 이럴 때 어댑터를 사용한다. 

 

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

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

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

 

유연한 컨트롤러 1

v5 구조 아키텍쳐

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

 

MyHandlerAdapter

hello/servlet/web/frontcontroller/v5/MyHandlerAdapter.java

package hello.servlet.web.frontcontroller.v5;

import hello.servlet.web.ModelView;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

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

hello/servlet/web/frontcontroller/v5/adapter/ControllerV3HandlerAdapter.java

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

import hello.servlet.web.ModelView;
import hello.servlet.web.frontcontroller.v3.ControllerV3;
import hello.servlet.web.frontcontroller.v5.MyHandlerAdapter;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

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 {

        //support로 걸렀기 때문에 캐스팅해도 괜찮다
        ControllerV3 controller = (ControllerV3) handler;

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

        //adpater의 역할은 핸들러를 호출하고 그 결과를 반환 타입을 모델 타입으로 맞춰서 반환해주면 됨.

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

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

hello/servlet/web/frontcontroller/v5/FrontControllerServletV5.java

package hello.servlet.web.frontcontroller.v5;

import hello.servlet.web.ModelView;
import hello.servlet.web.frontcontroller.MyView;
import hello.servlet.web.frontcontroller.v3.ControllerV3;
import hello.servlet.web.frontcontroller.v3.controller.MemberFormControllerV3;
import hello.servlet.web.frontcontroller.v3.controller.MemberListControllerV3;
import hello.servlet.web.frontcontroller.v3.controller.MemberSaveControllerV3;
import hello.servlet.web.frontcontroller.v4.ControllerV4;
import hello.servlet.web.frontcontroller.v4.controller.MemberFormControllerV4;
import hello.servlet.web.frontcontroller.v4.controller.MemberListControllerV4;
import hello.servlet.web.frontcontroller.v4.controller.MemberSaveControllerV4;
import hello.servlet.web.frontcontroller.v5.adapter.ControllerV3HandlerAdapter;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@WebServlet(name="frontControllerServletV5", urlPatterns = "/front-controller/v5/*")
public class FrontControllerServletV5 extends HttpServlet {

    // as -is
    //private Map<String, ControllerV4> controllerMap = new HashMap<>();

    // to -be
    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 {

        // 1.handler 호출
        Object handler = getHandler(request);

        if(handler == null){
            response.setStatus(HttpServletResponse.SC_NOT_FOUND);
            return;
        }

        //2. handler adpater 호출
        MyHandlerAdapter adapter = getHandlerAdapter(handler);

        //3. handle 호출 - 컨트롤러 프로세스 호출
        ModelView mv = adapter.handle(request, response, handler);

        //4. viewname 가져와 뷰리졸버 호출
        String viewName = mv.getViewName();
        MyView view = viewResolver(viewName);

        //5. view render 호출
        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를 찾을 수 없습니다. hander= "+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");
    }

}

컨트롤러 (Controller) -> 핸들러 (Handler)

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

 

생성자

  public FrontControllerServletV5(){
        initHandlerMappingMap();	// 핸들러 매핑 초기화
        initHandlerAdapters();		// 어댑터 초기화
    }

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

 

매핑 정보

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

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

 

핸들러 매핑

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

핸들러 매핑 정보인 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를 찾을 수 없습니다. hander= "+handler);
}

handler를 처리할 수 있는 어댑터를 adapter.supports(handler)를 통해서 찾는다.

handler가 ControllerV3 인터페이스를 구현했다면, ControllerV3HandlerAdapter객체가 반환된다.

 

어댑터 호출

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

어댑터의 handler(request, response, handler) 메서드를 통해 실제 어댑터가 호출된다.

어댑터는 handlder(컨트롤러)를 호출하고 그 결과를 어댑터에 맞추어 반환한다.

ControllerV3HandlerAdapter의 경우 어댑터의 모양과 컨트롤러의 모양이 유사해서 변환 로직이 단순하다.

 

http://localhost:8080/front-controller/v5/v3/members/new-form 등록 실행 결과

http://localhost:8080/front-controller/v5/v3/members/members 목록 조회 실행 결과

 

---

복습 복습 복습!!!!!

 

 

 

 

@ 스프링 MVC 1편 - 백엔드 웹개발 by 김영한을 참조하고 있습니다.