MVC 프레임워크 만들기

프론트 컨트롤러 패턴 소개

https://surrealcode.tistory.com/127

서블릿, JSP, MVC 패턴

 

프론트 컨트롤러 패턴을 도입하기 전에는 컨트롤러마다 공통로직을 전부 호출해주었어야 했다.(이전 포스팅 참조)

 

이전 포스팅에서는 포워드가 중복됐었고, viewPath가 중복 됐었고, 사용하지 않는 코드들을 만들었어야 했다.

 

프론트 컨트롤러를 도입하면(Front Controller도 서블릿이다.)

프론트 컨트롤러에 공통 로직을 다 몰아놓고, 각각 필요한 로직은 각자 처리를 하게 만드는 것이다.

 

*FrontController 패턴 특징

- 프론트 컨트롤러 서블릿 하나로 클라이언트의 요청을 받는다.

- 프론트 컨트롤러가 요청에 맞는 컨트롤러를 찾아서 호출한다.

- 입구를 하나로 만드는 것이다.

- 공통 처리가 가능하다.

- 프론트 컨트롤러를 제외한 나머지 컨트롤러는 서블릿을 사용하지 않아도 되게 된다.

 

*스프링 웹 MVC와 프론트 컨트롤러

스프링 웹 MVC의 핵심도 바로 FrontController

스프링 웹 MVC의 DispatcherServlet이 FrontController패턴으로 구현되어 있음

 

 

 

프론트 컨트롤러 도입 - v1

프론트 컨트롤러를 단계적으로 도입해보자.

이번 목표는 기존 코드를 최대한 유지하며, 프론트 컨트롤러를 도입하는 것이다.

먼저 구조를 맞추어두고, 점진적으로 리팩토링 해보자.

1. HTTP 요청을 하면 FrontController서블릿이 요청을 받는다.

2. HTTP 요청의 URL 매핑 정보를 가지고, 컨트롤러를 매핑 정보에 넣어둔다.이후 매핑정보를 뒤져서 컨트롤러를 호출한다.

3. 컨트롤러는 로직을 수행하고, 값을 JSP에 포워드해준다

4. JSP는 받은 값을 토대로 HTML을 뿌려준다.

 

우선 ControllerV1인터페이스를 도입하자.

public interface ControllerV1 {

    void process(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException;

}

 

ControllerV1을 보면 Servlet과 비슷한 모양의 컨트롤러 인터페이스를 도입하였다. 각 컨트롤러들은 이 인터페이스를 구현하면 된다. 프론트 컨트롤러는 이 인터페이스를 호출해서 구현과 관계없이 로직의 일관성을 가져갈 수 있다.

 

이후 컨트롤러 들을 구현하였다. 컨트롤러들은 Controller를 구현한다.

public class MemberFormControllerV1 implements ControllerV1 {

    @Override
    public void process(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        String viewPath = "/WEB-INF/views/new-form.jsp";
        RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
        dispatcher.forward(request,response);
    }
}

public class MemberSaveControllerV1 implements ControllerV1 {

    MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    public void process(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        String username = request.getParameter("username");
        int age = Integer.parseInt(request.getParameter("age"));

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

        //Model에 데이터를 보관해야 한다.
        request.setAttribute("member", member);

        String viewPath = "/WEB-INF/views/save-result.jsp";
        RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
        dispatcher.forward(request, response);
    }
}

public class MemberListControllerV1 implements ControllerV1 {

    MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    public void process(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        List<Member> members = memberRepository.findAll();

        request.setAttribute("members", members);

        String viewPath = "/WEB-INF/views/members.jsp";
        RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
        dispatcher.forward(request, response);

    }
}

 

로직은 이전 포스팅에서 만들었던 서블릿들 로직과 동일하다.

 

그럼 이 컨트롤러들을 호출할 FrontController가 필요하다. 이 부분이 매우 중요하다. 잘 확인해보자.

//v1하위에 어떤 url이 들어와도 일단 이 서블릿이 호출된다.
@WebServlet(name = "frontControllerServletV1", urlPatterns = "/front-controller/v1/*")
public class FrontControllerServletV1 extends HttpServlet {

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

