스프링 MVC - (서블릿, JSP, MVC 패턴)

voidmelody·2022년 10월 5일
0

출처 : https://inf.run/fyCX
해당 강의를 유료구매 및 수강 후 개인 기록용으로 포스팅한 글입니다.

핵심적이고 기억해야할 부분들 위주로만 기록해보자.

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

먼저 서블릿으로 어떤 회원 등록폼을 만들어본다 가정하자.
MemberFormServlet

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

어떤가. 딱 봐도 뭔가 불편한 느낌이 든다.
저 w.write()부분에 진짜 html들을 일일이 \n을 하면서 넣어줘야한다는 부분이 너무나 고통스럽다.

이번엔 회원 저장폼을 만들어보자.
MemberSaveServlet

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

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @Override
    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("MembersSaveServlet.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>");

    }
}

동작원리는 심플하다.
파라미터를 조회해서 Member객체를 만들고
그 객체를 memberRepository에 저장하고
그 객체를 html로 넣어주었다.

이번엔 회원 목록을 만들어보자.

@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) {
            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>");
    }
}

memberRepository에 findAll()로 모든 회원을 저장하고
html에 for루프를 통해서 동적 생성하고 응답하고 있다.

지금 딱 서블릿을 써봤을 때 느껴지는 점은 기능들은 자바로 구현하기 편한데 일일이 html을 넣어주는 게 너무나 불편하다.

이번엔 JSP로 만들어보자.

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

우선 jsp를 사용하려면 build.gradle에 다음 코드를 추가해야한다.

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

서블릿 때 했던 것처럼 하나씩 만들어보자.
우선 회원 등록 폼을 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 문서는 처음에 이렇게 시작해야한다.
완전히 HTML과 똑같이 보인다.
JSP는 서버 내부에서 서블릿으로 변환된다.
이번엔 저장폼을 만들어보자.

<%@ page import="hello.servlet.domain.member.MemberRepository" %>
<%@ page import="hello.servlet.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>

JSP는 자바 코드를 그대로 사용할 수 있다.
<% ~~ %> 부분에 자바 코드를 입력할 수 있고
<%= ~~ %> 부분에 자바 코드를 출력할 수 있다.
특징은 HTML을 중심으로 하고 자바 코드를 부분부분 입력해주었다.

회원 목록 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의 한계

서블릿으로 개발할 때는 뷰(view) 화면을 위한 HTML을 만드는 작업이 자바 코드에 섞여서 지저분하고 복잡했다.
JSP를 사용한 덕분에 뷰를 생성하는 HTML 작업을 깔끔하게 가져가고,
중간중간 동적으로 변경이 필요한 부분에만 자바 코드를 적용했다.
그런데 이렇게 해도 해결되지 않는 몇가지 고민이 남는다.

JSP들을 보면 코드 절반은 비즈니스 로직이고 나머지 절반은 결과를 HTML로 보여주기 위한 뷰 영역이다.

코드를 보면 JAVA 코드, 데이터를 조회하는 Repository 등 다양한 코드가 모두 JSP에 들어가있다.
즉, JSP 파일 하나에 너무 많은 역할을 한다.

비즈니스 로직은 서블릿처럼 다른 곳에서 처리하고, JSP는 목적에 맞게 HTML로 화면을 그리는 역할(view)만 하도록 해보자.
그리고 이 패턴을 MVC패턴이라 한다.

MVC 패턴 - 개요

  • 너무 많은 역할
    하나의 서블릿이나 JSP만으로 비즈니스 로직과 뷰 렌더링까지 모두 처리하게 하면 너무나 많은 역할을 하게 된다. 그렇게 되다보면 유지보수가 어려울 수 밖에 없다.
    비즈니스 로직을 변경하든 UI를 변경하든 그 파일 하나에 다 가서 수정해야한다.

  • 변경 라이프 사이클
    UI를 일부 수정하는 일과 비즈니스 로직을 수정하는 일은 각각 다르게 발생할 가능성이 매우 높고
    서로에게 영향을 주지 않는다.
    이렇게 변경 라이프 사이클이 다른 부분을 하나의 코드로 관리하는 것은 유지보수에 적합하지 않다.

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

Model View Controller

MVC패턴은 이제 컨트롤러(Controller)와 뷰(View)라는 영역으로 서로 역할을 나눈 것이다.

  • 컨트롤러 : HTTP 요청을 받아서 Parameter를 검증하고, 비즈니스 로직을 실행한다.
    그리고 뷰에 전달할 결과 데이터를 조회해서 모델에 넣는다.
    엄밀히 말하면, 컨트롤러에 비즈니스 로직을 둘 수도 있지만, 그렇게 되면 컨트롤러가 너무 많은 역할을 담당한다.
    그래서 비즈니스 로직은 서비스(Service)라는 계층을 별도로 만들어서 처리한다.

  • 모델 : 뷰에 출력할 데이터를 담아둔다.
    뷰가 필요한 데이터는 모두 모델이 담아주기 때문에 뷰는 비즈니스 로직이나 데이터 접근을 몰라도 그냥 화면을 렌더링하는 일에만 집중하면 된다.

  • 뷰 : 모델에 담겨있는 데이터를 사용해서 화면을 그리는 일에 집중한다.
    HTML이 해당.

    그림이 허접하지만 직관적으로 이해해보자..

