(스프링 MVC 1편) 3. 서블릿, JSP, MVC 패턴

이 글은 김영한 님의 스프링 MVC 1편 수강 후 정리한 글입니다.

(https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-mvc-1/dashboard)

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 - 인프런 | 강의

웹 애플리케이션을 개발할 때 필요한 모든 웹 기술을 기초부터 이해하고, 완성할 수 있습니다. 스프링 MVC의 핵심 원리와 구조를 이해하고, 더 깊이있는 백엔드 개발자로 성장할 수 있습니다., -

www.inflearn.com

회원 관리 웹 애플리케이션 요구사항

회원 정보는 다음과 같다.

이름: username
나이: age

기능 요구사항은 다음과 같다.

회원 저장
회원 목록 조회

1. 회원 도메인 모델

회원 도메인 모델을 생성한다.

hello.servlet.domain.member.Member를 다음과 같이 생성한다.

// Member.class
@Getter
@Setter
public class Member {

    private Long id;
    private String username;
    private int age;

    public Member() {
    }

    public Member(String username, int age) {
        this.username = username;
        this.age = age;
    }
}

id는 저장소에 저장 시에 자동으로 할당하게 한다.

2. 회원 저장소

다음으로 회원 저장소를 생성한다.

hello.servlet.domain.member.MemberRepository를 다음과 같이 생성한다.

// MemberRepository.class
/**
 * 동시성 문제가 고려되어 있지 않음, 실무에서는 ConcurrentHashMap, AtomicLong 사용 고려
 */
public class MemberRepository {

    private static Map<Long, Member> store = new HashMap<>();
    private static long sequence = 0L;

    private static final MemberRepository instance = new MemberRepository();

    public static MemberRepository getInstance(){
        return instance;
    }

    private MemberRepository(){
    }

    public Member save(Member member){
        member.setId(++sequence);
        store.put(member.getId(), member);
        return member;
    }

    public Member findById(Long id){
        return store.get(id);
    }

    public List<Member> findAll(){
        return new ArrayList<>(store.values());
    }

    public void clearStore() {
        store.clear();
    }
}

회원 저장소는 싱글톤 패턴을 적용했다.

스프링을 사용할 때는 스프링 빈으로 등록하기만 하면 싱글톤이 보장되지만, 지금은 최대한 스프링 없이 순수 서블릿 만으로 구현하고자 했다.
싱글톤 패턴은 객체를 단 하나만 생성한 후 이를 공유해야 하므로 생성자를 private 접근자로 막아둔다.

3. 회원 저장소 테스트 코드

마지막으로 위에서 만든 회원 저장소의 기능이 잘 작동하는지 확인하기 위해 테스트 코드를 작성해 보자.

MemberRepository.class에서 Cntr+Shift+T를 누르면 자동으로 해당 파일에 대한 테스트 코드 파일이 생성된다.

그 후 다음과 같이 코드를 완성한다.

// MemberRepositoryTest.class
class MemberRepositoryTest {

    MemberRepository memberRepository = MemberRepository.getInstance();

    @AfterEach // 하나의 테스트가 끝날 때마다 실행
    void afterEach(){
        memberRepository.clearStore();
    }

    @Test
    void save(){
        // given
        Member member = new Member("hello", 20);

        // when
        Member savedMember = memberRepository.save(member);

        // then
        Member findMember = memberRepository.findById(savedMember.getId());
        assertThat(findMember).isEqualTo(savedMember);
    }

    @Test
    void findAll(){
        // given
        Member member1 = new Member("hello1", 20);
        Member member2 = new Member("hello2", 30);

        memberRepository.save(member1);
        memberRepository.save(member2);

        // when
        List<Member> result = memberRepository.findAll();

        // then
        assertThat(result.size()).isEqualTo(2);
        assertThat(result).contains(member1, member2);
    }
}

각 테스트가 끝날 때, 다음 테스트에 영향을 주지 않도록 하나의 테스트가 종료될 때마다 @AfterEach를 통해 clearStore()를 호출해서 회원 저장소를 초기화했다.