    public FrontControllerServletV1() {
        controllerMap.put("/front-controller/v1/members/new-form", new MemberFormControllerV1());
        controllerMap.put("/front-controller/v1/members/save", new MemberSaveControllerV1());
        controllerMap.put("/front-controller/v1/members", new MemberListControllerV1());

    }

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("FrontControllerServletV1.service");

        String requestURI = request.getRequestURI(); //URI를 받음
        ControllerV1 controller = controllerMap.get(requestURI);
        if (controller == null) {
            response.setStatus(HttpServletResponse.SC_NOT_FOUND); //페이지가 없거나 못찾을때
            return;
        }
        controller.process(request,response);
    }
}

 

 

우선 urlPatterns를 보면 "/front-controller/v1/*"로 되어있다.

/front-controller/v1/를 포함한 하위 모든 요청은 이 서블릿을 거쳐야 하도록 설계하였다.

 

또한 Map을 톻해 키를 URI, 값을 ControllerV1으로 설정하였는데(인터페이스이기에 하위 구현객체들을 값으로 넣을 수 있음)

 controllerMap<Key, Value>

Key : 매핑한 URL

Value : 호출될 컨트롤러

 

map의 값을 생성자메서드를 통해 집어넣어주었다.

 

서블릿에서 request.getRequstURI()메서드로 요청된 URI의 값을 꺼낼 수 있는 메서드가 존재한다.

이 꺼내진 requestURI를 가지고 Map에 get메서드를 통해 구현된 Controller를 꺼낼 수 있다. 꺼내진 컨트롤러의 process 메서드에 request와 response를 파라미터로 넣는 형식의 FrontControllerV1이 만들어 진 것이다.

 

-> 여러 컨트롤러와 서블릿들이 JSP파일을 재사용하고 있다.

 

정리 : 모든 컨트롤러에서 뷰로 이동하는 부분에 중복이 있고 깔끔하지 않다.

String viewPath = "/WEB-INF/views/save-result.jsp";
RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
dispatcher.forward(request, response);

이 부분을 깔끔하게 분리하기 위해 '뷰'라는 개념이 등장하였다.

 

 

 

View 분리 - V2

기존에 있던 뷰를 깔끔하게 분리하기 위해 별도로 뷰를 처리하는 객체를 만들어보자.

1. 클라이언트가 HTTP 요청을 한다. 그럼 frontController가 매핑정보를 찾아온다.

2. FrontController가 컨트롤러를 호출하면 view를 직접 포워딩하지 않고 MyView를 반환한다.

3. FrontController가 MyView의 render()를 호출하면

4. MyView가 JSP에 포워딩을 하고

5. JSP HTML 응답이 나가게 된다.

 

패키지와 클래스 구조는 다음과 같다.

우선 뷰를 분리하기 위한 MyView객체를 만들었다.

public class MyView {

    private String viewPath;

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

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

MyView 객체는 생성자를 통해 viewPath를 받고 저장하며, render메서드를 통해 저장된 URL을 기반으로 JSP에 포워딩을 해주는 기능을 가지고 있다.

 

이후 ControllerV2 인터페이스를 만들었다.

public interface ControllerV2 {

    MyView process(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException;

}

 

이 인터페이스를 구현할 컨트롤러들은 process메서드를 실행할때 MyView를 리턴해야한다.

인터페이스를 구현한 컨트롤러들을 만들어보자.

public class MemberFormControllerV2 implements ControllerV2 {

    @Override
    public MyView process(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        return new MyView("/WEB-INF/views/new-form.jsp");
    }
}

public class MemberSaveControllerV2 implements ControllerV2 {

    MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    public MyView process(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

        String username = request.getParameter("username");
        int age = Integer.parseInt(request.getParameter("age"));

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

        //Model에 데이터를 보관해야 한다.
        request.setAttribute("member", member);

        return new MyView("/WEB-INF/views/save-result.jsp");
    }
}

public class MemberListControllerV2 implements ControllerV2 {

