본문 바로가기
Spring MVC

[MVC] MVC 프레임워크 만들기(3)

by 개발 Blog 2025. 2. 12.

공부 내용을 정리하고 앞으로의 학습에 이해를 돕기 위해 작성합니다.

 

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

이전 V3 컨트롤러는 서블릿 종속성을 제거하고, 뷰 경로의 중복을 제거하는 등 잘 설계된 구조를 가지고 있다. 하지만 컨트롤러 인터페이스를 구현하는 개발자의 입장에서 보면, 항상 ModelView 객체를 생성하고 반환해야 하는 부분이 다소 번거롭다.

좋은 프레임워크는 아키텍처도 중요하지만, 개발자가 단순하고 편리하게 사용할 수 있도록 실용성이 있어야 한다.
이번에는 V3를 개선하여 개발자들이 더 편리하게 개발할 수 있도록 V4 버전을 설계해보자.

  • 기본적인 구조는 V3와 같지만, 컨트롤러가 ModelView를 반환하지 않고 ViewName만 반환한다.
    즉, 컨트롤러의 역할을 더욱 단순화하였다.

V4 컨트롤러 인터페이스

이번 버전은 인터페이스에 ModelView가 없다. model 객체는 파라미터로 전달되기 때문에 그냥 사용하면 되고, 결과

로 뷰의 이름만 반환해주면 된다.

package hello.servlet.web.frontcontroller.v4;

import java.util.Map;

public interface ControllerV4 {
    /**
     * @param paramMap 요청 파라미터
     * @param model    모델 데이터
     * @return viewName (뷰 이름 반환)
     */
    String process(Map<String, String> paramMap, Map<String, Object> model);
}

 

V4 컨트롤러 구현

1. MemberFormControllerV4 (회원 등록 폼 컨트롤러)

회원 등록 폼을 보여주는 역할을 한다. 뷰의 논리 이름 "new-form"만 반환한다.

package hello.servlet.web.frontcontroller.v4.controller;

import hello.servlet.web.frontcontroller.v4.ControllerV4;

import java.util.Map;

public class MemberFormControllerV4 implements ControllerV4 {
    @Override
    public String process(Map<String, String> paramMap, Map<String, Object> model) {
        return "new-form"; // 논리적인 뷰 이름만 반환
    }
}
 

2. MemberSaveControllerV4 (회원 저장 컨트롤러)

폼에서 전달된 데이터를 받아 회원을 저장한 후, 저장된 회원 정보를 모델에 추가한다.

package hello.servlet.web.frontcontroller.v4.controller;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import hello.servlet.web.frontcontroller.v4.ControllerV4;

import java.util.Map;

public class MemberSaveControllerV4 implements ControllerV4 {
    private MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    public String process(Map<String, String> paramMap, Map<String, Object> model) {
        String username = paramMap.get("username");
        int age = Integer.parseInt(paramMap.get("age"));

        Member member = new Member(username, age);
        memberRepository.save(member);

        model.put("member", member); // 모델에 회원 정보 저장
        return "save-result"; // 저장 결과 화면으로 이동
    }
}

 

3. MemberListControllerV4 (회원 목록 조회 컨트롤러)

저장된 모든 회원 목록을 조회하여 모델에 추가한다.

package hello.servlet.web.frontcontroller.v4.controller;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import hello.servlet.web.frontcontroller.v4.ControllerV4;

import java.util.List;
import java.util.Map;

public class MemberListControllerV4 implements ControllerV4 {
    private MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    public String process(Map<String, String> paramMap, Map<String, Object> model) {
        List<Member> members = memberRepository.findAll();
        model.put("members", members); // 모델에 회원 리스트 추가
        return "members"; // 회원 목록 화면으로 이동
    }
}

 

Front Controller 구현

V4의 프론트 컨트롤러는 이전 버전과 거의 동일하지만, 컨트롤러가 ViewName을 반환하는 방식으로 변경되었다.
또한, 모델 객체를 프론트 컨트롤러에서 생성하고 컨트롤러에 전달한다.

package hello.servlet.web.frontcontroller.v4;

import hello.servlet.web.frontcontroller.MyView;
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 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.HashMap;
import java.util.Map;

@WebServlet(name = "frontControllerServletV4", urlPatterns = "/front-controller/v4/*")
public class FrontControllerServletV4 extends HttpServlet {

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

    public FrontControllerServletV4() {
        controllerMap.put("/front-controller/v4/members/new-form", new MemberFormControllerV4());
        controllerMap.put("/front-controller/v4/members/save", new MemberSaveControllerV4());
        controllerMap.put("/front-controller/v4/members", new MemberListControllerV4());
    }

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        String requestURI = request.getRequestURI();
        ControllerV4 controller = controllerMap.get(requestURI);

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

        Map<String, String> paramMap = createParamMap(request);
        Map<String, Object> model = new HashMap<>(); // 모델 객체 추가

        String viewName = controller.process(paramMap, model);
        MyView view = viewResolver(viewName);

        view.render(model, request, response);
    }

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

    private MyView viewResolver(String viewName) {
        return new MyView("/WEB-INF/views/" + viewName + ".jsp");
    }
}

 

실행 결과

회원 등록 화면

 

회원 목록 화면

정리

  • V4에서는 ModelView를 직접 생성하지 않는다.
  • 컨트롤러는 뷰 이름(ViewName)만 반환하며, 모델은 프론트 컨트롤러에서 관리한다.
  • 컨트롤러 구현이 훨씬 단순해졌으며, 개발자의 사용성이 개선되었다.
  • 프레임워크가 복잡한 작업을 처리할수록 개발자는 더 편리해진다.

유연한 컨트롤러1 - v5

