단순하고 실용적인 컨트롤러 - v4
지난 시간에 만들었던 V3 컨트롤러는 서블릿 종속성과 뷰 이름 중복도 제거한 잘 설계된 컨트롤러이다.
하지만 사용할 때 매번 ModelView 객체를 생성하고 반환해야 하는 부분이 조금은 번거롭다.😭
이번에는 v3를 조금 변경해서 실제 구현하는 개발자들이 매우 편리하게 개발할 수 있는 v4 버전을 개발해보자!
V4 구조
- 기본적인 구조는 V3와 같다. 대신 컨트롤러가
ModelView를 반환하지 않고,ViewName만 반환한다!
ControllerV4
package hello.servlet.web.frontcontroller.v4;
import java.util.Map;
public interface ControllerV4 {
String process(Map<String, String> paramMap, Map<String, Object> model);
}model 객체는 파라미터로 전달되므로,
따로 ModelView를 생성하지 않고 viewName만 반환해주면 된다.
회원 등록/저장/조회 컨트롤러,
ControllerV4를 구현하는 3개의 컨트롤러 모두 이제 뷰의 논리 이름(new-form등)만 반환하면 된다. → 매번 객체 생성하는 비용을 줄일 수 있다.
FrontControllerServletV4
(전체 코드는 위의 링크 참고)
✔ 모델 객체 전달
Map<String, Object> model = new HashMap<>();Model객체를 프론트 컨트롤러에서 생성해서 넘겨준다.- 각 구현체 컨트롤러에서는 여기서 전달한
Model에 데이터를 담아서 전달할 수 있다. →ModelView를 생성하지 않아도 된다!
✔ 뷰의 논리 이름을 직접 반환
String viewName = controller.process(paramMap, model);
MyView view = viewResolver(viewName);- 컨트롤러가 직접 뷰의 이름을 반환하므로,
이 뷰 리졸버를 사용해서 실제 물리 뷰를 찾을 수 있다.
유연한 컨트롤러1 - v5
지금까지 V1부터 V4까지 다양한 방법으로 컨트롤러를 개발해왔다.
그런데 만약 한 팀 내에서 어떤 사람👩🏻은 ControllerV3 방식으로, 어떤 사람👨🏻은 ControllerV4 방식으로 개발하고 싶어 한다면 어떻게 해야 할까?
🙋🏻♀️: 그냥 다 같이 써요!
👩🏻🏫: 지금은 안돼!
ControllerV3
public interface ControllerV3 {
ModelView process(Map<String, String> paramMap);
}ControllerV4
public interface ControllerV4 {
String process(Map<String, String> paramMap, Map<String, Object> model);
}V3와 V4는 process 메서드만 봐도 반환 타입과 인자 값의 개수와 타입이 다른 것을 확인할 수 있다. 마치 110V와 220V 전기 콘센트처럼, V3와 V4는 호환이 불가능하다.
이런 상황에서 필요한 것이 바로 어댑터이다!
어댑터 패턴을 이용하면 다른 타입의 컨트롤러를 혼용해서 쓸 수 있다. 지금부터 어댑터 패턴을 이용하여 프론트 컨트롤러가 다양한 방식의 컨트롤러를 처리할 수 있도록 바꿔보자!
V5 구조
-
핸들러 어댑터: 프론트 컨트롤러와 핸들러(컨트롤러) 중간에 핸들러 어댑터가 추가되었다.
→ 이 어댑터를 통해 다양한 종류의 컨트롤러를 호출할 수 있다. -
핸들러: 컨트롤러의 이름을 더 넓은 범위인 핸들러로 변경했다. 이제 어댑터가 있기 때문에 꼭 컨트롤러의 개념 뿐만 아니라 어떠한 것이든 해당하는 종류의 어댑터만 있으면 다 처리할 수 있기 때문이다.
MyHandlerAdapter - 어댑터용 인터페이스
package hello.servlet.web.frontcontroller.v5;
import hello.servlet.web.frontcontroller.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) throws ServletException, IOException;- 어댑터는 실제 컨트롤러를 호출한 뒤
ModelView를 반환해야 한다. - 실제 컨트롤러에서
ModelView를 반환하지 못하면, 어댑터가ModelView를 직접 생성해서라도 반환해야 한다. - 이전에는 프론트 컨트롤러가 실제 컨트롤러를 호출했지만, 이제는 이 어댑터를 통해 실제 컨트롤러가 호출된다.
ControllerV3HandlerAdapter
ControllerV3를 지원하는 어댑터를 구현해보자!
코드 분석
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를ControllerV3로 변환한 뒤,V3형식에 맞도록 호출한다.ControllerV3는ModelView를 반환하므로 그대로ModelView를 반환하면 된다.
FrontControllerServletV5
(전체 코드는 위의 링크 참고)
📌 컨트롤러
(Controller)→ 핸들러(Handler)
- 이전에는 컨트롤러를 직접 매핑해서 사용했다.
- 이제는 어댑터를 사용하기 때문에 컨트롤러 뿐만 아니라 어댑터가 지원하기만 하면, 어떤 것이라도 URL에 매핑해서 사용할 수 있다.
- 그래서 이름을 컨트롤러 → 핸들러로 변경했다!
1. 생성자
public FrontControllerServletV5() {
initHandlerMappingMap(); //핸들러 매핑 초기화
initHandlerAdapters(); //어댑터 초기화
}생성자는 핸들러 매핑과 어댑터를 초기화(등록)한다.
2. 매핑 정보
private final Map<String, Object> handlerMappingMap = new HashMap<>();매핑 정보의 값이 ControllerV3, ControllerV4 같은 인터페이스에서 아무 값이나 받을 수 있는 Object로 변경되었다.
3. 핸들러 매핑
private Object getHandler(HttpServletRequest request) {
String requestURI = request.getRequestURI();
return handlerMappingMap.get(requestURI);
}핸들러 매핑 정보인 handlerMappingMap에서 URL에 매핑된 핸들러(컨트롤러) 객체를 찾아서 반환한다.
4. 핸들러를 처리할 수 있는 어댑터 조회
MyHandlerAdapter adapter = getHandlerAdapter(handler)핸들러를 처리할 수 있는 어댑터를 adapter.supports(handler)를 통해 찾는다.
5. 어댑터 호출
ModelView mv = adapter.handle(request, response, handler);- 어댑터의
handle(request, response, handler)메서드를 통해 실제 어댑터가 호출된다. - 어댑터는
handler(컨트롤러)를 호출하고 그 결과를 어댑터에 맞추어 반환한다. ControllerV3HandlerAdapter의 경우 어댑터의 모양과 컨트롤러의 모양이 유사해서 변환 로직이 단순하다.
유연한 컨트롤러2 - v5
이번에는
ControllerV4를 사용할 수 있도록 추가해보자!
FrontControllerServletV5
private void initHandlerMappingMap() {
...
//V4 추가
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()); //V4 추가
}ControllerV4용 경로(key)와 컨트롤러를handlerMappingMap에 추가해준다.ControllerV4도 호환이 되도록 해주는 어댑터를handlerAdapter콜렉션에 추가해준다.
ControllerV4HandlerAdapter
코드 분석
public boolean supports(Object handler) {
return (handler instanceof ControllerV4);
}handler가 ControllerV4인 경우에만 처리하는 어댑터이다.
1. 실행 로직
ControllerV4 controller = (ControllerV4) handler;
Map<String, String> paramMap = createParamMap(request);
Map<String, Object> model = new HashMap<>();
String viewName = controller.process(paramMap, model);handler를 ControllerV4로 캐스팅하고, paramMap, model을 만들어서 해당 컨트롤러를 호출한 뒤, viewName을 반환 받는다.
2. 어댑터 변환 - ⭐중요
ModelView mv = new ModelView(viewName);
mv.setModel(model);
return mv;어댑터가 호출하고 ControllerV4는 뷰의 이름을 반환한다. ControllerV4는 뷰의 이름을 반환했지만, 어댑터는 이것을 ModelView로 만들어서 형식을 맞추어 반환한다.
🤸🏻♀️ 마치 110v 전기 콘센트를 220v 전기 콘센트로 변경하듯이!
3. 어댑터와 ControllerV4
public interface ControllerV4 {
String process(Map<String, String> paramMap, Map<String, Object> model);
}
public interface MyHandlerAdapter {
ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws ServletException, IOException;
}📌 정리
v1 - 프론트 컨트롤러 도입
- 기존 구조를 최대한 유지하면서 프론트 컨트롤러를 도입
v2 - View 분류
- 단순 반복되는 뷰 로직 분리
v3 - Model 추가
- 서블릿 종속성 제거
- 뷰 이름 중복 제거
v4 - 단순하고 실용적인 컨트롤러
- v3와 거의 비슷
- 구현 입장에서
ModelView를 직접 생성해서 반환하지 않도록 편리한 인터페이스 제공
v5 - 유연한 컨트롤러
- 어댑터 도입
- 어댑터를 추가해서 프레임워크를 유연하고 확장성 있게 설계