    private MemberRepository memberRepository = MemberRepository.getInstance();


    @Override
    public MyView process(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        List<Member> members = memberRepository.findAll();

        request.setAttribute("members", members);

        return new MyView("/WEB-INF/views/members.jsp");
    }
}

 

구현된 컨트롤러들을 보면 process 메서드를 통해 viewPath(JSP파일패스)를 리턴한다.

 

이 컨트롤러들을 호출할 FrontController를 생성해보자.

//v2하위에 어떤 url이 들어와도 일단 이 서블릿이 호출된다.
// /front-controller/v2/~
@WebServlet(name = "frontControllerServletV2", urlPatterns = "/front-controller/v2/*")
public class FrontControllerServletV2 extends HttpServlet {

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

    public FrontControllerServletV2() {
        controllerMap.put("/front-controller/v2/members/new-form", new
                MemberFormControllerV2());
        controllerMap.put("/front-controller/v2/members/save", new
                MemberSaveControllerV2());
        controllerMap.put("/front-controller/v2/members", new
                MemberListControllerV2());
    }

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

        String requestURI = request.getRequestURI(); //URI를 받음

        ControllerV2 controller = controllerMap.get(requestURI);
        if (controller == null) {
            response.setStatus(HttpServletResponse.SC_NOT_FOUND); //페이지가 없거나 못찾을때
            return;
        }

        //new MyView("~~.jsp")
        MyView view = controller.process(request, response);
        view.render(request, response);
    }
}

 

이제 각 컨트롤러는 복잡한 'dispatcher.forward()'를 직접 생성해서 호출하지 않아도 된다. 단순히 MyView 객체를 생성하고, 거기에 뷰 이름만 넣고 반환하면 된다.

 

ControllerV1을 구현한 클래스와 ControllerV2를 구현한 클래스를 보면 이 부분의 중복이 제거된 것을 확인할 수 있다.

 

 

 

Model 추가 - V3

*서블릿 종속성 제거*

컨트롤러 입장에서 HttpServletRequest, HttpServletResponse가 꼭 필요할까?

요청 파라미터 정보는 자바의 Map으로 대신 넘기도록 하면 지금 구조에서는 컨트롤러가 서블릿 기술을 몰라도 동작할 수 있다. 그리고 request 객체를 Model로 사용하는 대신에 별도의 Model 객체를 만들어서 반환하면 된다.

우리가 구현하는 컨트롤러가 서블릿 기술을 전혀 사용하지 않도록 변경해보자.

이렇게 하면 구현 코드도 매우 단순해지고, 테스트 코드 작성이 쉽다.

 

*뷰 이름 중복 제거*

컨트롤러에서 지정하는 뷰 이름에 중복이 있는 것을 확인할 수 있다.

컨트롤러는 뷰의 논리 이름을 반환하고, 실제 물리 위치의 이름은 프론트 컨트롤러에서 처리하도록 단순화 하자.

이렇게 해두면 향후 뷰의 폴더 위치가 함께 이동해도 프론트 컨트롤러만 고치면 된다.

- "WEB-INF/views/new-form.jsp" -> new-form

- "WEB-INF/views/save-result.jsp" -> save-result

- "WEB-INF/views/members.jsp" -> members

 

V3의 구조는 위와 같다.

1. 클라이언트가 FrontController에 HTTP를 요청하면 FrontController가 매핑정보를 갖게 된다.

2. FrontController가 컨트롤러를 호출한다.

3. 컨트롤러가 Model과 View가 섞여있는 ModelView를 반환한다.

4. 위에 있는 논리 이름을 물리 이름으로 바꿔줄 veiwResolver를 호출한다.

5. viewResolver가 MyView를 반환하면,

6. FrontController가 render에 모델을 담아서 MyView를 호출한다.

 

*ModelView

지금까지 컨트롤러에서 서블릿에 종속적인 HttpServletRequest를 사용했다. 그리고 Model로 request.setAttribute()를 통해 데이터를 저장하고 뷰에 전달했다.

서블릿 종속성을 제거하기 위해 Model을 직접 만들고, 추가로 View이름까지 전달하는 객체를 만들어보자.

(이번엔 HttpServletRequest를 사용할 수 없다. 따라서 직접 request.setAttribuet()를 호출할수도 없다. 따라서 Model이 필요하다)

ModelView객체를 만들어주자.

public class ModelView {