서블릿으로 회원 관리 웹 애플리케이션 만들기

이제부터 서블릿으로 회원 관리 웹 애플리케이션을 만들어 보겠다.

1. MemberFormServlet - 회원 등록 폼

먼저 회원 정보를 받기 위한 회원 등록 폼을 만들어보자.

hello.servlet.web.servlet.MemberFormServlet를 다음과 같이 생성한다.

// MemberFormServlet.class
@WebServlet(name = "memberFormServlet", urlPatterns = "/servlet/members/new-form")
public class MemberFormServlet extends HttpServlet {

    private MemberRepository memberRepository = MemberRepository.getInstance();

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

        response.setContentType("text/html");
        response.setCharacterEncoding("utf-8");

        PrintWriter w = response.getWriter();
        w.write("<!DOCTYPE html>\n" +
                "<html>\n" +
                "<head>\n" +
                " <meta charset=\"UTF-8\">\n" +
                " <title>Title</title>\n" +
                "</head>\n" +
                "<body>\n" +
                "<form action=\"/servlet/members/save\" method=\"post\">\n" +
                " username: <input type=\"text\" name=\"username\" />\n" +
                " age: <input type=\"text\" name=\"age\" />\n" +
                " <button type=\"submit\">전송</button>\n" +
                "</form>\n" +
                "</body>\n" +
                "</html>\n");
    }
}

프로그램 실행 후 http://localhost:8080/servlet/members/new-form에 접속하여 보면 다음과 같은 회원 등록을 위한 폼을 확인할 수 있다.

2. MemberSaveServlet - 회원 저장

이번엔 실제 회원 정보가 폼의 전송버튼을 누르면 저장되도록 해보겠다.

hello.servlet.web.servlet.MemberSaveServlet를 다음과 같이 생성한다.

// MemberSaveServlet.class
@WebServlet(name = "memberSaveServlet", urlPatterns = "/servlet/members/save")
public class MemberSaveServlet extends HttpServlet {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("MemberSaveServlet.service");
        String username = request.getParameter("username");
        int age = Integer.parseInt(request.getParameter("age"));

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

        response.setContentType("text/html");
        response.setCharacterEncoding("utf-8");
        PrintWriter w = response.getWriter();
        w.write("<html>\n" +
                "<head>\n" +
                " <meta charset=\"UTF-8\">\n" +
                "</head>\n" +
                "<body>\n" +
                "성공\n" +
                "<ul>\n" +
                " <li>id="+member.getId()+"</li>\n" +
                " <li>username="+member.getUsername()+"</li>\n" +
                " <li>age="+member.getAge()+"</li>\n" +
                "</ul>\n" +
                "<a href=\"/index.html\">메인</a>\n" +
                "</body>\n" +
                "</html>");
    }
}

프로그램 실행 후 http://localhost:8080/servlet/members/new-form에 접속하여 폼을 채우고 전송 버튼을 누르면 다음과 같이 회원 등록이 완료되었음을 확인할 수 있다.

4. MemberListServlet - 회원 목록

마지막으로 저장한 모든 회원들을 조회하는 기능을 만들어보겠다.

hello.servlet.web.servlet.MemberListServlet을 다음과 같이 생성한다.

// MemberListServlet.class
@WebServlet(name = "memberListServlet", urlPatterns = "/servlet/members")
public class MemberListServlet extends HttpServlet {

    private MemberRepository memberRepository = MemberRepository.getInstance();

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

        List<Member> members = memberRepository.findAll(); // 전체 회원 조회

        response.setContentType("text/html");
        response.setCharacterEncoding("utf-8");

