4-5. 어댑터 패턴

shin·2025년 6월 29일

Spring MVC

목록 보기

18/25

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

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

ControllerV3 방식과 ControllerV4 방식으로 개발하는 것을 혼용하고 싶은 경우를 위한 V5 개발

어댑터 패턴

지금까지 우리가 개발한 프론트 컨트롤러는 한가지 방식의 한가지 방식의 컨트롤러 인터페이스만 사용할 수 있음
ControllerV3, ControllerV4는 완전히 다른 인터페이스이기 때문에 호환이 불가능함
이럴 때 사용하는 것이 바로 어댑터
- 어댑터 패턴을 사용해서 프론트 컨트롤러가 다양한 방식의 컨트롤러를 처리할 수 있도록 변경

V5 구조

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

MyHandleAdapter

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

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)

어댑터는 실제 컨트롤러를 호출하고, 그 결과로 ModelView를 반환해야 함
실제 컨트롤러가 ModelView를 반환하지 못하면, 어댑터가 ModelView를 직접 생성해서라도 반환해야 함
이전에는 프론트 컨트롤러가 실제 컨트롤러를 호출했지만 이제는 이 어댑터를 통해서 실제 컨트롤러가 호출됨

ControllerV3HandlerAdapter

ControllerV3를 지원하는 어댑터 구현

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

import hello.servlet.web.frontcontroller.ModelView;
import hello.servlet.web.frontcontroller.v3.ControllerV3;
import hello.servlet.web.frontcontroller.v5.MyHandlerAdapter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
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) {

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

코드 분석

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

package hello.servlet.web.frontcontroller.v5;

import hello.servlet.web.frontcontroller.ModelView;
import hello.servlet.web.frontcontroller.MyView;
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.v5.adapter.ControllerV3HandlerAdapter;
import hello.servlet.web.frontcontroller.v5.adapter.ControllerV4HandlerAdapter;
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 {

	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 Object getHandler(HttpServletRequest request) {
    
		String requestURI = request.getRequestURI();
		return handlerMappingMap.get(requestURI);
	}
    
	private MyHandlerAdapter getHandlerAdapter(Object handler) {
    
		for (MyHandlerAdapter adapter : handlerAdapters) {
        
			if (adapter.supports(handler)) {
				return adapter;
			}
		}
        
		throw new IllegalArgumentException("handler adapter를 찾을 수 없습니다. handler=" + handler);
	}

	private 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로 변경됨

핸들러 매핑

`Object handler = getHandler(request)`

private Object getHandler(HttpServletRequest request) {

	String requestURI = request.getRequestURI();
	return handlerMappingMap.get(requestURI);
}

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

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

MyHandlerAdapter adapter = getHandlerAdapter(handler)

for (MyHandlerAdapter adapter : handlerAdapters) {

	if (adapter.supports(handler)) {
		return adapter;
	}
}

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

어댑터 호출

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

어댑터의 handle(request, response, handler) 메서드를 통해 실제 어댑터가 호출됨
어댑터는 handler(컨트롤러)를 호출하고 그 결과를 어댑터에 맞추어 반환함
ControllerV3HandlerAdapter의 경우 어댑터의 모양과 컨트롤러의 모양이 유사해서 변환 로직이 단순함

실행

V4 기능도 추가

FrontControllerServletV5에 ControllerV4 기능 추가

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

	//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 추가
}

핸들러 매핑(handlerMappingMap)에 ControllerV4를 사용하는 컨트롤러를 추가하고, 해당 컨트롤러를 처리할 수 있는 어댑터인 ControllerV4HandlerAdapter도 추가

ControllerV4HandlerAdapter

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

import hello.servlet.web.frontcontroller.ModelView;
import hello.servlet.web.frontcontroller.v4.ControllerV4;
import hello.servlet.web.frontcontroller.v5.MyHandlerAdapter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.HashMap;
import java.util.Map;

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) {

		ControllerV4 controller = (ControllerV4) handler;
        
		Map<String, String> paramMap = createParamMap(request);
		Map<String, Object> model = new HashMap<>();
        
		String viewName = controller.process(paramMap, model);
        
		ModelView mv = new ModelView(viewName);
		mv.setModel(model);
        
		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;
	}
}

supports

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

handler가 ControllerV4인 경우에만 처리하는 어댑터

실행 로직

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을 반환받음

어댑터 반환

ModelView mv = new ModelView(viewName);
mv.setModel(model);

return mv;

어댑터에서 이 부분이 단순하지만 중요한 부분임
어댑터가 호출하는 ControllerV4는 뷰의 이름을 반환함
- 그런데 어댑터는 뷰의 이름이 아니라 ModelView를 만들어서 반환해야 함
- 여기서 어댑터가 꼭 필요한 이유가 나옴
ControllerV4는 뷰의 이름을 반환했지만, 어댑터는 이것을 ModelView로 만들어서 형식을 맞추어 반환함

어댑터와 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 ~ v5로 점진적으로 프레임워크를 발전시킴

v1: 프론트 컨트롤러를 도입

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

v2: View 분류

단순 반복 되는 뷰 로직 분리

v3: Model 추가

서블릿 종속성 제거

뷰 이름 중복 제거

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

v3와 거의 비슷

구현 입장에서 ModelView를 직접 생성해서 반환하지 않도록 편리한 인터페이스 제공

v5: 유연한 컨트롤러

어댑터 도입

어댑터를 추가해서 프레임워크를 유연하고 확장성 있게 설계

여기에 애노테이션을 사용해서 컨트롤러를 더 편리하게 발전시킬 수도 있음
만약 애노테이션을 사용해서 컨트롤러를 편리하게 사용할 수 있으려면, 애노테이션을 지원하는 어댑터를 만들면 됨
다형성과 어댑터 덕분에 기존 구조를 유지하면서, 프레임워크의 기능을 확장할 수 있었음

shin

Backend development

이전 포스트

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

다음 포스트

4-5. 어댑터 패턴

Spring MVC

어댑터 패턴

V5 구조

MyHandleAdapter

ControllerV3HandlerAdapter

코드 분석

FrontControllerServletV5

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

생성자

매핑 정보

핸들러 매핑

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

어댑터 호출

실행

V4 기능도 추가

ControllerV4HandlerAdapter

supports

실행 로직

어댑터 반환

어댑터와 ControllerV4

실행

총정리

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

5-1. 스프링 MVC 전체 구조

0개의 댓글