    private String viewName;
    private Map<String, Object> model = new HashMap<>();

    public ModelView(String viewName) {
        this.viewName = viewName;
    }

    public String getViewName() {
        return viewName;
    }

    public void setViewName(String viewName) {
        this.viewName = viewName;
    }

    public Map<String, Object> getModel() {
        return model;
    }

    public void setModel(Map<String, Object> model) {
        this.model = model;
    }
}

 

이후 Controller를 만들기 위해 인터페이스를 생성한다.

public interface ControllerV3 {

    ModelView process(Map<String, String> paramMap);
}

서블릿 종속성 제거를 위해 request, response 대신 Map을 사용하였다. 또한 ModelView를 반환하도록 하였다.

앞으로 Controller구현체들은 process에서 ModelView를 반환하게 될 것이다.

 

 

구현체인 Form, List, Save를 만든다.

public class MemberFormControllerV3 implements ControllerV3 {

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

public class MemberSaveControllerV3 implements ControllerV3 {

    MemberRepository memberRepository = MemberRepository.getInstance();

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

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

        ModelView mv = new ModelView("save-result");
        mv.getModel().put("member", member);
        return mv;
    }
}

public class MemberListControllerV3 implements ControllerV3 {

    MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    public ModelView process(Map<String, String> paramMap) {
        List<Member> members = memberRepository.findAll();

        ModelView mv = new ModelView("members");
        mv.getModel().put("members", members);

        return mv;
    }
}

 

 

마지막으로 FrontController를 만들어주었다.

@WebServlet(name = "frontControllerServletV3", urlPatterns = "/front-controller/v3/*")
public class FrontControllerServletV3 extends HttpServlet {

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

    public FrontControllerServletV3() {
        controllerMap.put("/front-controller/v3/members/new-form", new
                MemberFormControllerV3());
        controllerMap.put("/front-controller/v3/members/save", new
                MemberSaveControllerV3());
        controllerMap.put("/front-controller/v3/members", new
                MemberListControllerV3());
    }

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

        String requestURI = request.getRequestURI(); //요청하는 URI값을 받음

        ControllerV3 controller = controllerMap.get(requestURI);
        if (controller == null) {
            response.setStatus(HttpServletResponse.SC_NOT_FOUND); //페이지가 없거나 못찾을때
            return;
        }

        Map<String, String> paramMap = createParamMap(request); //
        ModelView mv = controller.process(paramMap);


        //viewResolver 호출
        String viewName = mv.getViewName();
        MyView view = viewResolver(viewName);

