Spring/MVC

[Spring MVC] 03. 서블릿, JSP, MVC 패턴

lumana 2024. 11. 19. 21:07

 

03. 서블릿, JSP, MVC 패턴

#Spring/MVC



1. 서블릿으로 HTML 동적으로 제공하기

서블릿으로 회원 등록 HTML 폼을 제공

response.setContentType("text/html");
response.setCharacterEncoding("utf-8");
PrintWriter w = response.getWriter();
w.write("<head>")
...

자바 코드로 HTML을 제공해야 하므로 쉽지 않은 작업이다. 너무 불편하다


회원 데이터가 저장

memberRepository.save(member);
response.setContentType("text/html");
response.setCharacterEncoding("utf-8");
PrintWriter w = response.getWriter();
... // 저장 결과 페이지를 동적으로 만들어서 응답한다.

회원 목록 조회

List<Member> members = memberRepository.findAll();
response.setContentType("text/html");
response.setCharacterEncoding("utf-8");
PrintWriter w = response.getWriter();
... // 회원 목록 페이지를 동적으로 만들어서 응답한다.
		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>"); 
		}
...

회원 목록 HTML을 for 루프를 통해서 회원 수 만큼 동적으로 생성하고 응답한다.


코드에서 보듯이 이것은 매우 복잡하고 비효율적이다. 자바 코드에 HTML을 넣는 것 보다는 HTML 문서에 동적으로 변경해야 하는 부분만 자바 코드를 넣어보자 템플릿 엔진의 등장


템플릿 엔진 : JSP, Thymeleaf, Freemarker, Velocity 등이 있다.


2. JSP


회원 등록 폼 JSP

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
...
<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>

  • <%@ page contentType="text/html;charset=UTF-8" language="java" %>
    • 첫 줄은 JSP 문서라는 뜻이다. JSP 문서는 이렇게 시작해야 한다.
  • 회원 등록 폼 JSP를 보면 첫 줄을 제외하고는 완전히 HTML과 똑같다. JSP는 서버 내부에서 서블릿으로 변환되는데, 우리가 만들었던 MemberFormServlet과 거의 비슷한 모습으로 변환된다.

회원 저장 JSP

<%@ page import="hello.servlet.domain.member.MemberRepository" %>
<%@ page import="hello.servlet.domain.member.Member" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
...
Member member = new Member(username, age);
memberRepository.save(member);
...

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

  • JSP는 자바 코드를 그대로 다 사용할 수 있다.
  • <%@ page import="hello.servlet.domain.member.MemberRepository" %>
    • 자바의 import 문과 같다.
  • <% ~~ %>
    • 이 부분에는 자바 코드를 입력할 수 있다.
    • 비즈니스 로직을 넣으려면 이 표시를 넣어야 한다.
  • <%= ~~ %>
    • 이 부분에는 자바 코드를 출력할 수 있다.

꺽쇠 표시가 없으면 w.println()으로 찍는 것과 같다.


회원 목록

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

...
		<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>
...

서블릿과 JSP의 한계
JSP 상단을 보면 비즈니스 로직 처리를 위한 코드가 상위 절반을 차지하고, 나머지 하위 절반만 HTML로 보여주기 위한 영역이다.
코드를 잘 보면, 데이터 조회 등의 자바 코드가 JSP에 노출되어 있다. JSP가 너무 많은 일을 하는 것이다.


3. MVC 패턴 적용

하나의 서블릿이나 JSP만으로 비즈니스 로직과 뷰 렌더링까지 모두 처리하게 되면, 너무 많은 역할을 하게 되고, 결과적으로 유지보수가 어려워진다.
그리고 진짜 문제는 둘 사이에 변경의 라이프 사이클이 다르다는 점이다.


Model View Controller
하나의 서블릿이나 JSP로 처리하던 것을 컨트롤러(Controller)와 뷰(View)라는 영역으로 서로 역할을 나눈 것


  • 컨트롤러:
    HTTP 요청을 받아서 파라미터를 검증하고, 비즈니스 로직을 실행한다.
    그리고 뷰에 전달할 결과 데이터를 조회해서 모델에 담는다.
  • 모델:
    뷰에 출력할 데이터를 담아둔다.
    뷰가 필요한 데이터를 모두 모델에 담아서 전달해주는 덕분에 뷰는 비즈니스 로직이나 데이터 접근을 몰라도 되고, 화면을 렌더링 하는 일에 집중할 수 있다.
  • :
    모델에 담겨있는 데이터를 사용해서 화면을 그리는 일에 집중한다.
    여기서는 HTML을 생성하는 부분을 말한다.

참고

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



서블릿을 컨트롤러로 사용하고, JSP를 뷰로 사용해서 MVC 패턴을 적용해보자. Model은 HttpServletRequest 객체를 사용한다.


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


회원 등록 폼 컨트롤러

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

