개발은 아름다워

[ Spring ] 고대의 서블릿을 찾아서(3) 템플릿 엔진을 너머 MVC패턴으로 본문

스프링

[ Spring ] 고대의 서블릿을 찾아서(3) 템플릿 엔진을 너머 MVC패턴으로

do_it_zero 2024. 10. 12. 11:36

지난 시간 템플릿 엔진으로 요청을 처리하는 방법을 배웠다. 템플릿 엔진으로 Http 요청을 처리하니 HTML 문서 코드 부분과 동적으로 자바 코드는 넣는 부분을 나눔으로써 코드 작성이 한결 쉬워졌다. 그러나 문제는 이어진다.

MVC 패턴 - 개요

과도한 역할을 방지하라,,,

하나의 서블릿이나 JSP만으로 비즈니스 로직과 뷰 렌더링까지 모두 처리하게 되면, 너무 많은 역할을 하게 되고, 결과적으로 유지보수가 어려워진다. 비즈니스 로직을 호출하는 부분에 변경이 발생해도 해당 코드를 수정해야하고, UI를 변경 할 일이 있어도 비즈니스 로직이 함께 있는 해당 파일을 수정해야 한다. 비즈니스 로직 하나를 수정해야하는데 수천줄의 HTML 코드가 함께 있다면..?

변경의 라이프 사이클

진짜 문제는 비즈니스 로직과 뷰 렌더링 사이에 변경 라이프 사이클이 다르다는 것이다. 예를 들어서 UI를 일부 수정하는 일과 비즈니스 로직을 수정하는 일은 각각 다르게 발생할 가능성이 매우 높고 대부분 서로에게 영향을 주지 않는다. 이렇게 변경 라이프 사이클이 다른 부분을 하나의 코드로 관리하는 것은 유지보수하기 좋지 않다.

기능 특화

특히 JSP 같은 뷰 템플릿은 화면을 렌더링 하는데 최적화 되어 있기 때문에 이 부분의 업무만 담당하는 것이 가장 효과적이다.

Model View Controller

MVC 패턴은 지금까지 학습한 것 처럼 하나의 서블릿이나 JSP로 처리하던 것을 Controller와 View라는 영역으로 서로 역할을 나눈 것을 말한다. 웹 애플리케이션은 보통 이 MVC 패턴을 사용한다.

컨트롤러

HTTP 요청을 받아서 파라미터를 검증하고, 비즈니스 로직을 실행한다. 그리고 뷰에 전달한 결과 데이터를 조회해서 모델에 담는다.

모델

뷰에 출력할 데이터를 담아둔다. 뷰가 필요한 데이터를 모두 모델에 담아서 전달해주는 덕분에 뷰는 비즈니스 로직이나 데이터 접근을 몰라도 되고, 화면을 렌더링 하는 일에 집중할 수 있다.

모델에 담겨있는 데이터를 사용해서 화면을 그리는 일에 집중한다. 여기서는 HTML을 생성하는 부분을 말한다.

코드로 이해해보자

현재는 컨트롤러 부분과 뷰 부분만 나눈 것이다.

== 컨트롤러 == 
@WebServlet(name = "mvcMemberFormServlet",urlPatterns = "/servlet-mvc/members/new-form")
public class MvcMemberFormServlet extends HttpServlet{

    @Override
    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        String viewPath = "/WEB-INF/views/new-form.jsp";
        RequestDispatcher dispatcher = req.getRequestDispatcher(viewPath);
        dispatcher.forward(req, resp);
    }
}

== JSP (뷰) == 
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
 <meta charset="UTF-8">
 <title>Title</title>
</head>
<body>
    <!-- 상대경로 사용, [현재 URL이 속한 계층 경로 + /save] -->
<form action="save" method="post">
 username: <input type="text" name="username" />
 age: <input type="text" name="age" />
 <button type="submit">전송</button>
</form>
</body>
</html>