        view.render(mv.getModel(),request,response);

    }

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

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

 

 

createParamMap() : HttpServletRequest에서 파라미터 정보를 꺼내서 Map으로 변환한다. 그리고 해당 Map을 컨트롤러에 전달하면서 호출한다.

 

ViewResolver(viewName) : 컨트롤러가 반환한 논리 뷰 이름을 실제 물리 뷰 경로로 변경한다. 그리고 실제 물리 경로가 있는 MyView 객체를 반환한다.

 

view.render(mv.getModel(), request, response) : 뷰 객체를 동해 HTML화면을 렌더링한다. 뷰 객체의 render()는 모델 정보도 함께 받는다. JSP는 request.getAttribute()로 데이터를 조회하기 때문에 모델의 데이터를 꺼내서 request.setAttribute로 담아둔다. JSP로 포워드해서 JSP를 렌더링한다.

 

 

 

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

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

좋은 프레임워크는 아키텍처도 중요하지만, 그와 더불어 실제 개발하는 개발자가 단순하고 편리하게 사용할 수 있어야 한다. 즉 실용성이 있어야 한다.

이번에는 v3를 조금 변경해서 개발자들이 편리하게 개발할 수 있는 v4 버전을 개발해보자.

-기본적인 구조는 V3와 비슷하지만 ModelView를 반환하지 않고 MyView만 반환한다.

 

public interface ControllerV4 {
    /**
     *
     * @param paramMap
     * @param model
     * @return viewName
     */
    String process(Map<String, String> paramMap, Map<String, Object> model);
}

public class MemberFormControllerV4 implements ControllerV4 {

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

public class MemberSaveControllerV4 implements ControllerV4 {

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

public class MemberListControllerV4 implements ControllerV4 {

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

 

FrontControllerServletV4는 이전 버전과 거의 동일하다.

 

*동일 객체 전달 *

Map<String, Object> model = new HashMap<>(); //추가

모델 객체를 프론트 컨트롤러에서 생성해서 넘겨준다. 컨트롤러에서 모델 객체에 값을 담으면 여기에 그대로 담겨있게 된다.

 

*뷰의 논리 이름을 직접 반환

컨트롤러가 직접 뷰의 논리 이름을 String 으로 반환하므로 이 값을 사용해서 실제 물리 뷰를 찾을 수 있다.

 

 

*정리 : 이번 버전의 컨트롤러는 매우 단순하고 실용적이다. 기존 구조에서 모델을 파라미터로 넘기고, 뷰의 논리 이름을 반환한다는 작은 아이디어를 적용했을 뿐인데, 컨트롤러를 구현하는 개발자 입장에서 보면 군더더기 없는 코드를 작성할 수 있다.

또 중요한 사실은 여기까지 한번에 온 것이 아니라는 점이다. 프레임워크가 점진적으로 발전하는 과정 속에서 이런 방법도 찾을 수 있었다.

 

**프레임워크나 공통 기능이 수고로워야 사용하는 개발자가 편리해진다.

 

 

 

유연한 컨트롤러1 - V5

만약 개발자가 ControllerV4의 구조가 아닌 ControllerV3방식으로 개발하고 싶다고 한다.

그럼 어떻게 해야할까?

public interface ControllerV3 {

    ModelView process(Map<String, String> paramMap);
}

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

return 되는 객체도 다르고, 메소드의 파라미터 갯수 또한 다르다.

이 문제를 해결하기 위해 어댑터 패턴이 등장하였다.

 

*어댑터 패턴*

지금까지 우리개 개발한 프론트 컨트롤러는 한가지 방식의 컨트롤러 인터페이스만 사용할 수 있었다.

ControllerV3, ControllerV4는 완전히 다른 인터페이스이다. 따라서 호환이 불가능하다.

콘센트에 비유하자면 V3는 110V이고, V4는 220v 전기 콘센트 같은 것이다. 이럴때 사용하는 것이 바로 어댑터이다.

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

 

어댑터 패턴 : 개발에서도 뭔가 두개가 안맞을 때 중간에 하나를 끼워서 맞추는 걸 어댑터 패턴이라 한다.

핸들러 어댑터 : 중간에 어댑터 역할을 하는 어댑터가 추가되었는데, 이름이 핸들러 어댑터이다. 여기서 어댑터 역할을 해주는 덕분에 다양한 종류의 컨트롤러를 호출할 수 있다.

핸들러(컨트롤러) : 컨트롤러의 이름을 더 넓은 범위인 핸들러로 변경했다. 그 이유는 어댑터가 있기 때문에 꼭 컨트롤러의 개념 뿐만 아니라 어떠한 것이는 해당하는 종류의 어댑터만 있으면 다 처리할 수 있기 때문이다.

 

핸들러(컨트롤러)를 호출하려면 핸들러 어댑터를 통해서 호출해야 한다.

 

우선 V3 방식을 사용한다고 가정하자. 패키지는 다음과 같다.

 

핸들러(컨트롤러)를 호출할 핸들러어댑터 인터페이스를 우선 생성해보자.

public interface MyHandlerAdapter {

    boolean supports(Object handler);

