어노테이션을 적용한 Spring MVC 게시판 개발

 

Spring Quick Start(책)의 Day4 class01~02 실습을 진행하면서 기록한 내용입니다.

실습한 코드의 링크입니다.

---

1. 컨트롤러 객체에 @Controller 등록하기

@Controller로 등록된 컴포넌트가 스캔되기 위해

스프링 설정 파일(webapp/WEB-INF/presentation-layer.xml)에

<context:component-scan>으로 패키지 위치를 지정해 주어야 한다.

<context:component-scan base-package="com.springbook.view"> </context:component-scan>

컨트롤러 클래스에 @Component를 상속한 @Controller를 등록한다.

---

2. @RequestMapping 사용하면서 Controller 통합하기

@RequestMapping

스프링에서는 @RequestMapping을 이용하여 HandlerMapping 설정을 대체한다.

HandlerMapping 은 이전에 스프링 설정 파일에서 지정했었다.

value 속성은 생략할 수 있으며 대부분 생략한다.

각 메소드의 리턴 타입은 String으로 통일하였고 검색 결과는 Model에 저장했다. 이는 ModelAndView와 동일하게 JSP 화면에서 사용할 수 있다.

package com.springbook.view.board;

import java.util.HashMap;
import java.util.Map;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.SessionAttributes;

import com.springbook.biz.board.BoardVO;
import com.springbook.biz.board.impl.BoardDAO;

@Controller
@SessionAttributes("board")
public class BoardController {
	
	// 검색 조건 목록 설정
	@ModelAttribute("conditionMap")
	public Map<String, String> searchConditionMap(){
		Map<String, String> conditionMap = new HashMap<String, String>();
		conditionMap.put("제목", "TITLE");
		conditionMap.put("내용", "CONTENT");
		return conditionMap;
	}
	
	// 글 등록
	@RequestMapping(value = "/insertBoard.do")
	public String insertBoard(BoardVO vo, BoardDAO boardDAO) { 
    // 매개변수로 선언하면 스프링 컨테이너가 해당 객체를 생성하여 전달해준다.
		boardDAO.insertBoard(vo);
		return "getBoardList.do";
	}

	// 글 수정
	@RequestMapping("/updateBoard.do")
	public String updateBoard(@ModelAttribute("board") BoardVO vo, BoardDAO boardDAO) {
		System.out.println("번호 : " + vo.getSeq());
		System.out.println("제목 : " + vo.getTitle());
		System.out.println("작성자 : " + vo.getWriter());
		System.out.println("내용 : " + vo.getContent());
		System.out.println("등록일 : " + vo.getRegDate());
		System.out.println("조회수 : " + vo.getCnt());
		
		boardDAO.updateBoard(vo);
		return "getBoardList.do";
	}

	// 글 삭제
	@RequestMapping("/deleteBoard.do")
	public String deleteBoard(BoardVO vo, BoardDAO boardDAO) {
		boardDAO.deleteBoard(vo);
		return "getBoardList.do";
	}

	// 글 상세 조회
	@RequestMapping("/getBoard.do")
	public String getBoard(BoardVO vo, BoardDAO boardDAO, Model model) {
		model.addAttribute("board", boardDAO.getBoard(vo)); // Model 정보 저장
		return "getBoard.jsp"; // View 이름 리턴
	}

	// 글 목록 검색
	@RequestMapping("/getBoardList.do")
	public String getBoardList(BoardVO vo, BoardDAO boardDAO, Model model) {		
		// 3개의 매개변수를 선언했는데 마지막은 Model에 검색 결과 정보를 저장하기 위해 쓴다.
		model.addAttribute("boardList", boardDAO.getBoardList(vo));																
		return "getBoardList.jsp"; // View 이름 리턴
	}
}

@ModelAttribute 메소드

여기서 중요한 것은 @ModelAttribute 어노테이션이 적용된 메소드이다.

@ModelAttribute가 설정된 메소드는 @RequestMapping 어노테이션이 적용된 메소드보다 먼저 호출된다.

그리고 실행 결과로 리턴된 객체는 자동으로 Model에 저장되어 View 페이지에서 사용할 수 있다.

@ModelAttribute 매개변수

Command 객체의 이름을 변경할 때 @ModelAttribute를 사용할 수 있다.

updateBoard()에서 스프링 컨테이너가 생성하는 Command 객체의 이름은 클래스 이름의 첫 글자를 소문자로 변경한 "boardVO"로 자동으로 설정된다. 이를 @ModelAttribute("board")로 "board"로 바꿨다.

@SessionAttributes

BoardController의 바로 위에 @SessionAttributes("board")가 설정되어 있다.

Model에 "board"라는 이름으로 저장되는 데이터가 있으면 그 데이터를 세션(HttpSession)에도 자동으로 저장하라는 설정이다.

🍰 어노테이션 동작 설명

getBoard() 실행 시, 1. Model에 "board"라는 이름으로 BoardVO 객체가 저장되고 2. @SessionAttributes("board")에 의해 세션에도 "board"라는 이름으로 BoardVO 객체가 저장된다.

이후 update() 실행 시, @ModelAttribute("board")에 의해 세션에 board라는 이름으로 저장된 데이터가 있는지 확인한다. 있다면 해당 객체를 세션에서 꺼내서 매개변수로 선언된 vo 변수에 할당한다. 이후 사용자가 입력한 파라미터값을 vo 객체에 할당한다. 이때 사용자가 입력한 수정 정보(title, content) 값만 새롭게 할당되고 나머지는 세션에 저장된 데이터가 유진된다.

 

요청 방식(GET/POST)

