Spring MVC를 적용한 게시판 개발

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

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

---

1. DispatcherServlet 등록

WEB-INF/web.xml 파일에 스프링 프레임워크에서 제공하는 DispatcherServlet 등록하기

서블릿 컨테이너는 클라이언트의 ".do" 요청이 있어야 DispatcherServlet 객체를 생성한다.

[web.xml]

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
                http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">

    <servlet>
        <servlet-name>action</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet<servlet-class>
    <servlet>
    <servlet-mapping>
        <servlet-name>action</servlet-name>
        <url-pattern>*.do</url-pattern>
    </servlet-mapping>
</web-app>

 

2. 스프링 컨테이너 구동

클라이언트의 요청으로 DispatcherServlet 객체가 생성된다.

DispatcherServlet은 클라이언트의 요청 처리에 필요한 HandlerMapping, Controller, ViewResolver 객체들을 메모리에 생성하기 위해 스프링 컨테이너를 구동한다.

 

3. 스프링 설정 파일 등록

web.xml에서 servlet-name이 action이라서 DispatcherSevlet이 스프링 컨테이너를 구동할 때 무조건 WEB-INF/action-servlet.xml 파일을 찾아 로딩한다.

그러므로 WEB-INF 아래에 action-servlet.xml 이름으로 Spring Configuration 파일을 만드는 것이 default이다.

 

4. Controller 인터페이스 이해

스프링에서 제공하는 Controller 인터페이스는 이러하다.

이전에 스프링을 활용하지 않고 직접 구현했었던 MVC 모델(hoit1302.tistory.com/47의 1. Controller)과 비교하면 메소드의 리턴 값만 ModelAndView로 바뀐 것을 확인할 수 있다.

 

package org.springframework.web.servlet.mvc;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.ModelAndView;

public interface Controller {
	ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) 
    		throws Exception;
}

 

5. 필요한 기능의 Controller 구현

클래스 이름에서 알 수 있듯이, Model과 View 정보를 모두 저장하여 리턴할 때 사용한다.

ModelAndView 객체에 필요한 값을 저장하여 리턴하는 것에 주목하면 된다.

 

5.1 LoginController 구현

package com.springbook.view.user;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import com.springbook.biz.user.UserVO;
import com.springbook.biz.user.impl.UserDAO;

public class LoginController implements Controller {

	@Override
	public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) {
		System.out.println("로그인 처리");
		
		// 1. 사용자 입력 정보 추출
		String id = request.getParameter("id");
		String password = request.getParameter("password");

		// 2. DB 연동 처리
		UserVO vo = new UserVO();
		vo.setId(id);
		vo.setPassword(password);

		UserDAO userDAO = new UserDAO();
		UserVO user = userDAO.getUser(vo);

		// 3. 화면 네비게이션
		ModelAndView mav = new ModelAndView();
		if (user != null) {
			mav.setViewName("getBoardList.do");
		} else {
			mav.setViewName("login.jsp");
		}
		return mav;
	}

}

5.2 getBoardListController 구현

여기서 중요한 점은 검색결과를 세션이 아닌 ModelAndView 객체에 저장하고 있다는 것이다.

package com.springbook.view.board;

import java.util.List;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

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

public class GetBoardListController implements Controller {

	@Override
	public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) {
		System.out.println("글 목록 검색 처리");
		
		// 1. 사용자 입력 정보 추출(검색 기능은 나중에 구현)
		// 2. DB 연동 처리
		BoardVO vo = new BoardVO();
		BoardDAO boardDAO = new BoardDAO();
		List<BoardVO> boardList = boardDAO.getBoardList(vo);
		
//		// 3. 검색 결과를 세션에 저장하고 목록 화면을 리턴한다.
//		HttpSession session = request.getSession();
//		session.setAttribute("boardList", boardList);
//		return "getBoardList";
		
		// 3. 검색 결과와 화면 정보를 ModelAndView에 저장하여 리턴한다.
		ModelAndView mav = new ModelAndView();
		mav.addObject("boardList", boardList); 	// Model 정보 저장
		mav.setViewName("getBoardList"); 	// View 정보 저장
		return mav;
	}
}

다른 기능들도 많으나 새롭게 배우는 내용은 없으므로 후략.

6. HadlerMapping 등록

	<!-- HandlerMapping 등록 -->
	<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
		<property name="mappings">
			<props>
				<prop key="/login.do">login</prop>
				<prop key="/getBoardList.do">getBoardList</prop>
				<prop key="/getBoard.do">getBoard</prop>
				<prop key="/insertBoard.do">insertBoard</prop>
				<prop key="/updateBoard.do">updateBoard</prop>
				<prop key="/deleteBoard.do">deleteBoard</prop>
				<prop key="/logout.do">logout</prop>
			</props>
		</property>
	</bean>

	<!-- Controller 등록 -->
	<bean id="login" class="com.springbook.view.user.LoginController"></bean>
	<bean id="getBoardList" class="com.springbook.view.board.GetBoardListController"></bean>
	<bean id="getBoard" class="com.springbook.view.board.GetBoardController"></bean>
	<bean id="insertBoard" class="com.springbook.view.board.InsertBoardController"></bean>
	<bean id="updateBoard" class="com.springbook.view.board.UpdateBoardController"></bean>
	<bean id="deleteBoard" class="com.springbook.view.board.DeleteBoardController"></bean>
	<bean id="logout" class="com.springbook.view.user.LogoutController"></bean>

"/login.do" 요청은 id가 login으로 등록된 객체와 매핑되어 있다.

각 controller 클래스는 빈으로 등록되어야 사용할 수 있다.

 

7. ViewResolver 활용하기

ViewResolver를 이용하면 클라이언트로부터의 직접적인 JSP 호출을 차단할 수 있다.

대부분의 웹 프로젝트에서 ViewResolver 사용은 거의 필수이다.

앞서 작성된 코드를 실행하여 getBoardList.jsp 파일을 직접 호출하면 에러가 발생한다.

GetBoardListController부터 실행할 수 있도록 적절히 제어해야 하는데, 이 때 ViewResolver 사용하는 것이다.

 

7.1 viewresolver 등록

WEB-INF 폴더는 절대 브라우저로 접근할 수 없다.

하지만 InternalResourceViewResolver로 설정하면 WEB-INF 폴더에 있는 JSP 파일을 View 화면으로 사용할 수 있다.

    <!-- ViewResolver 등록 -->
    <bean id="viewResolver"
          class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/board/"> </property>
        <property name="suffix" value=".jsp"> </property>
    </bean>

7.2 controller 수정

InternalResourceViewResolver를 등록했을 때는 모든 view 이름에서 확장자 '.jsp'를 제거해야 한다.

[여러 컨트롤러 중 GetBoardController.java]
		// 3. 검색 결과와 화면 정보를 ModelAndView에 저장하여 리턴한다.
		ModelAndView mav = new ModelAndView();
		mav.addObject("board", board); 	 // Model 정보 저장
		mav.setViewName("getBoard"); 	 // View 정보 저장
		return mav;

여러 컨트롤러 중

view 이름 앞에 redirect:를 붙이면 viewresolver가 설정되어 있더라도 이를 무시하고 리다이렉트한다.

확장자가 '.do'인 요청은 앞에 'redirect:'을 붙여서 viewresolver가 동작하지 않도록 해야 한다.

[여러 컨트롤러 중 LoginController.java]
		// 3. 화면 네비게이션
		ModelAndView mav = new ModelAndView();
		if (user != null) {
			mav.setViewName("redirect:getBoardList.do");
		} else {
			mav.setViewName("redirect:login.jsp");
		}
		return mav;