        PrintWriter w = response.getWriter();
        w.write("<html>");
        w.write("<head>");
        w.write(" <meta charset=\"UTF-8\">");
        w.write(" <title>Title</title>");
        w.write("</head>");
        w.write("<body>");
        w.write("<a href=\"/index.html\">메인</a>");
        w.write("<table>");
        w.write(" <thead>");
        w.write(" <th>id</th>");
        w.write(" <th>username</th>");
        w.write(" <th>age</th>");
        w.write(" </thead>");
        w.write(" <tbody>");
        /*
        w.write(" <tr>");
        w.write(" <td>1</td>");
        w.write(" <td>userA</td>");
        w.write(" <td>10</td>");
        w.write(" </tr>");
        */
        for (Member member : members) { // for문을 사용해 회원 수만큼 반복하여 응답을 생성
            w.write(" <tr>");
            w.write(" <td>" + member.getId() + "</td>");
            w.write(" <td>" + member.getUsername() + "</td>");
            w.write(" <td>" + member.getAge() + "</td>");
            w.write(" </tr>");
        }
        w.write(" </tbody>");
        w.write("</table>");
        w.write("</body>");
        w.write("</html>");
    }
}

회원 등록 폼을 사용해 회원들을 저장한 후에 http://localhost:8080/servlet/members/new-form에 접속하면 다음과 같이 모든 회원들을 확인할 수 있다.

5. 서블릿에서 템플릿 엔진으로

서블릿을 활용하여 위와 같이 동적으로 회원 수에 따라 화면이 달라질 수 있는 동적인 HTML을 만들어보았다.

하지만 위의 코드에서 볼 수 있듯이 상당히 복잡하고 비효율적인 작업을 계속해야 한다.

만약 HTML 문서에 동적으로 처리해야 하는 부분만 자바 코드를 사용할 수 있다면 상당히 편리할 것이다. 이런 것을 가능하게 해주는 것이 바로 템플릿 엔진이다.

대표적으로 JSP, Thymeleaf, Freemarker, Velocity 등이 존재하는데 현재는 JSP는 다른 템플릿 엔진에 밀려서 잘 사용하지 않는 추세라고 한다.

6. Welcome 페이지 변경

저번 챕터에서 만들었던 Welcome 페이지(index.html)를 앞으로도 계속 편리하게 사용하기 위해 다음과 같이 변경한다.

<!--index.html-->
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<ul>
    <li><a href="basic.html">서블릿 basic</a></li>
    <li>서블릿
        <ul>
            <li><a href="/servlet/members/new-form">회원가입</a></li>
            <li><a href="/servlet/members">회원목록</a></li>
        </ul>
    </li>
    <li>JSP
        <ul>
            <li><a href="/jsp/members/new-form.jsp">회원가입</a></li>
            <li><a href="/jsp/members.jsp">회원목록</a></li>
        </ul>
    </li>
    <li>서블릿 MVC
        <ul>
            <li><a href="/servlet-mvc/members/new-form">회원가입</a></li>
            <li><a href="/servlet-mvc/members">회원목록</a></li>
        </ul>
    </li>
    <li>FrontController - v1
        <ul>
            <li><a href="/front-controller/v1/members/new-form">회원가입</a></li>
            <li><a href="/front-controller/v1/members">회원목록</a></li>
        </ul>
    </li>
    <li>FrontController - v2
        <ul>
            <li><a href="/front-controller/v2/members/new-form">회원가입</a></li>
            <li><a href="/front-controller/v2/members">회원목록</a></li>
        </ul>
    </li>
    <li>FrontController - v3
        <ul>
            <li><a href="/front-controller/v3/members/new-form">회원가입</a></li>
            <li><a href="/front-controller/v3/members">회원목록</a></li>
        </ul>
    </li>
    <li>FrontController - v4
        <ul>
            <li><a href="/front-controller/v4/members/new-form">회원가입</a></li>
            <li><a href="/front-controller/v4/members">회원목록</a></li>
        </ul>
    </li>
    <li>FrontController - v5 - v3
        <ul>
            <li><a href="/front-controller/v5/v3/members/new-form">회원가입</a></li>
            <li><a href="/front-controller/v5/v3/members">회원목록</a></li>
        </ul>
    </li>
    <li>FrontController - v5 - v4
        <ul>
            <li><a href="/front-controller/v5/v4/members/new-form">회원가입</a></li>
            <li><a href="/front-controller/v5/v4/members">회원목록</a></li>
        </ul>
    </li>
    <li>SpringMVC - v1
        <ul>
            <li><a href="/springmvc/v1/members/new-form">회원가입</a></li>
            <li><a href="/springmvc/v1/members">회원목록</a></li>
        </ul>
    </li>
    <li>SpringMVC - v2
        <ul>
            <li><a href="/springmvc/v2/members/new-form">회원가입</a></li>
            <li><a href="/springmvc/v2/members">회원목록</a></li>
        </ul>
    </li>
    <li>SpringMVC - v3
        <ul>
            <li><a href="/springmvc/v3/members/new-form">회원가입</a></li>
            <li><a href="/springmvc/v3/members">회원목록</a></li>
        </ul>
    </li>