MVC 패턴 - 적용

서블릿을 컨트롤러로, JSP를 뷰로 사용해서 mvc 패턴을 적용해보자.
Model은 HttpServletRequest 객체를 사용한다.
request는 내부에 데이터 저장소를 가지고 있기 때문에
request.setAttribute(), request.getAttribute()를 사용하면 데이터를 넣고 조회할 수 있다.

<회원 등록 폼 - 컨트롤러>

@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로 이동할 수 있는 기능이다. 이 때 중요하게 생각해야할 지점은 서버 내부에서 다시 호출이 일어난다는 것이다.

redirect vs forward

리다이렉트는 실제 클라이언트에 응답이 나갔다가 클라이언트가 redirect 경로로 다시 요청하기 때문에 클라이언트가 인지할 수 있고 URL 경로도 실제로 변경이 된다.
하지만 forward의 경우 서버 내부에서 일어나기 때문에 클라이언트는 인지할 수 없다.
URL 경로가 바뀌는 것도 아니고.

  • /WEB-INF : 해당 패키지 경로 안에 JSP가 있으면 외부에서 JSP를 링크로 호출할 수 없다.
    이걸 이렇게 하는 이유는 항상 컨트롤러만 통해서 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>

절대 경로 vs 상대 경로

해당 코드에서 form의 action을 보면 절대경로(/로 시작)이 아닌 상대경로(/가 시작이 아님)인 것을 확인할 수 있다. 이렇게 상대경로를 설정하게 되면 폼 전송 시 현재 URL이 속한 계층 경로 + save가 호출된다.
예를 들어 지금 컨트롤러의 url이 "/servlet-mvc/members/new-form"이다.
여기서 해당 action이 실행되면 new-form 대신에 save로 바뀌면서
/servlet-mvc/members/save로 가게 될 것이다.
보통 현업에선 절대경로를 사용하는 것이 훨씬 많다..
지금 상황에선 앞으로 url들이 바뀌어도 save에 해당되는 jsp를 계속 호출할 것이기 때문에 상대경로를 사용했다. 계속 새로 만들때마다 jsp의 url을 변경하는 것이 귀찮으므로..

<회원 저장 - 컨트롤러>

@WebServlet(name = "mvcMemberSaveServlet", urlPatterns = "/servlet-mvc/members/save")
public class MvcMemberSaveServlet extends HttpServlet {
    private 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로 사용하고 있다.
setAttribute()로 request객체에 데이터를 보관하고
getAttribute()로 뷰는 데이터를 꺼내면 된다.

<회원 목록 조회 - 컨트롤러>

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

    private 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객체에다 members를 모델에 보관했다.

MVC 패턴 - 한계

MVC 패턴을 적용한 덕분에 컨트롤러의 역할과 뷰를 렌더링 하는 역할을 명확하게 구분할 수 있다.
뷰의 경우 화면을 그리는 역할에 충실한 덕분에 코드가 깔끔하고 직관적이다
그냥 단순히 모델에서 필요한 데이터를 꺼내서, 화면을 만들면 된다.

하지만 컨트롤러의 경우 중복이 많고, 필요하지 않는 코드들이 보인다.

  • forward 중복
    view로 이동하는 코드가 항상 중복 호출이 발생하고 있다.
    물론 이 부분을 그냥 메서드로 묶어도 되지만 결국엔 또 이 메서드를 직접 호출해야한다.
RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
dispatcher.forward(request,response);
  • ViewPath 중복
String viewPath = "/WEB-INF/views/new-form.jsp";

/WEB-INF/views 부분과 .jsp부분은 계속 항상 똑같다.
또 지금은 JSP를 사용하고 있지만 thymeleaf 같은 다른 템플릿을 사용하게 된다면 모든 코드를 다 변경해야 한다.

  • 사용하지 않는 코드
HttpServletRequest request, HttpServletResponse response

response의 경우 현재 코드에선 전혀 사용하고 있지 않다.
하지만 forward에 넣어줘야한다..
그리고 HttpServletRequest, HttpServletResponse를 사용하는 코드는 테스트 케이스를 작성하기 어렵다.

결론은 해당 문제들이 있고 이러한 문제들을 해결하려면 컨트롤러 호출 전에 먼저 공통 기능을 처리해야한다. 즉, 수문장 역할이 필요하다.
프론트 컨트롤러(Front Controller)패턴을 도입하면 해당 문제를 해결할 수 있다.
즉, 입구를 하나로 만드는 것이다.

profile
voidmelody
어제보다 오늘 더 나은 삶을 위해
이전 포스트

스프링 핵심 원리 - 기본편 복습 3편

다음 포스트

스프링 MVC - MVC 프레임워크 만들기(v1~v4).

0개의 댓글