    ModelView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws ServletException, IOException;
}

 

supports()는 FrontController가 핸들러 매핑정보에서 핸들러를 가져오고 핸들러 어댑터 목록에서 핸들러를 처리할 수 있는 어댑터를 조회하는 역할을 할 예정이다.

handle 메서드는 말 그대로 handler를 호출해준다. 또한 ModelView를 반환한다. 이전에는 프론트 컨트롤러가 실제 컨트롤러를 호출했지만, 이제는 이 어댑터를 통해 실제 컨트롤러가 호출된다.

 

ModelView가 어떤 구조인지 다시 상기시켜보자.

@Getter
@Setter
public class ModelView {

    private String viewName;
    private Map<String, Object> model = new HashMap<>();

    public ModelView(String viewName) {
        this.viewName = viewName;
    }
    
}

viewName(논리를 받아서 물리로 바꾸어야 하기 때문에)을 String으로 받고, Map이 존재한다.

 

위의 MyHandlerAdapter를 구현하는 ControllerV3HandlerAdapter 객체를 생성하였다.

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) 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(Object handler) : 파라미터가 ControllerV3의 인스턴스이면 true를 아니라면 false를 반환한다.

 

handle(HttpServletRequest request, HttpServletResponse response, Object handler) : 인터페이스의 메서드를 구현한 handle이다. handler를 ControllerV3로 캐스팅한다. supports에서 controllerV3라는 검증을 끝낸 이후 호출되는 메서드이기 때문에 캐스팅이 가능하다.

이후 createParamMap으로 request로 요청을 분해하여 값을 paramMap에 담는다.

이후 controller(얘는 V3이다) process의 

 

사실 위 클래스만 봐서는 이해하기 어렵고, FrontControllerServletV5 프론트 컨트롤러가 진또배기이다.

@WebServlet(name = "frontControllerServletV5", urlPatterns = "/front-controller/v5/*")
public class FrontControllerServletV5 extends HttpServlet {

    //V3, V4등 아무 컨트롤러나 다 들어가야 하기 때문에 Object
    private final Map<String, Object> handlerMappingMap = new HashMap<>();
    //여러 어댑터중 맞는걸 꺼내서 쓰기 위해
    private final List<MyHandlerAdapter> handlerAdapters = new ArrayList<>();

    public FrontControllerServletV5() {
        initHandlerMappingMap();
        initHandlerAdapters();
    }

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

        //핸들러 어댑터를 통해 V3컨트롤러 호출
        ModelView mv = adapter.handle(request, response, handler);

        //viewResolver 호출
        String viewName = mv.getViewName();
        MyView view = viewResolver(viewName);

        view.render(mv.getModel(),request,response);
        
    }

    private Object getHandler(HttpServletRequest request) {
        String requestURI = request.getRequestURI(); //요청하는 URI값을 받음
        Object handler = handlerMappingMap.get(requestURI);
        return handler;
    }

    private MyHandlerAdapter getHandlerAdapter(Object handler) {
        for (MyHandlerAdapter adapter : handlerAdapters) {
            if (adapter.supports(handler)) {
                return adapter;
            }
        }
        throw new IllegalArgumentException("handler adapter를 찾을 수 없습니다. handler = " + handler);
    }

    //매핑정보

    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());
    }
    //핸들러 조회

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


}

V3,V4등 여러 컨트롤러가 담길 수 있어야하기에 Object가 담길 수 있는 Map인 handlerMappingMap을 선언하였다.

다음은 hadlerAdapters인데 여러 어댑터를 저장하고 핸들러에 맞는 핸들러 어댑터를 꺼내기 위한 List이다.

getHandler 메서드를 통해 URI에 맞는 핸들러를 꺼내게 되고,

getHandlerAdapter 메서드를 통해 getHandler에서 꺼낸 핸들러에 맞는 핸들러 어댑터를 조회하여 꺼내게 된다.

꺼내진 핸들러 어댑터를 통해 V3를 컨트롤하고

이후 로직은 V3와 동일하다.

 

위의 V5 구조와 정확하게 일치하는 코드를 생성하였다.