</ul>
</body>
</html>

JSP로 회원 관리 웹 애플리케이션 만들기

1. JSP 라이브러리 추가

JSP를 사용하기 위해 build.gradle에 JSP 라이브러리를 추가한다.

implementation 'org.apache.tomcat.embed:tomcat-embed-jasper'
implementation 'javax.servlet:jstl'

이후 Gradle refresh를 진행한다.

2. 회원 등록 폼 JSP

회원 등록을 위한 JSP 파일을 만들어 보겠다.

main/webapp/jsp/members/new-form.jsp을 다음과 같이 생성한다.

// new-form.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<form action="/jsp/members/save.jsp" method="post">
    username: <input type="text" name="username" />
    age: <input type="text" name="age" />
    <button type="submit">전송</button>
</form>
</body>
</html>

둘째 줄 <%@ page contentType="text/html;charset=UTF-8" language="java" %>은 이 파일이 JSP 문서라는 뜻이다. JSP 문서는 이처럼 시작해야 한다.

※ JSP는 서버 내부에서 서블릿으로 변환된다.

프로그램 실행 후에 http://localhost:8080/jsp/members/new-form.jsp에 접속하면 위에서 서블릿을 사용해 만들었던 회원 등록 폼과 동일한 것을 확인할 수 있다.

3. 회원 저장 JSP

다음으로 회원 저장을 위한 JSP 파일을 만들어보자.

main/webapp/jsp/members/save.jsp을 다음과 같이 생성한다.

// save.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ page import="hello.servlet.domain.member.Member" %> // jsp의 import문
<%@ page import="hello.servlet.domain.member.MemberRepository" %>
<%
  // request, response 사용 가능 (JSP도 Servlet으로 자동 변경)
  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>

위와 같이 JSP 파일은 HTML 코드를 중심으로 하고, 자바 코드들을 필요한 부분마다 입력할 수 있다.

4. 회원 목록 JSP

마지막으로 저장한 모든 회원들을 조회하는 기능을 만들어보겠다.

main/webapp/jsp/members.jsp 파일을 다음과 같이 생성한다.

// members.jsp
<%@ page import="java.util.List" %>
<%@ page import="hello.servlet.domain.member.MemberRepository" %>
<%@ page import="hello.servlet.domain.member.Member" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%
  MemberRepository memberRepository = MemberRepository.getInstance();
  List<Member> members = memberRepository.findAll();
%>
<html>
<head>
  <meta charset="UTF-8">
  <title>Title</title>
</head>
<body>
<a href="/index.html">메인</a>
<table>
  <thead>
  <th>id</th>
  <th>username</th>
  <th>age</th>
  </thead>
  <tbody>
  <%
    for (Member member : members) {
      out.write(" <tr>");
      out.write(" <td>" + member.getId() + "</td>");
      out.write(" <td>" + member.getUsername() + "</td>");
      out.write(" <td>" + member.getAge() + "</td>");
      out.write(" </tr>");
    }
  %>
  </tbody>
</table>
</body>
</html>

JSP 파일 초반부에 자바 코드 부분을 통해 회원 리포지토리를 전체 조회하고, 결과 List값과 <tr>, <td>를 사용해서 테이블 형식으로 결과 값을 보여주었다.

이는 위에서 서블릿을 활용해 전체 회원 리스트를 보여주었을 때와 동일한 형태이며, http://localhost:8080/jsp/members.jsp에 접속해 보면 확인할 수 있다.