만약 어떤 개발자는 ControllerV3 방식으로 개발하고 싶고, 어떤 개발자는 ControllerV4 방식으로 개발하고 싶다면 어떻게 해야 할까?

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


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

 

어댑터 패턴

지금까지 개발한 프론트 컨트롤러는 한 가지 방식의 컨트롤러 인터페이스만 사용할 수 있었다. 하지만 ControllerV3과 ControllerV4는 완전히 다른 인터페이스이므로 서로 호환되지 않는다. 마치 110V와 220V 전기 콘센트처럼 다르다. 이럴 때 사용하는 것이 바로 어댑터 패턴이다.

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

  • 핸들러 어댑터: 중간에서 어댑터 역할을 하며 다양한 종류의 컨트롤러를 호출할 수 있도록 한다.
  • 핸들러: 컨트롤러라는 이름 대신 더 넓은 개념인 핸들러를 사용한다. 어댑터가 있으면 반드시 컨트롤러가 아니라도 처리할 수 있기 때문이다.

MyHandlerAdapter 인터페이스 구현

어댑터는 특정 컨트롤러를 지원하는지 확인하는 메서드와 컨트롤러를 실행하는 메서드를 제공한다.

package hello.servlet.web.frontcontroller.v5;

import hello.servlet.web.frontcontroller.ModelView;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.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;
}

supports 메서드

어댑터가 특정 컨트롤러를 처리할 수 있는지 판단하는 메서드이다. 컨트롤러의 타입을 확인하고 해당 타입에 맞는 어댑터인지 검증한다.

 

handle 메서드

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

 

ControllerV3HandlerAdapter 구현

ControllerV3를 지원하는 어댑터를 구현하여 해당 방식의 컨트롤러를 처리할 수 있도록 한다. 이 어댑터는 ControllerV3의 인터페이스를 확인하고, 적절한 방식으로 컨트롤러를 실행한다.

package hello.servlet.web.servletmvc;

import hello.servlet.web.frontcontroller.ModelView;
import hello.servlet.web.frontcontroller.v3.ControllerV3;
import hello.servlet.web.frontcontroller.v5.MyHandlerAdapter;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

public class ControllerV3HandlerAdapter implements MyHandlerAdapter {
	//`ControllerV3` 을 처리할 수 있는 어댑터를 뜻한다.
    @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;
    }

}

supports 메서드 역할

이 메서드는 주어진 컨트롤러가 ControllerV3 타입인지 확인하고, 해당 타입이면 true를 반환하여 지원 가능함을 알린다.

 

handle 메서드 역할

핸들러를 ControllerV3 타입으로 변환한 후, 요청 파라미터를 추출하여 ControllerV3의 process 메서드를 호출한다. 이후 반환된 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.servletmvc.ControllerV3HandlerAdapter;
import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.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");
    }
}

 

컨트롤러 → 핸들러

기존에는 컨트롤러를 직접 매핑했지만, 어댑터를 도입하면서 더 넓은 개념인 핸들러를 사용하게 되었다. 이제 컨트롤러뿐만 아니라 어댑터가 지원하기만 하면 어떤 객체라도 처리할 수 있다.

 

생성자 역할

프론트 컨트롤러가 생성될 때, 핸들러 매핑 정보와 어댑터 목록을 초기화한다. 이를 통해 다양한 컨트롤러 유형을 지원할 수 있도록 설정한다.

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

 

핸들러 매핑

요청 URL에 맞는 핸들러를 찾아 반환하는 역할을 한다. 요청이 들어오면 등록된 핸들러 매핑에서 해당하는 컨트롤러를 찾아 제공한다.

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

 

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

주어진 핸들러를 처리할 수 있는 어댑터를 검색하고, 적합한 어댑터를 반환한다. handler가 ControllerV3 인터페이스를 구현했다면, ControllerV3HandlerAdapter가 반환된다.

MyHandlerAdapter adapter = getHandlerAdapter(handler)
for (MyHandlerAdapter adapter : handlerAdapters) {
	if (adapter.supports(handler)) {
		return adapter;
	}
}

 

어댑터 호출

어댑터의 handle 메서드를 통해 실제 어댑터가 호출된다. 어댑터는 handler(컨트롤러)를 실행하고 그 결과를 ModelView 형태로 변환하여 반환한다. ControllerV3HandlerAdapter의 경우 컨트롤러와 어댑터의 구조가 유사하여 변환 로직이 단순하다.

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

 

실행 흐름

  1. 사용자가 특정 URL로 요청을 보낸다.
  2. 프론트 컨트롤러가 요청을 받아 해당하는 핸들러(컨트롤러)를 찾는다.
  3. 핸들러를 지원하는 어댑터를 조회하여 실행한다.
  4. 어댑터가 컨트롤러를 실행하고 ModelView를 반환한다.
  5. 반환된 ModelView를 기반으로 뷰를 렌더링하여 사용자에게 응답을 제공한다.

실행 예시

등록 폼

 

목록 조회

 

정리

현재는 ControllerV3를 사용할 수 있는 어댑터만 등록되어 있어 큰 변화가 없어 보일 수 있다. 다음 단계로 ControllerV4를 지원하는 어댑터를 추가하여 다양한 컨트롤러를 처리할 수 있도록 확장해보자.

'Spring MVC' 카테고리의 다른 글

[MVC] 스프링 MVC - 구조 이해(1)  (0) 2025.02.19
[MVC] MVC 프레임워크 만들기(4)  (0) 2025.02.17
[MVC] MVC 프레임워크 만들기(2)  (1) 2024.12.08
[MVC] MVC 프레임워크 만들기(1)  (0) 2024.11.13
[MVC] 서블릿, JSP, MVC 패턴(4)  (0) 2024.10.29

관련글

티스토리툴바