어댑터 패턴을 쓴 이유는 V3뿐만 아니라 V2, V4 등의 컨트롤러 기능도 추가하여 사용하기 위해 어댑터 패턴을 사용하였다.

V4의 기능도 추가해보자.

 

 

 

유연한 컨트롤러2 - V5

FrontControllerServletV5에 ControllerV4 기능도 추가해보자.

@WebServlet(name = "frontControllerServletV5", urlPatterns = "/front-controller/v5/*")
public class FrontControllerServletV5 extends HttpServlet {

    //V3, V4등 아무 컨트롤러나 다 들어가야 하기 때문에 Object
    private final Map<String, Object> handlerMappingMap = new HashMap<>();
    //여러 어댑터중 맞는걸 꺼내서 쓰기 위해
    private final List<MyHandlerAdapter> handlerAdapters = new ArrayList<>();

    public FrontControllerServletV5() {
        initHandlerMappingMap();
        initHandlerAdapters();
    }

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

        //핸들러를 통해 V3컨트롤러 호출
        ModelView mv = adapter.handle(request, response, handler);

        //viewResolver 호출
        String viewName = mv.getViewName();
        MyView view = viewResolver(viewName);

        view.render(mv.getModel(),request,response);

    }

    private Object getHandler(HttpServletRequest request) {
        String requestURI = request.getRequestURI(); //요청하는 URI값을 받음
        Object handler = handlerMappingMap.get(requestURI);
        return handler;
    }

    private MyHandlerAdapter getHandlerAdapter(Object handler) {
        for (MyHandlerAdapter adapter : handlerAdapters) {
            if (adapter.supports(handler)) {
                return adapter;
            }
        }
        throw new IllegalArgumentException("handler adapter를 찾을 수 없습니다. handler = " + handler);
    }

    //매핑정보

    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());
    }
    //핸들러 조회

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


}

 

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) throws ServletException, IOException {
        ControllerV4 controller = (ControllerV4) handler;

        Map<String, String> paramMap = createParamMap(request);
        HashMap<String, Object> model = new HashMap<>();
        String viewName = controller.process(paramMap, model);

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

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

 

로직은 기존V5와 동일하다.

FrontControllerServletV5에 핸들러 매핑 정보만 추가하고, 핸들러 어댑터 목록에 ControllerV4HandlerAdapter만 추가한 것이 전부이다.(얘내를 밖으로 빼주기만 한다면 FrontControllerServletV5는 완벽하게 OCP를 지킬 것이다)

 

ControllerV4HandlerAdapter도 기존 V3와 거의 비슷하지만 V4의 process는 String타입인 viewName을 반환한다.

 

어탭터에서 이 부분이 단순하지만 중요한 부분이다.

어댑터가 호출하는 ControllerV4는 뷰의 이름을 반환한다. 그런데 어댑터는 뷰의 이름이 아니라 ModelView를 만들어서 반환해야 한다. 여기서 어댑터가 꼭 필요한 이유가 나온다.

ControllerV4는 뷰의 이름을 반환했지만, 어댑터는 이것을 ModelView로 만들어서 형식을 맞추어 반환한다. 맞리 110v 전기 콘센트를 220v 전기 콘센트로 변경하듯이

 

여기에 어노테이션을 사용해가며 컨트롤러를 더 편리하게 발전시킬수도 있다. 만약 어노테이션을 사용해서 컨트롤러를 편리하게 사용할 수 있게 하려면 어떻게 해야할까? 바로 어노테이션을 지원하는 어댑터를 추가하면 된다.

다형성과 어댑터 덕분에 기존 구조를 유지하며, 프레임워크의 기능을 확장할 수 있다.

 

*스프링 MVC*

여기서 더 발전시키면 좋겠지만, 스프링 MVC의 핵심 구조를 파악하는데 필요한 부분은 모두 만들어보았다. 사실은 지금까지 작성한 코드는 스프링 MVC 프레임워크의 핵심 코드의 축약 버전이고, 구조도 거의 동일하다.

 

ex) RequestMapping("/hello")

RequestMappingHandlerAdapter