← Back

Spring MVC 구조가 만들어지는 다섯 단계

MVC 패턴에서 컨트롤러는 요청을 받아 로직을 호출하고 결과를 뷰로 넘긴다. 컨트롤러가 늘어나면 뷰로 넘기는 코드와 공통 처리가 컨트롤러마다 반복된다.

이 반복을 하나씩 걷어 내면 스프링 MVC의 핵심 구조와 닮은 형태가 된다.


프론트 컨트롤러란

출입구가 여러 개인 건물은 문마다 경비원이 필요하지만, 대표 출입구가 하나면 경비도 한 곳에만 두면 된다. 프론트 컨트롤러는 웹 애플리케이션의 대표 출입구다.

클라이언트프론트 컨트롤러공통 처리컨트롤러 A컨트롤러 B컨트롤러 C

예제의 범위: 코드는 구조를 설명하기 위한 일부이며, 단계마다 컨트롤러 인터페이스가 달라진다. import, 예외 처리와 일부 구현은 생략했다.

1단계 프론트 컨트롤러 도입

문제: 컨트롤러마다 요청을 받는 입구가 따로 있다.

모든 컨트롤러가 같은 인터페이스를 구현하게 하고, 프론트 컨트롤러는 URL과 컨트롤러를 짝지은 매핑 정보를 갖는다.

public interface Controller {
    void process(HttpServletRequest request, HttpServletResponse response);
}

// 프론트 컨트롤러가 들고 있는 매핑 정보 (URL → 컨트롤러)
controllerMap.put("/members/new-form", new MemberFormController());
controllerMap.put("/members/save", new MemberSaveController());

// 요청이 오면
Controller controller = controllerMap.get(request.getRequestURI());  // URL로 컨트롤러 찾기
controller.process(request, response);                               // 대신 호출

인터페이스가 같으므로 어떤 컨트롤러든 같은 방식으로 호출할 수 있다. 실제 구현에서는 매핑된 컨트롤러가 없는 경우의 404 처리도 필요하다.

2단계 뷰 분리

문제: 모든 컨트롤러에 forward 코드가 들어 있다.

forward를 전담하는 뷰 객체(MyView)를 만든다. 뷰 객체는 화면 파일 경로를 갖고 있다가 render()가 호출되면 그 경로로 forward한다.

public class MyView {
    private final String viewPath;

    public MyView(String viewPath) { this.viewPath = viewPath; }

    public void render(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        request.getRequestDispatcher(viewPath).forward(request, response);
    }
}

컨트롤러의 반환 타입을 MyView로 바꾼다. 컨트롤러는 뷰 객체를 반환하고, 프론트 컨트롤러가 그 뷰에 화면 그리기를 맡긴다.

// 컨트롤러: 뷰를 만들어 반환만 한다
return new MyView("/WEB-INF/views/new-form.jsp");

// 프론트 컨트롤러: 받은 뷰에게 화면 그리기를 맡긴다
MyView view = controller.process(request, response);
view.render(request, response);

3단계 모델 추가

문제: 컨트롤러가 서블릿에 의존하고, 뷰 경로를 매번 전부 적는다.

이 예제에서 컨트롤러에 필요한 것은 request 전체가 아니라 요청 파라미터다. 프론트 컨트롤러가 파라미터를 Map에 담아 넘기고, 컨트롤러는 ModelView를 반환한다.

ModelView에는 두 가지가 들어 있다.

public interface Controller {
    ModelView process(Map<String, String> paramMap);  // 서블릿 객체를 받지 않는다
}

// 컨트롤러
ModelView mv = new ModelView("save-result");  // 뷰 이름
mv.getModel().put("member", member);           // 화면에 넘길 데이터
return mv;

뷰 이름에는 전체 경로 대신 save-result 같은 논리 이름만 적는다. 이를 실제 파일 경로인 물리 이름으로 바꾸는 일은 뷰 리졸버가 한다.

// 뷰 리졸버: "save-result" → "/WEB-INF/views/save-result.jsp"
private MyView viewResolver(String viewName) {
    return new MyView("/WEB-INF/views/" + viewName + ".jsp");
}

뷰를 렌더링할 때는 모델에 담긴 데이터를 request 속성으로 옮긴 뒤 forward한다. 이 처리를 뷰 객체에 맡기면 컨트롤러는 서블릿 API를 몰라도 된다.