5. 서블릿과 JSP의 한계

지금까지 서블릿과 JSP를 활용하여 간단한 웹 애플리케이션을 개발해 보았다.

서블릿으로 개발할 때에는 View를 위한 HTML 파일을 만드는 작업들이 자바 코드에 섞여서 지저분하고 복잡했다.

반면 JSP를 사용할 때에는 HTML 파일을 중심으로 동적으로 변경이 필요한 부분만 자바 코드를 사용하여 좀 더 깔끔하게 개발이 가능했다.

하지만 JSP에도 몇 가지 어려움들이 존재한다.

JSP 코드를 자세히 들여다보면 자바 코드, 데이터를 조회하는 리포지토리 등 다양한 코드가 모두 JSP에 노출되어 있다.
JSP가 너무 많은 역할을 하는 것이다.

이렇게 간단한 웹 프로젝트도 벌써 복잡하다고 느껴지는데, 수천 줄이 넘어가는 거대한 프로젝트를 위한 JSP 파일을 만들고, 이를 사용해야 한다면 상당한 어려움이 있을 것이다.

그렇기 때문에 이들의 한계를 극복하기 위해 우리는 MVC 패턴을 사용해야 한다. 과거 개발자들도 모두 비슷한 고민이 있었고, 그래서 MVC 패턴이 등장했다.

MVC 패턴 - 개요

1. MVC 패턴의 등장

MVC 패턴은 다음과 같은 한계점을 극복하기 위해 등장했다.

너무 많은 역할 : 하나의 서블릿이나 JSP로 비즈니스 로직과 뷰 렌더링까지 모두 처리하게 되면, 너무 많은 역할을 하게 되고, 결과적으로 유지보수가 어려워진다. 비즈니스 로직을 호출하는 부분에 변경이 발생해도, UI를 변경할 일이 있어도 함께 있는 파일을 수정해야 한다.
변경의 라이프 사이클 : 비즈니스 로직과 뷰 로직 사이의 변경의 라이프 사이클이 다르다는 점이다. UI를 일부 수정하는 일과 비즈니스 로직을 수정하는 일은 각각 다르게 발생할 가능성이 매우 높고 대부분 서로에게 영향을 주지 않는다. 이렇게 변경의 라이프 사이클이 다른 부분을 하나의 코드로 관리하는 것은 유지보수하기 좋지 않다.
기능 특화 : JSP 같은 뷰 템플릿은 화면을 렌더링 하는데 최적화되어 있기 때문에 이 부분의 업무만 담당하는 것이
가장 효과적이다.

2. Model, View, Controller
MVC 패턴은 하나의 서블릿이나, JSP로 몰아서 처리하던 작업하던 방식 대신에 Controller와 View라는 영역으로 서로 역할을 나누어 작업들을 처리하는 것을 말한다. 웹 애플리케이션은 보통 이 MVC 패턴을 사용한다.

각각의 역할은 다음과 같다.

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

모델 : 뷰에 출력할 데이터를 담아둔다. 뷰가 필요한 데이터를 모두 모델에 담아서 전달해 주기에 뷰는 비즈니스 로직이나 데이터 접근을 몰라도 되고, 화면을 렌더링 하는 일에만 집중할 수 있다.
뷰 : 모델에 담겨있는 데이터를 사용해서 화면을 그리는 일에 집중한다. 여기서는 HTML을 생성하는 부분을 말한다.

※ 컨트롤러에 비즈니스 로직을 둘 수도 있지만, 이렇게 되면 컨트롤러가 너무 많은 역할을 담당한다. 그래서 일반적으로 비즈니스 로직은 Service 계층을 별도로 만들어서 처리한다. 그리고 컨트롤러는 비즈니스 로직이 있는 서비스를 호출하는 역할을 담당한다.

3. MVC 패턴을 적용한 웹 애플리케이션의 실행 과정

1. 클라이언트가 컨트롤러에 특정 작업을 요청한다.

2. 컨트롤러가 비즈니스 계층에 요청하여 비즈니스 로직을 호출한다.