request.getRequestDispatcher() : 컨트롤러에서 뷰로 이동할 때 dispatcher가 필요해서 가져오는 것


  • dispatcher.forward() : 서블릿에서 다른 서블릿이나 JSP로 이동할 수 있는 기능이다. 서버 내부에서 다시 호출이 발생한다.
    • 클라이언트를 거치는게 아님. 리다이렉트가 아니다. 서버 안에서 자기들끼리 JSP 호출하고 렌더링하고 내려준 것이다.
  • /WEB-INF
    이 경로 안에 JSP가 있으면 외부에서 직접 JSP를 호출할 수 없다. 우리가 기대하는 것은 항상 컨트롤러를 통해서 JSP를 호출하는 것이다.

리다이렉트:
실제 클라이언트(웹 브라우저)에 응답이 나갔다가, 클라이언트가 redirect 경로로 다시 요청한다.
따라서 클라이언트가 인지할 수 있고, URL 경로도 실제로 변경된다.

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


회원 등록 폼 - 뷰

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

이렇게 상대경로를 사용하면 폼 전송 시 현재 URL이 속한 계층 경로 + save가 호출된다.
만약 절대경로로 /save로 하면 말 그대로 /save 가 호출된다.
보통은 절대 경로로 해주는 것이 좋다. jsp를 다른 곳에서 사용하기 위해서는 상대 경로를 유지해줘야 한다.


회원 저장 - 컨트롤러

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

request.setAttribute("member", member);

  • //Model에 데이터를 보관한다.
  • // request 저장소 내부에 Map 같은게 있어서 저장된다.
  • 뷰는 request.getAttribute()를 사용해서 데이터를 꺼내면 된다.

회원 저장 - 뷰

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
...
	<ul>
        <li>id=${member.id}</li>
        <li>username=${member.username}</li>
        <li>age=${member.age}</li>
    </ul>
...

기존대로라면
<%=((Member)request.getAttribute("member")).getId()%> 이런식으로 꺼내야 한다.
리턴타입이 Object라 다운캐스팅해서 꺼내야 하는 것이다.


  • <%= request.getAttribute("member")%>로 모델에 저장한 member 객체를 꺼낼 수 있지만, 너무 복잡해진다.
  • JSP는 ${} 문법을 제공하는데, 이 문법을 사용하면 requestattribute에 담긴 데이터를 편리하게 조회할 수 있다.

컨트롤러에서 뷰 로직이 완전히 분리되었고, 뷰에서 비즈니스 로직 등이 분리되었다. 향후 화면에 수정이 발생하면 뷰 로직만 변경하면 된다.


회원 목록 조회 컨트롤러

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

회원 목록 조회 - 뷰

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
...
		<tbody>
            <c:forEach var="item" items="${members}">
                <tr>
                    <td>${item.id}</td>
                    <td>${item.username}</td>
                    <td>${item.age}</td>
                </tr>
            </c:forEach>
        </tbody>
...

  • 모델에 담아둔 members를 JSP가 제공하는 taglib 기능을 사용해서 반복하면서 출력했다.
    members 리스트에서 member를 순서대로 꺼내서 item 변수에 담고, 출력하는 과정을 반복한다.
  • <c:forEach> 이 기능을 사용하려면 다음과 같이 선언해야 한다.
    <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
    

MVC 패턴의 한계


MVC 컨트롤러의 단점

  1. 포워드 중복
    • View로 이동하는 코드가 항상 중복 호출되어야 한다.
    • Thymeleaf 같은 다른 뷰로 변경한다면 전체 코드를 다 변경해야 한다.
  2. 사용하지 않는 코드
    • 특히 HttpServletResponse의 response 객체는 현재 코드에서 사용되지 않는다.
    • 이런 HttpServletRequest, HttpServletResponse를 사용하는 코드는 테스트 케이스를 작성하기도 어렵다.
  3. 공통 처리가 어렵다
    • 기능이 복잡해질수록 컨트롤러에서 공통으로 처리해야 하는 부분이 점점 더 많이 증가한다.
    • 공통 메서드로 추출해도 되지만, 호출 과정도 중복이고, 호출하는 것을 놓칠 수도 있다.

—> 공통 기능을 처리해주는, 수문장 역할을 하는 기능이 있어야 한다.
—> 프론트 컨트롤러(Front Controller) 패턴을 도입한다.


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

'Spring > MVC' 카테고리의 다른 글

[Spring MVC] 05. 스프링 MVC - 구조 이해  (0) 2024.11.21
[Spring MVC] 04. MVC 프레임워크 만들기  (0) 2024.11.20
[Spring MVC] 02. 서블릿  (0) 2024.11.19
[Spring MVC] 01. Web Application의 이해  (0) 2024.11.19
[Spring/입문] 07. AOP  (0) 2024.05.13