[스프링 MVC 1편]JSP, MVC 패턴

이민우·2023년 7월 28일

Spring Boot

목록 보기

9/20

JSP, MVC 패턴

JSP

jsp란?
JavaServer Pages 의 약자이며 HTML 코드에 JAVA 코드를 넣어 동적웹페이지를 생성하는 웹어플리케이션 도구이다. JSP 가 실행되면 자바 서블릿(Servlet) 으로 변환되며 웹 어플리케이션 서버에서 동작되면서 필요한 기능을 수행하고 그렇게 생성된 데이터를 웹페이지와 함께 클라이언트로 응답한다.

jsp 코드로 알아보기

jsp를 사용하려면 우선 라이브러리를 추가해야한다.
스프링 부트 3.0 미만
build.gradle 에 추가

//JSP 추가 시작
implementation 'org.apache.tomcat.embed:tomcat-embed-jasper'
implementation 'javax.servlet:jstl' //JSP 추가 끝

회원 등록 폼 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

<%@ 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는 자바 코드를 그대로 사용가능!

<%@ page import="hello.servlet.domain.member.MemberRepository" %>
자바의 import 문과 같다.
<% ~~ %>
이 부분에는 자바 코드를 입력할 수 있다.
<%= ~~ %>
이 부분에는 자바 코드를 출력할 수 있다.
${}
문법을 제공하는데, 이 문법을 사용하면 request의 attribute에 담긴 데이터를 편리하게 조회할 수 있다.

회원 저장 JSP를 보면, 회원 저장 서블릿 코드와 같다. 다른 점이 있다면, HTML을 중심으로 하고, 자바코드를 부분부분 입력해주었다. <% ~ %> 를 사용해서 HTML 중간에 자바 코드를 출력하고 있다.

서블릿과 jsp의 한계

서블릿으로 개발할 때는 뷰(View)화면을 위한 HTML을 만드는 작업이 자바 코드에 섞여서 지저분하고 복잡했다.
하지만 JSP를 사용한 덕분에 뷰를 생성하는 HTML 작업을 깔끔하게 가져가고, 중간중간 동적으로 변경이 필요한 부분에만 자바 코드를 적용했다. 그런데 이렇게 해도 해결되지 않는 몇가지 고민이 남는다.
회원 저장 JSP를 보자. 코드의 상위 절반은 회원을 저장하기 위한 비즈니스 로직이고, 나머지 하위 절반만 결과를 HTML로 보여주기 위한 뷰 영역이다. 회원 목록의 경우에도 마찬가지다.
코드를 잘 보면, JAVA 코드, 데이터를 조회하는 리포지토리 등등 다양한 코드가 모두 JSP에 노출되어 있다. JSP가 너무 많은 역할을 한다. 이렇게 작은 프로젝트도 벌써 머리가 아파오는데, 수백 수천줄이 넘어가는 JSP를 떠올려보면 정말 지옥과 같을 것이다. (유지보수 지옥 썰)

이러한 고민들로 부터 나온게 MVC 패턴이다

MVC 패턴

MVC 패턴이란 MVC 패턴은 코드의 재사용에 유용하며, 사용자 인터페이스와 응용 프로그램 개발에 소요되는 시간을 줄여주는 효과적인 설계 방식을 말합니다. 구성요소로는 Model, View, Controller가 있습니다.

MVC 패턴 구성요소

컨트롤러 : 데이터와 비즈니스 로직 사이의 상호동작을 관리한다. 모델과 뷰 사이에서 정보 교환을 할 수 있도록 연결시켜주는 역할
모델 : 핵심적인 비즈니스 로직을 담당하여 데이터베이스를 관리하는 부분
뷰 : 사용자에게 보여지는 화면

코드로 알아보기

JSP를 뷰로 사용해서 MVC 패턴을 적용해보자.
Model은 HttpServletRequest 객체를 사용한다. request는 내부에 데이터 저장소를 가지고 있는데, request.setAttribute() , request.getAttribute() 를 사용하면 데이터를 보관하고, 조회할 수 있다.

회원등록

회원 등록 폼 - 컨트롤러
hello.servlet.web.servletmvc.MvcMemberFormServlet

 @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를 호출할 수 없다. 우리가 기대하는 것은 항상 컨트롤러를 통해서 JSP를 호출하는 것이다.

redirect vs forward
리다이렉트는 실제 클라이언트(웹 브라우저)에 응답이 나갔다가, 클라이언트가 redirect 경로로 다시 요청한다.
따라서 클라이언트가 인지할 수 있고, URL 경로도 실제로 변경된다.
반면에 포워드는 서버 내부에서 일어나는 호출이기 때문에 클라이언트가 전혀 인지하지 못한다.

회원 저장

회원 저장 - 컨트롤러
MvcMemberSaveServlet

@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);
         	 System.out.println("member = " + member);
        	  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() 를 사용해서 데이터를 꺼내면 된다.

회원 목록 조회

회원 목록 조회 - 컨트롤러
MvcMemberListServlet

@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 {
          System.out.println("MvcMemberListServlet.service");
          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 members 를 모델에 보관했다.

MVC 패턴의 한계

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

MVC 컨트롤러 단점

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

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

ViewPath에 중복

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

공통 처리가 어렵다.
기능이 복잡해질 수 록 컨트롤러에서 공통으로 처리해야 하는 부분이 점점 더 많이 증가할 것이다. 단순히 공통 기능을 메서드로 뽑으면 될 것 같지만, 결과적으로 해당 메서드를 항상 호출해야 하고, 실수로 호출하지 않으면 문제가 될 것이다. 그리고 호출하는 것 자체도 중복이다.

정리하면 공통 처리가 어렵다는 문제가 있다.
이 문제를 해결하려면 컨트롤러 호출 전에 먼저 공통 기능을 처리해야 한다. 소위 수문장 역할을 하는 기능이 필요하다. 프론트 컨트롤러(Front Controller) 패턴을 도입하면 이런 문제를 깔끔하게 해결할 수 있다. (입구를 하나로!)
스프링 MVC의 핵심도 바로 이 프론트 컨트롤러에 있다.