3. 모델에 뷰가 사용할 데이터가 전달된다.

4. 컨트롤러가 요청된 정보들을 모두 모델에 전달하였으면 뷰에서 화면을 그린다.

5. 뷰가 사용할 데이터들을 모델에서 참조한다.

6. 클라이언트에 뷰가 그린 화면을 띄운다.

MVC 패턴 - 적용

서블릿을 컨트롤러로, JSP를 뷰로, HttpServletRequest 객체를 모델로 사용하여 MVC 패턴을 적용해 보자.

request.setAttribute(), request.getAttribute()를 사용하면 request 내부의 저장소를 활용하여 데이터를 보관하고, 조회할 수 있다.

1. 회원 등록

1-1. 회원 등록 폼

hello.servlet.web.servletmvc.MvcMemberFormServlet을 다음과 같이 생성한다.

// MvcMemberFormServlet.class
@WebServlet(name = "mvcMemberFormServlet", urlPatterns = "/servlet-mvc/members/new-form")
public class MvcMemberFormServlet extends HttpServlet {
    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        String viewPath = "/WEB-INF/views/new-form.jsp";
        RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
        dispatcher.forward(request, response);
    }
}

dispatcher.forward() : 다른 서블릿이나 JSP로 이동할 수 있는 기능이다. 서버 내부에서 호출이 발생한다.

/WEB-INF : 이 경로 안에 JSP가 위치하면 외부에서 직접 JSP파일을 호출할 수 없다. 내부에서 호출을 해줘야 한다.

redirect vs forward : 리다이렉트는 클라이언트에 응답이 나갔다가, 클라이언트가 redirect 경로로 다시 요청한다.

따라서 경로 변경을 클라이언트가 인지할 수 있고, 실제로도 변경된다.

반면에 포워드는 서버 내부에서 일어나는 호출이기 때문에 클라이언트가 전혀 인지하지 못한다.

1-2. 회원 등록 폼 - 뷰

main/webapp/WEB-INF/views/new-form.jsp를 생성한다.

// new-form.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>

<form action = "save" ~>를 보면 경로를 절대 경로(/save)가 아닌 상대 경로로 지정한 것을 확인할 수 있다.

위처럼 상대 경로로 설정하면 폼 전송 시에 현재 "URL이 속한 경로 + save"가 호출된다.

http://localhost:8080/servlet-mvc/members/new-form에 접속하여 보면 HTML Form이 이전처럼 잘 나타나는 것을 확인할 수 있다.

2. 회원 저장

2-1. 회원 저장 - 컨트롤러

hello.servlet.web.servletmvc.MvcMemberSaveServlet을 다음과 같이 생성한다.

// MvcMemberSaveServlet.class
@WebServlet(name = "mvcMemberSaveServlet", urlPatterns = "/servlet-mvc/members/save")
public class MvcMemberSaveServlet extends HttpServlet {

    MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    protected void service(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);
    }
}

HttpServletRequest를 Model로 사용한다.
request가 제공하는 setAttribute()를 사용하면 request 객체에 데이터를 보관해서 뷰에 전달할 수 있다.
뷰에 전달된 데이터는 request.getAttribute()를 사용해서 뷰가 꺼내면 된다.

2.2. 회원 저장 - 뷰

main/webapp/WEB-INF/views/save-result.jsp를 다음과 같이 생성한다.

// save-result.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>

이전의 방법과 비슷하게 <%=%>를 사용하여 모델에 저장한 member 객체를 꺼낼 수 있지만, 너무 복잡해진다.
JSP는 ${} 문법을 제공하는데, 이를 사용하면 request의 attribute에 담긴 데이터를 편리하게 조회할 수 있다.

http://localhost:8080/servlet-mvc/members/new-form에 접속하여 HTML Form에 데이터를 입력하고 전송을 누르면 이전과 동일한 저장 결과를 확인할 수 있다.

컨트롤러 로직과 뷰 로직을 확실하게 구분한 것을 확인할 수 있다. 이제부터 화면에 수정이 생기면 뷰 로직만 수정하면 된다.

