Servlet / JSP / MVC

Java/Spring 2025. 2. 12. 15:29

서블릿과 JSP, MVC 패턴에 대해 정리하였습니다.

회원 관리 애플리케이션을 Servlet, JSP, MVC 패턴 각각으로 회원 관리 애플리케이션을 만들어 봅니다.

회원 관리 애플리케이션은 회원 정보(이름 username 과 나이 age)를 저장하고 회원 목록을 조회할 수 있습니다.

[ 공통 도메인 코드 ]

회원 도메인 모델(Member) :

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

회원 저장소(MemberRepository) :

public class MemberRepository {

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

    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 접근자로 막아둡니다.

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

회원 등록 폼 :

@WebServlet(name = "memberFormServlet", urlPatterns = "/servlet/members/newform")
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");
    }
}

: 단순하게 회원 정보를 입력할 수 있는 HTML Form을 만들어서 응답합니다. 자바 코드로 HTML을 제공해야 하므로 쉽지 않습니다.

회원 저장 :

@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);
        System.out.println("member = " + member);
        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>");
    }
}

: MemberSaveServlet은 다음과 같은 순서로 동작합니다.

파라미터로부터 Member 객체를 생성합니다.
Member 객체를 저장소(MemberRepository)에 저장합니다.
Member 정보를 기반으로 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 {

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

        List<Member> members = memberRepository.findAll();

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

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

: MemberListServlet은 다음과 같은 순서로 동작합니다.

memberRepository.findAll()`을 호출해 모든 회원을 조회합니다.
회원 수만큼 반복하여 HTML 목록을 생성하고 응답합니다.

[ 장점 ]

동적으로 원하는 HTML을 마음껏 만들 수 있습니다.

[ 단점 ]

코드가 매우 복잡하고 비효율적일 수 있습니다. HTML을 자바 코드로 생성하는 것보다 JSP, Thymeleaf, Freemarker 등과 같은 템플릿 엔진을 사용하여 필요한 부분만 동적으로 변경하는 것이 더 효율적입니다.

< 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문서라는 뜻입니다.

회원 저장 :

<%@ 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>

<%@ page import="hello.servlet.domain.member.MemberRepository" %> : 자바의 import문과 같습니다.

회원 목록 :

<%@ 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>

[ 장점 ]

뷰 생성을 위한 HTML 작업을 깔끔하게 처리하며, 필요한 부분에만 자바 코드를 적용할 수 있습니다.

[ 단점 ]

Java 코드 및 데이터 액세스 로직 등 다양한 코드가 JSP에 노출되어 복잡성을 증가시킵니다.
비즈니스 로직과 프레젠테이션 로직이 혼재되어 유지보수가 어렵습니다.

< 서블릿과 JSP의 한계 >

#1. 너무 많은 역할

하나의 서블릿이나 JSP에서 비즈니스 로직과 뷰 렌더링을 모두 처리하면 시스템이 복잡해지고 유지보수가 어려워집니다. UI를 변경하거나 비즈니스 로직에 수정이 필요할 때마다 방대한 양의 코드와 마주해야 합니다.

#2. 변경 라이프사이클의 차이

비즈니스 로직과 UI는 변경 주기가 다릅니다. UI 수정과 비즈니스 로직 수정은 각각 다른 시기에 발생하며, 서로에게 영향을 주지 않는 경우가 많습니다. 이러한 부분을 한 코드에 통합하면 효율성이 떨어집니다.

#3. 기능 특화

JSP 등 뷰 템플릿은 화면 렌더링에 최적화되어 있으므로, 해당 역할에 집중하는 것이 효율적입니다. 각 구성 요소가 자신의 역할에 충실하면 시스템의 효율성과 유지보수성이 향상됩니다.

< MVC 패턴 >

비즈니스 로직은 서블릿과 같은 별도의 계층에서 처리하고, JSP는 본연의 목적에 맞게 HTML로 화면(View)을 렌더링하는 데 집중하도록 해야 합니다. 과거의 개발자들도 이와 비슷한 고민을 했으며, 그 결과로 MVC 패턴이 등장했습니다.

MVC 패턴은 지금까지 하나의 서블릿이나 JSP로 처리하던 것을 컨트롤러(Controller)와 뷰(View)로 역할을 분리한 것을 말합니다.

웹 애플리케이션은 보통 이 MVC 패턴을 사용합니다.

Model :
뷰에 출력할 데이터를 담아둡니다. 뷰가 필요한 모든 데이터를 모델에 담아 전달하므로, 뷰는 비즈니스 로직이나 데이터 접근을 몰라도 되고, 화면을 렌더링하는 일에 집중할 수 있습니다.
Controller :
HTTP 요청을 받아 파라미터를 검증하고, 비즈니스 로직을 실행합니다. 그리고 뷰에 전달할 결과 데이터를 조회하여 모델에 담습니다.
View :
모델에 담긴 데이터를 사용하여 화면을 그리는 데 집중합니다. 여기서는 HTML을 생성하는 부분을 말합니다.

컨트롤러에 비즈니스 로직을 포함시킬 수도 있지만, 그렇게 하면 컨트롤러가 너무 많은 역할을 담당하게 됩니다. 따라서 일반적으로 비즈니스 로직은 서비스(Service)라는 별도의 계층을 만들어 처리합니다. 컨트롤러는 비즈니스 로직이 구현된 서비스를 호출하는 역할을 담당합니다.

< MVC 패턴의 적용 >

서블릿을 컨트롤러로 사용하고, JSP를 뷰로 사용해서 MVC 패턴을 적용해보겠습니다.

회원 목록 Controller(servlet) :

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

: Model은 HttpServletRequest 객체를 사용합니다.

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

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

회원 목록 View(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>

< MVC 패턴의 한계 >

MVC 패턴을 적용한 덕분에 컨트롤러의 역할과 뷰를 렌더링하는 역할을 명확하게 구분할 수 있었습니다.

특히 뷰는 화면을 그리는 역할에 충실하여 코드가 깔끔하고 직관적입니다. 모델에서 필요한 데이터만 가져와 화면을 생성하면 되기 때문입니다.

그러나 컨트롤러 측면에서 몇 가지 문제가 발생합니다.

# MVC 컨트롤러의 단점

1. View로 이동하는 코드의 중복

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

View로 이동하기 위해 항상 동일한 코드를 반복적으로 호출해야 합니다. 이 부분을 메서드로 공통화할 수 있지만, 그 메서드조차도 매번 직접 호출해야 하는 번거로움이 있습니다.

2. View 경로의 중복

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

만약 JSP가 아닌 Thymeleaf와 같은 다른 뷰로 변경한다면, 전체 코드에서 해당 경로를 모두 수정해야 합니다.

3. 사용되지 않는 코드

HttpServletRequest request, HttpServletResponse response

다음과 같은 코드는 일부 상황에서만 사용되며, 특히 `response` 객체는 현재 코드에서 사용되지 않습니다.

4. 공통 처리가 어렵다

기능이 복잡해질수록 컨트롤러에서 공통으로 처리해야 하는 부분이 점점 늘어납니다. 공통 기능을 메서드로 추출할 수 있지만, 결국 해당 메서드를 매번 호출해야 하고, 실수로 호출하지 않으면 문제가 발생합니다. 이처럼 호출 자체도 중복이 됩니다.

이러한 문제를 해결하려면 컨트롤러가 호출되기 전에 공통 기능을 처리해야 합니다. 즉, 수문장 역할을 하는 기능이 필요한데, 프론트 컨트롤러(Front Controller) 패턴을 도입하면 이러한 문제를 효과적으로 해결할 수 있습니다. 모든 요청의 입구를 하나로 통합하는 것이 핵심입니다.

스프링 MVC의 중심에도 바로 이 프론트 컨트롤러가 위치해 있습니다.

Servlet, JSP, MVC를 이용해 만든 회원 관리 애플리케이션의 코드는 제 GitHub에서 확인할 수 있습니다 :

https://github.com/tkdgns25300/servlet

GitHub - tkdgns25300/servlet: 서블릿을 직접 구현해보며 공부하기 위한 Toy프로젝트입니다.

서블릿을 직접 구현해보며 공부하기 위한 Toy프로젝트입니다. Contribute to tkdgns25300/servlet development by creating an account on GitHub.

github.com

해당 글에 포함된 코드나 그림은 김영한님이 제공해주신 자료를 바탕으로 작성되었습니다.

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

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

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

www.inflearn.com

Reference :

https://melodist.github.io/docs/Spring/SpringMVC1_2

https://melodist.github.io/docs/Spring/SpringMVC1_3

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

Spring MVC - Understanding Structure (2)	2025.03.17
Creating an MVC framework (2)	2025.02.13
Understanding Web Applications (5)	2025.01.14
Bean Scope (1)	2025.01.12
Bean Lifecycle Callback (3)	2025.01.03

내 블로그 - 관리자 홈 전환	`Q` `Q`
새 글 쓰기	`W` `W`

글 수정 (권한 있는 경우)	`E` `E`
댓글 영역으로 이동	`C` `C`

이 페이지의 URL 복사	`S` `S`
맨 위로 이동	`T` `T`
티스토리 홈 이동	`H` `H`
단축키 안내	`Shift` + `/` `⇧` + `/`

인기포스트

ABOUT ME

Begin to End Project Begin to End Project

[ 공통 도메인 코드 ]

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

< JSP 회원 관리 애플리케이션 만들기 >

< 서블릿과 JSP의 한계 >

< MVC 패턴 >

< MVC 패턴의 적용 >

< MVC 패턴의 한계 >

# MVC 컨트롤러의 단점

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

티스토리툴바

단축키

내 블로그

블로그 게시글

모든 영역

인기포스트

ABOUT ME

[ 공통 도메인 코드 ]

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

< JSP 회원 관리 애플리케이션 만들기 >

< 서블릿과 JSP의 한계 >

< MVC 패턴 >

< MVC 패턴의 적용 >

< MVC 패턴의 한계 >

# MVC 컨트롤러의 단점

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

관련글 관련글 더보기

티스토리툴바

단축키

내 블로그

블로그 게시글

모든 영역