[Spring Boot][4] 4-2. MVC 프레임워크 만들기

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

앞서 만든 v3 컨트롤러는 서블릿 종속성을 제거하고 뷰 경로의 중복을 제거하는 등, 잘 설계된 컨트롤러이다.
그런데, 실제 컨트톨러 인터페이스를 구현하는 개발자 입장에서 보면, 항상 ModelView 객체를 생성하고 반환해야 하는 부분이 조금은 번거롭다😣

💡 좋은 프레임워크는 실용성이 있어야 한다!!!!

이번 시간에는 v3를 조금 변경해서 우리가 매우 편리하게 개발할 수 있는 v4 버전을 개발해보자❗️

---

⬆️ 기본적인 구조는 V3와 같지만 다른점은, 컨트롤러가 ModelView를 반환 하는 게 아니고 ViewName 만 반환한다!!

✔️ ControllerV4

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

⬆️ 이번 버전은 인터페이스에 ModelView가 없다! model 객체는 파라미터로 전달되기 때문에 그냥 사용하면 되고, 결과로 뷰의 이름만 반환해주면 된다!

✔️ MemberFormControllerV4 - 회원 등록

@Override
    public String process(Map<String, String> paramMap, Map<String, Object>
            model) {
        return "new-form";
    }

⬆️ 아~주 단순하게 new-form 이라는 뷰의 논리 이름만 반환하면 된다!

✔️ MemberSaveControllerV4 - 회원 저장

@Override
    public String process(Map<String, String> paramMap, Map<String, Object> model) {

        .
        .
        .

        model.put("member", member);
        return "save-result";
    }

⬆️ model.put("member", member) : 모델이 파라미터로 전달되기 때문에, 모델을 직접 생성하지 않아도 된다!

✔️ MemberListControllerV4 - 회원 목록 조회

@Override
    public String process(Map<String, String> paramMap, Map<String, Object> model) {

        .
        .
        model.put("members", members);

        return "members";
    }

✔️ ControllerV4

.
.
@Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

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

⬆️ FrontControllerServletV4는 이전 버전인 V3와 거의 동일하다

⬆️ 실행 결과 👍🏻

이번 버전의 컨트롤러는 매우 단순하고 실용적이다!
💡프레임워크나 공통 기능이 수고로워야 사용하는 개발자가 편리해진다💡

---

🏷 유연한 컨트롤러1 - v5

개발을 하다 보면 하나의 프로젝트 안에서 다양하고도 서로 다른 컨트롤러를 사용하고 싶어질 때가 있다!

🤔 : 나는 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 {
    // supprots : 어댑터가 해당 컨트롤러를 처리할 수 있는지 판단하는 메서드(반환 True/False
    // 핸들러는 곧 컨트롤러
    boolean supports(Object handler);
    // 어댑터는 실제 컨트롤러를 호출하고, 그 결과로 ModelView를 반환
    ModelView handle(HttpServletRequest request, HttpServletResponse response,
                     Object handler) throws ServletException, IOException;
}

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

✔️ ControllerV3HandlerAdapter 생성

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
    // ControllerV3 을 처리할 수 있는 어댑터를 뜻한다
    // 지원 할 수 있어? 없어?
    public boolean supports(Object handler) {
        return (handler instanceof ControllerV3);
    }

    @Override
    public ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // handler를 컨트롤러 V3로 변환한 다음에 V3 형식에 맞도록 호출한다.
        // supports() 를 통해 ControllerV3 만 지원하기 때문에 타입 변환은 걱정없이 실행해도 된다.
        // ControllerV3는 ModelView를 반환하므로 그대로 ModelView를 반환하면 된다.
        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;
    }
}

⬆️ ControllerV3를 처리할 수 있는 어댑터

✔️ 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 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;

// "/front-controller/v5/*" 로 오는 모든 요청 처리
@WebServlet(name = "frontControllerServletV5", urlPatterns = "/front-controller/v5/*")
public class FrontControllerServletV5 extends HttpServlet {
    // 기존에는 Object 위치에 컨트롤러 종류가 들어갔지만,
    // 이제는 어떤 종류의 컨트롤러든 다 들어갈 수 있어야 하므로 Object 사용
    private final Map<String, Object> handlerMappingMap = new HashMap<>();
    // 어댑터가 여러가 담겨있고 그 중 내가 하나를 가져다 써야 하므로 List
    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에 매핑해서 사용할 수 있어야 한다!
• 핸들러 매핑
  • Object handler = getHandler(request)
  • 핸들러 매핑 정보인 handlerMappingMap 에서 URL에 매핑된 핸들러(컨트롤러) 객체를 찾아서 반환한다.
• 매핑 정보
  • private final Map<String, Object> handlerMappingMap = new HashMap<>();
  • 매핑 정보의 값이 ControllerV3 , ControllerV4 같은 인터페이스에서 아무 값이나 받을 수 있는 Object 로 변경되었다.
• 핸들러를 처리할 수 있는 어댑터 조회
  • MyHandlerAdapter adapter = getHandlerAdapter(handler)
  • 핸들러를 처리할 수 있는 어댑터를 adapter.supports(handler) 를 통해서 찾는다.
• 어댑터 호출
  • ModelView mv = adapter.handle(request, response, handler);
  • 어댑터의 handle(request, response, handler) 메서드를 통해 실제 어댑터가 호출된다.
  • 어댑터는 handler(컨트롤러)를 호출하고 그 결과를 어댑터에 맞추어 반환한다

⬆️ 실행 결과 👍🏻

---

🏷 유연한 컨트롤러2 - v5

ControllerV4도 사용할 수 있도록 기능을 추가해보자❗️

✔️ FrontControllerV5 수정

✔️ ControllerV4HandlerAdapter 생성

ControllerV4HandlerAdapter 는 ControllerV3HandlerAdapter 와 ⬇️아래의 파란 블록 부분⬇️을 제외하고는 모두 동일하다!

⬆️ 이 블록이 매우 중요하다!

• 어댑터가 호출하는 ControllerV4 는 뷰의 이름을 반환한다.
• 그런데 어댑터는 뷰의 이름이 아니라 ModelView 를 만들어서 반환해야 한다! (어댑터가 꼭 필요한 이유)
• ControllerV4 는 뷰의 이름을 반환했지만, 어댑터가 이것을 ModelView로 형식을 맞추어 반환해준다!!!!

⬆️ 실행 결과 👍🏻

---

🏷 정리

이번 섹션에서는 V1 부터 V5까지 점진적으로 프레임워크를 발전시켰따❗️
정리 함 해봅시다☺️

1️⃣ v1, 프론트 컨트롤러 도입

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

2️⃣ v2, View 분류

• 단순 반복되는 뷰 로직 분리

3️⃣ v3, Model 추가와 서블릿 종속성 제거

• 뷰 이름 중복 제거

4️⃣ v4, 단순하고 실용적인 컨트롤러(v3와 거의 비슷)

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

5️⃣ v5, 유연한 컨트롤러 어댑터 도입

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

---

구우우우웃!