3. 회원 목록 조회

3-1. 회원 목록 조회 - 컨트롤러

hello.servlet.web.servletmvc.MvcMemberListServlet을 다음과 같이 생성한다.

// MvcMemberListServlet.class
@WebServlet(name = "mvcMemberListServlet", urlPatterns = "/servlet-mvc/members")
public class MvcMemberListServlet extends HttpServlet {

    MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    protected void service(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);
    }
}

여기서도 request 객체를 모델로 사용해서 List<Member> members를 보관했다.

2.2. 회원 저장 - 뷰

main/webapp/WEB-INF/views/members.jsp를 다음과 같이 생성한다.

// members.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<html>
<head>
  <meta charset="UTF-8">
  <title>Title</title>
</head>
<body>
<a href="/index.html">메인</a>
<table>
  <thead>
  <th>id</th>
  <th>username</th>
  <th>age</th>
  </thead>
  <tbody>
  <c:forEach var="item" items="${members}">
    <tr>
      <td>${item.id}</td>
      <td>${item.username}</td>
      <td>${item.age}</td>
    </tr>
  </c:forEach>
  </tbody>
</table>
</body>
</html>

JSP가 제공하는 taglib기능을 사용해서 members 리스트에서 member를 순서대로 꺼내서 item 변수에 담고, 출력하는 과정을 반복한다.

<c:forEach> 이 기능을 사용하려면 <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>를 선언해야 한다.

이처럼 JSP와 같은 뷰 템플릿들은 화면을 렌더링 하는데 특화된 다양한 기능들을 제공한다.

회원가입 진행 후 http://localhost:8080/servlet-mvc/members에 접속하면 이전과 동일하게 저장된 결과 목록을 확인할 수 있다.

MVC 패턴 - 한계

MVC 패턴을 적용하여서 우리는 컨트롤러의 역할과 뷰의 역할을 명확하게 구분할 수 있었다.
뷰는 화면을 그리는 역할에만 충실한 덕분에 코드가 깔끔하고 직관적이다. 반면에 컨트롤러는 중복이 많고 필요하지 않은 코드들도 많다.

다음과 같은 컨트롤러의 단점들이 존재한다.

1. 포워드 중복

포워드로 이동하는 다음의 코드가 항상 중복되어 호출되어야 한다.

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

2. ViewPath의 중복

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

앞부분의 "/WEB-INF/views/"와 뒷부분의 ". jsp"가 항상 중복되어 나타나기에 나중에 폴더를 변경하거나 JSP에서 Thymeleaf 등의 다른 뷰 템플릿으로 변경할 상황이 생기면 하나하나 변경해야 할 것이다.

3. 사용하지 않는 코드

다음의 코드는 사용할 때도 사용하지 않을 때도 있으며, 특히 response의 경우에는 전혀 사용되지 않았다.

HttpServletRequest request, HttpServletResponse response

그리고 HttpServletRequest, HttpServletResponse를 사용하는 경우에는 테스트 케이스 작성도 어렵다.

4. 공통 처리의 어려움

기능이 복잡해질수록 컨트롤러에서 공통으로 처리해야 하는 부분이 점점 더 많이 증가할 것이다.

단순히 공통 기능을 메서드로 뽑으면 될 것 같지만, 결과적으로 해당 메서드를 항상 호출해야 하며 실수로 호출이라도 하지
않으면 문제가 된다. 그리고 호출하는 행위 자체도 중복으로 이뤄진다.

위의 네 가지 문제를 해결하기 위해서 우리는 컨트롤러 호출 전에 먼저 공통 기능을 처리해 주면 된다.

이는 소위 수문장 역할을 하는 프론트 컨트롤러 패턴을 도입함으로써 깔끔하게 해결할 수 있다.

스프링 MVC의 핵심도 바로 프론트 컨트롤러에 있다고 한다.

'개발 > 스프링 MVC' 카테고리의 다른 글

(스프링 MVC 1편) 2. 서블릿 (0)	2023.03.10
(스프링 MVC 1편) 1. 웹 애플리케이션 이해 (0)	2023.03.05