[Spring] 01-11. ModelAttribute Annotation을 이용한 모델 데이터 처리

@ModelAttribute Annotation을 이용하면 다음의 두 가지 작업을 수행할 수 있다.

- @ModelAttribute Annotation이 적용되지 않은 별도 메서드로 모델에 추가될 객체를 생성

- 커맨드 객체의 초기화 작업을 수행

* 참조 데이터 생성

- WEB Application을 구현하다 보면 동일한 모델 데이터를 두 개 이상의 요청 처리 결과 화면에서 보여주어야 할 때가 있다.

예를 들어, 검색 메인 화면과 검색 결과 화면에서 검색 타입과 인기 검색어를 보여줄 수 있을 것이다. 이 경우 이들 공통 모델 데이터를 설정해 주는 메서드를 구현한 뒤 요청 처리 메서드에서 호출하도록 구현할 수 있을 것이다.

@ModelAttribute Annotation을 사용하면 이런 단점 없이 두 개 이상의 요청 처리 메서드에서 공통으로 사용되는 모델을 설정할 수가 있다. @ModelAttribute Annotation을 메서드에 적용하면 해당 메서드가 생성한 객체가 뷰에 전달된다. 따라서, @ModelAttribute Annotation을 사용하면 두 개 이상의 요청 처리 메서드에서 공통으로 사용되는 모델 객체를 생성할 수 있다.

[GameSearchController.java]

package spring.chap06.controller;
 
import java.util.ArrayList;
import java.util.List;
 
import spring.chap06.service.SearchCommand;
import spring.chap06.service.SearchResult;
import spring.chap06.service.SearchService;
import spring.chap06.service.SearchType;
 
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
 
@Controller
public class GameSearchController {
    @Autowired
    private SearchService searchService;
 
    @ModelAttribute("searchTypeList")
    public List<SearchType> referenceSearchTypeList() {
        List<SearchType> options = new ArrayList<SearchType>();
        options.add(new SearchType(1, "전체"));
        options.add(new SearchType(2, "아이템"));
        options.add(new SearchType(3, "캐릭터"));
        return options;
    }
 
    @ModelAttribute("popularQueryList")
    public String[] getPopularQueryList() {
        return new String[] { "게임", "창천2", "위메이드" };
    }
 
    @RequestMapping("/search/main.do")
    public String main() {
        return "search/main";
    }
 
    @RequestMapping("/search/game.do")
    public ModelAndView search(@ModelAttribute("command") SearchCommand command) {
        ModelAndView mav = new ModelAndView("search/game");
        System.out.println("검색어 = " + command.getQuery().toUpperCase());
        SearchResult result = searchService.search(command);
        mav.addObject("searchResult", result);
        return mav;
    }
 
    @ExceptionHandler(NullPointerException.class)
    public String handleNullPointerException(NullPointerException ex) {
        return "error/nullException";
    }
 
    public void setSearchService(SearchService searchService) {
        this.searchService = searchService;
    }
 
}

[SearchCommand.java]

package spring.chap06.service;
 
public class SearchCommand {
 
    private String type;
    private String query;
    private int page;
 
    public String getType() {
        return type;
    }
 
    public void setType(String type) {
        this.type = type;
    }
 
    public String getQuery() {
        return query;
    }
 
    public void setQuery(String query) {
        this.query = query;
    }
 
    public int getPage() {
        return page;
    }
 
    public void setPage(int page) {
        this.page = page;
    }
 
}

[SearchType.java]

package spring.chap06.service;
 
public class SearchType {
 
    private int code;
    private String text;
 
    public SearchType(int code, String text) {
        this.code = code;
        this.text = text;
    }
 
    public int getCode() {
        return code;
    }
 
    public void setCode(int code) {
        this.code = code;
    }
 
    public String getText() {
        return text;
    }
 
    public void setText(String text) {
        this.text = text;
    }
 
}

[SearchService.java]

package spring.chap06.service;
 
public class SearchService {
 
    public SearchResult search(SearchCommand command) {
        return new SearchResult();
    }
 
}

[SearchResult.java]

package spring.chap06.service;
 
public class SearchResult {
 
}

[dispatcher-servlet.xml]

<bean class="spring.chap06.controller.GameSearchController"
        p:searchService-ref="searchService" />
 
    <bean id="searchService" class="spring.chap06.service.SearchService" />

[/WEB-INF/view/search/main.jsp]

<%@ page language="java" contentType="text/html; charset=EUC-KR"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=EUC-KR">
<title>게임 검색 메인</title>
</head>
<body>
    인기 키워드:
    <c:forEach var="popularQuery" items="${popularQueryList}">${popularQuery} </c:forEach>
    <form action="game.do">
        <select name="type">
            <c:forEach var="searchType" items="${searchTypeList}">
                <option value="${searchType.code}">${searchType.text}</option>
            </c:forEach>
        </select> <input type="text" name="query" value="" /> <input type="submit"
            value="검색" />
    </form>
</body>
</html>

[/WEB-INF/view/search/game.jsp]

<%@ page language="java" contentType="text/html; charset=EUC-KR"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=EUC-KR">
<title>게임 검색 결과</title>
</head>
<body>
    인기 키워드:
    <c:forEach var="popularQuery" items="${popularQueryList}">${popularQuery} </c:forEach>
    <form action="game.do">
        <select name="type">
            <c:forEach var="searchType" items="${searchTypeList}">
                <option value="${searchType.code}"
                    <c:if test="${command.type == searchType.code}">selected</c:if>>
                    ${searchType.text}</option>
            </c:forEach>
        </select> <input type="text" name="query" value="${command.query}" /> <input
            type="submit" value="검색" />
    </form>
    검색 결과: ${searchResult}
</body>
</html>
 

서버 구동후 http://localhost:8080/Spring06/search/main.do 으로 구동