논리 이름을 쓰는 이유: 뷰 파일 위치가 바뀌면 뷰 리졸버의 경로 규칙을 고치고 컨트롤러는 그대로 둘 수 있다. 템플릿 엔진을 바꾸는 경우에도 컨트롤러의 논리 이름을 유지할 수 있지만, 뷰 구현과 템플릿 파일은 별도로 변경해야 한다.

4단계 단순한 컨트롤러

문제: 컨트롤러가 매번 ModelView를 직접 만든다.

프론트 컨트롤러가 빈 모델(Map)을 만들어 넘긴다. 컨트롤러는 모델에 데이터를 담고 뷰 이름만 문자열로 반환한다.

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

// 컨트롤러
model.put("member", member);  // 받은 모델에 담기만 한다
return "save-result";         // 뷰 이름만 반환

이제 컨트롤러는 로직 호출, 모델 채우기, 뷰 이름 반환만 한다.

5단계 어댑터로 여러 형태의 컨트롤러 지원

문제: 프론트 컨트롤러가 한 가지 형태의 컨트롤러만 호출할 수 있다.

ModelView를 반환하는 3단계 방식과 뷰 이름을 반환하는 4단계 방식은 인터페이스가 달라서 현재 구조로는 함께 쓸 수 없다.

전원 어댑터를 끼우면 모양이 다른 플러그도 같은 콘센트에 꽂을 수 있다. 프론트 컨트롤러도 컨트롤러를 직접 호출하지 않고 핸들러 어댑터를 거친다. 어댑터는 자신이 지원하는 컨트롤러를 호출하고 결과를 ModelView로 맞춰 돌려준다.

public interface HandlerAdapter {
    boolean supports(Object handler);  // 이 컨트롤러를 내가 다룰 수 있나?

    // 호출하고 결과를 ModelView로 맞춰 반환
    ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler);
}

프론트 컨트롤러는 등록된 어댑터 중 supports()가 true인 어댑터에 처리를 맡긴다.

컨트롤러가 아니라 핸들러: 대응하는 어댑터가 있으면 기존 컨트롤러 인터페이스와 다른 형태의 객체도 요청을 처리할 수 있다. 그래서 요청을 처리하는 대상을 핸들러라고 부르고, 매핑 정보도 URL과 핸들러를 짝짓는 핸들러 매핑이 된다.

전체 흐름은 다음과 같다.

요청1 핸들러 조회2 handle3 호출4 ModelView 반환5 뷰 이름 전달6 MyView 반환7 render8 HTML 응답클라이언트프론트 컨트롤러핸들러 매핑핸들러 어댑터핸들러컨트롤러뷰 리졸버MyView

새 형태의 컨트롤러가 생기면 어댑터를 추가하고 등록하면 된다. 프론트 컨트롤러의 호출 흐름은 고치지 않는다. OCP(개방-폐쇄 원칙)를 따르는 구조다.

다섯 단계 한눈에 보기

단계해결한 문제새로 생긴 것
1입구가 여러 개다프론트 컨트롤러, 매핑 정보
2forward 코드가 반복된다뷰 객체
3서블릿에 의존하고 뷰 경로가 반복된다모델을 담는 ModelView, 뷰 리졸버
4컨트롤러가 번거롭다뷰 이름만 돌려주는 컨트롤러
5한 가지 형태의 컨트롤러만 쓸 수 있다핸들러 어댑터

직접 만든 구조와 Spring MVC

직접 만든 부품은 역할 면에서 스프링 MVC의 다음 요소에 대응된다.

직접 만든 부품Spring MVC
프론트 컨트롤러DispatcherServlet
핸들러 매핑HandlerMapping
핸들러 어댑터HandlerAdapter
ModelViewModelAndView
뷰 리졸버ViewResolver
MyViewView

다섯 단계는 각각 문제 하나를 풀었다. 입구를 하나로 모으고, 뷰와 모델을 분리하고, 컨트롤러를 단순하게 만들고, 어댑터로 확장할 수 있게 했다. 그 결과가 스프링 MVC의 핵심 구조와 연결된다.

DispatcherServlet과 HandlerAdapter가 왜 있는지 알면, 스프링 MVC가 대신 해 주는 일이 분명하게 보인다.

← Back