위의 코드를 이해해보자
1. 클라이언트에서 http://localhost:8080/servlet-mvc/members/new-form로 서버에 요청한다.
2. 해당 요청를 받는 MvcMemberFormServlet에서 service가 실행된다.
3. service 코드 안에는 jsp 경로인 viewPath가 있다.
4. HttpServletRequest 객체인 req의 getRequestDispatcher에 viewPath를 담고 ReqeuestDispatcher의 인스턴스 dispatcher를 만든다.
5. dispatcher는 뷰 경로 즉, JSP 경로가 있으며 그 경로에 forward 요청을 하면 뷰 경로에 해당하는 JSP 서블릿을 호출하게 된다.
6. JSP 서블릿은 브라우저에 응답 데이터를 내려준다.

자, 이번에는 save 요청을 이전 JSP로만 했던 코드와 mvc를 적용한 코드를 비교해보자

== JSP 로만 == 
<%@ page import="spring.web.domain.member.MemberRepository" %>
<%@ page import="spring.web.domain.member.Member" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<% 

// request,response 사용 가능

    MemberRepository memberRepository = MemberRepository.getInstance();

    System.out.println("save.jsp");
    String username = request.getParameter("username");
    int age = Integer.parseInt(request.getParameter("age"));
    Member member = new Member(username, age);
    System.out.println("member = " + member);
    memberRepository.save(member);
%>

<html>
<head>
 <meta charset="UTF-8">
</head>
<body>
성공
<ul>
 <li>id=<%=member.getId()%></li>
 <li>username=<%=member.getUsername()%></li>
 <li>age=<%=member.getAge()%></li>
</ul>
<a href="/index.html">메인</a>
</body>
</html>

== MVC 적용 후 JSP 코드  ==
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
 <meta charset="UTF-8">
</head>
<body>
성공
<ul>
 <li>id=${member.id}</li>
 <li>username=${member.username}</li>
 <li>age=${member.age}</li>
</ul>
<a href="/index.html">메인</a>
</body>
</html>

== MVC 적용을 위한 컨트롤러 코드 == 
@WebServlet(name = "mvcMemberSaveServlet",urlPatterns = "/servlet-mvc/members/save")
public class MvcMemberSaveServlet extends HttpServlet{
    
    private MemberRepository memberRepository = MemberRepository.getInstance();
    
    @Override
    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        String username = req.getParameter("username");
        int age = Integer.parseInt(req.getParameter("age"));
        
        Member member = new Member(username, age);
        System.out.println("member = " + member);
        memberRepository.save(member);

        // Model에 데이터를 보관
        req.setAttribute("member", member);

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

이전에는 뷰를 담당하는 JSP 코드에 서비스 로직들이 덥지 덥지 붙어 있어서 보기에도 복잡해보였다. 하지만 MVC를 적용 후 JSP 코드는 깔끔하게 뷰 로직만 담당하도록 바뀌었다. 이렇게 MVC 패턴을 적용하니 비즈니스 로직을 담당하는 컨트롤러와 뷰 로직을 담당하는 JSP로 명확하게 역할을 구분할 수 있게 되었다. 특히 뷰는 화면을 그리는 역할에 충실해 코드가 깔끔하고 직관적이게 되었다. 단순하게 모델에서 필요한 데이터를 꺼내고, 화면을 만든다. 그런데 컨트롤러는 딱 봐도 중복이 많고 필요하지 않는 코드들도 보인다.

MVC 패턴 한계

MVC 컨트롤러의 단점

포워드가 중복된다

View로 이동하는 코드가 항상 중복 호출되어야한다. 물론 이 부분을 메서드로 공통화해도 되지만, 해당 메서드도 항상 직접 호출해야한다.

RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
dispatcher.forward(request, response);

viewPath에 중복

String viewPath = "/WEB-INF/views/new-form.jsp";

  • prefix: /WEB-INF/views/
  • suffix: .jsp

그리고 만약 jsp가 아닌 thymeleaf 같은 다른 뷰로 변경한다면 전체 코드를 다 변경해야한다.

사용하지 않는 코드

HttpServletRequest request, HttpServletResponse response 코드는 사용할 때도 있고, 사용하지 않을 때도 있다.

정리하면 공통 처리가 어렵다!

공통 처리를 해주는 무언가가 있으면 좋겠다는 생각이 든다. 소위 수문장 역할을 하는 기능이 필요하다. 이것을 위해 프론트 컨트롤러(Front Controller) 패턴을 도입하면 이런 문제를 깔끔하게 해결할 수 있다. 스프링 MVC의 핵심도 프론트 컨트롤러에 있다!