@RequestMapping 요청 방식(GET/POST) 에 따라 수행될 메소드를 다르게 설정할 수 있다.

package com.springbook.view.user;

// import 생략

@Controller
public class LoginController {

	@RequestMapping(value = "/login.do", method = RequestMethod.GET)
	public String loginView(@ModelAttribute("user") UserVO vo) {
		System.out.println("로그인 화면으로 이동...");
		vo.setId("test");
		vo.setPassword("test123");
		return "login.jsp";
	}

	@RequestMapping(value = "/login.do", method = RequestMethod.POST)
	public String login(UserVO vo, UserDAO userDAO, HttpSession session) {
		UserVO user = userDAO.getUser(vo);
		if (user != null) {
			session.setAttribute("userName", user.getName());
			return "getBoardList.do";
		} else
			return "login.jsp";
	}
}

Servlet API

또한 스프링 MVC에서는 Controller 메소드 매개변수로 다양한 Servlet API를 사용할 수 있도록 지원한다.

login()에서 HttpSession 객체를 매개변수로 받아 로그인 성공 시 세션에 사용자 이름을 저장하고 있다.

 

🍒 컨트롤러 객체의 메소드가 호출되는 과정

이 후 클라이언트가 글 등록 정보를 적절하게 입력하고 서버에 "insertBoard.do" 요청을 전달했을 때 과정은 이렇다. 

 

🧀 스프링 컨테이너는 @Controller가 붙은 모든 컨트롤러 객체를 생성하고

🧀 매개변수에 해당하는 BoardVO 객체를 생성하고

🧀 BoardVO 클래스의 Setter 메소드들을 호출하여 사용자가 입력한 파라미터(title, writer, content) 값들을 BoardVO 객체에 저장한다. (Setter 인젝션)

여기서 중요한 것은 form tag 안의 name="writer" 값이

Command 객체의 Setter 메소드 이름 즉 setWriter()와 반드시 일치해야 자동으로 사용자 입력값이 저장된다.

🧀 insertBoard() 메소드를 호출할 때, 이미 사용자가 입력한 값들이 설정된 BoardVO 객체가 인자로 전달된다.

 

결과적으로 사용자 입력 정보 추출과 VO 객체 생성, 그리고 값 설정은 모두 컨테이너가 자동으로 처리해주는 것이다.

---

3. JSP에서 Command 객체 사용

Command 객체는 Controller 메소드 매개변수로 받은 VO 객체이다.

Command 객체에 저장된 데이터를 JSP에서 사용하려면 "${...}" 구문을 이용한다.

@ModelAttribute("user")로 Command 객체의 이름을 변경했기에 "${user.id}" 값을 참조할 수 있다.

[login.jsp]

<%@page contentType="text/html; charset=EUC-KR"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<title>로그인</title>
</head>
<body>
<center>
	<h1>로그인</h1>
	<hr>
	<form action="login.do" method="post">
		<table border="1" cellpadding="0" cellspacing="0">
			<tr>
				<td bgcolor="orange">아이디</td>
				<td><input type="text" name="id" value="${user.id }" /></td>
			</tr>
			<tr>
				<td bgcolor="orange">비밀번호</td>
				<td><input type="password" name="password" value="${user.password }"/></td>
			</tr>
			<tr>
				<td colspan="2" align="center"><input type="submit" value="로그인" /></td>
			</tr>
		</table>
	</form>
	<hr>
</center>
</body>
</html>

user.id, user.password로 값을 가져올 수 있다.

[getBoardList.jsp]

<%@page contentType="text/html; charset=UTF-8"%>
<%@taglib uri="http://java.sun.com/jstl/core_rt" prefix="c"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<title>글 목록</title>
</head>
<body>
<center>
	<h1>글 목록</h1>
	<h3>${userName }님!
		게시판에 오신걸 환영합니다...<a href="logout.do">Log-out</a>
	</h3>
	<!-- 검색 시작 -->
	<form action="getBoardList.do" method="post">
		<table border="1" cellpadding="0" cellspacing="0" width="700">
			<tr>
				<td align="right">
					<select name="searchCondition">
						<c:forEach items="${conditionMap }" var="option">
						<option value="${option.value }">${option.key }
							</c:forEach>
					</select>
					<input name="searchKeyword" type="text" />
					<input type="submit" value="검색" /></td>
			</tr>
		</table>
	</form>
	<!-- 검색 종료 -->
	<table border="1" cellpadding="0" cellspacing="0" width="700">
		<tr>
			<th bgcolor="orange" width="100">번호</th>
			<th bgcolor="orange" width="200">제목</th>
			<th bgcolor="orange" width="150">작성자</th>
			<th bgcolor="orange" width="150">등록일</th>
			<th bgcolor="orange" width="100">조회수</th>
		</tr>
		<c:forEach items="${boardList }" var="board">
			<tr>
				<td>${board.seq }</td>
				<td align="left"><a href="getBoard.do?seq=${board.seq }">
						${board.title }</a></td>
				<td>${board.writer }</td>
				<td>${board.regDate }</td>
				<td>${board.cnt }</td>
			</tr>
		</c:forEach>
	</table>
	<br> <a href="insertBoard.jsp">새글 등록</a>
</center>
</body>
</html>

conditionMap은 BoardController에서 @ModelAttribute("conditionMap")로 지정한 메소드를 통해 값을 참조할 수 있다.
userName은 LoginController의 login() 중 session.setAttribute("userName", user.getName());로 지정되어서 값을 참조할 수 있다.

 

프로젝트 전체는 최상단의 깃헙 링크를 통해 확인할 수 있습니다.