4 분 소요

인프런 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술편을 학습하고 정리한 내용 입니다.

만약 어떤 개발자는 ControllerV3 처럼 만들고 싶고, 어떤 개발자는 ControllerV4처럼 만들고 싶다면 어떻게 해야할까?

어댑터 패턴

지금까지 우리가 개발한 프론트 컨트롤러는 한 가지 방식의 컨트롤러 인터페이스만 사용할 수 있다. ControllerV3, ControllerV4는 완전히 다른 인터페이스이다. 따라서 호환이 불가능 하다. 마치 V3는 110v이고, V4는 220V 전기 콘센트 같은 것이다. 이럴 때 사용하는 것이 바로 어댑터 이다.

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

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

MyHandlerAdapter

어댑터는 이렇게 구현해야 한다는 어댑터용 인터페이스

hello.servlet.web.frontcontroller.v5.MyHandlerAdapter

1
2
3
4
5

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

이제 핸들러 인터페이스를 구현한 V3용 어뎁터 클래스를 만들어 보자.

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

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);  
  
        return controller.process(paramMap);  
    }  
  
    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;  
    }  
}

하나씩 분석해 보자.

1
2
3
4

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

ControllerV3인지 아닌지 판단하는 메서드. ControllerV3는 인터페이스이기 때문에 상속 받은 클래스 들도 true 반환

1
2
3

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

handler를 먼저 ControllerV3로 캐스팅 한다. supports()에서 검증을 미리 했기 때문에 문제 없다. createParamMap()은 v3에서 만들었던 것 그대로 사용. request에 있는 걸 Map에 담는 메서드.

ControllerV3는 ModelView를 반환하므로 그대로 ModelView를 반환하면 된다.

프론트 컨트롤러

hello.servlet.web.frontcontroller.v5.FrontControllerServletV5

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

@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 initHandlerAdapters() {  
        handlerAdapters.add(new ControllerV3HandlerAdapter());  
    }  
  
    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());  
    }  
  
    @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();// 논리이름 new-form        
        MyView view = viewResolver(viewName);  
  
        view.render(mv.getModel(), request, response);  
    }  
    private MyView viewResolver(String viewName) {  
        return new MyView("/WEB-INF/views/" + viewName + ".jsp");  
    }  
  
    private MyHandlerAdapter getHandlerAdapter(Object handler) {  
        for (MyHandlerAdapter adapter : handlerAdapters) {  
            if (adapter.supports(handler)) {  
                return adapter;  
            }  
        }  
        throw new IllegalArgumentException("handler adaptor를 찾을 수 없습니다. handler = " + handler);  
    }  
  
    private Object getHandler(HttpServletRequest request) {  
        String requestURI = request.getRequestURI();  
        return handlerMappingMap.get(requestURI);  
    }  
}

자 좀 긴데 천천히 보자.

컨트롤러(Controller) → 핸들러(Handler)

이전에는 컨트롤러를 직접 매핑 해서 사용했다.

1

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

이젠

1

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

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

생성자

1
2
3
4

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

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

핸들러 매핑

1
2
3
4
5
6

Object handler = getHandler(request);  

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

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

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

1
2
3
4
5
6
7
8
9
10

MyHandlerAdapter adapter = getHandlerAdapter(handler);

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

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

어댑터 호출

1

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

어댑터의 handle(request, response, handler) 매서드에 의해 실제 어댑터가 호출된다. 어댑터는 handler(컨트롤러)를 호출하고 그 결과를 어댑터에 맞추어 반환한다.

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

이제 실행해 보자.

다 잘된다.

다음엔 ContollerV4도 연계해서 같이 보도록 하자.

댓글남기기

참고