뷰 이름 명시적 지정 :ModelAndView와 String 리턴 타입

뷰이름의 명시적 지정

- ModelAndView 나 String을 리턴해야한다. 

(ModelAndView를 리턴해서 뷰를 지정하는 예)

@RequestMapping("index.do")
public ModelAndView index() {
    ModelAndView mav = new ModelAndView("index");

    return mav;
}

ModelAndView를 리턴할 경우 ModelAndView 클래스의 생성자나 setViewName() 메서드를 이용해서 뷰 이름을 지정할 수 있다.

위 코드는 ModelAndView 클래스의 생성자를 이용해서 뷰 이름을 지정하고 있다. 다음과 같이 setViewName()메서드를 사용해도 된다.

ModelAndView mav = new ModelAndView();
mav.setViewName("search/game");

String 타입을 리턴할 경우, 문자열 값이 뷰 이름으로 사용된다. 아래 코드는 String 을 리턴하는 예를 보여주고 있다.

아래 코드는 보여줄 뷰 이름으로 "help/main" 을 지정하고 있다.

@RequestMapping("/hello/main.do")
public String helloMain("ModelMap model) {
    ...
    return "hello/main";
}

뷰 이름 자동 지정

다음의 경우는 RequestToNameTranslator를 이용해서 URL 로부터 뷰 이름을 결정한다.

◎ 리턴 타입이 Model이나 Map일경우

◎ 리턴 타입이 void 이면서 ServletResponse나 HttpservletResponse 타입의 파라미터가 없는 경우

 

스프링 설정 파일에 RequestToViewNameTranslator 빈이 존재하지 않을 경우 기본적으로 DefaultRequestToViewNameTranslator 를 사용한다. 이 클래스는 요청 URI 부터 맨 앞의 슬래시와 확장자를 제외한 나머지 부분을 뷰 이름으로 사용한다. (더 정확하게는 전체 경로를 사용하지 않도록 설정한 경우 서블릿 경로를 제외한 나머지 경로가 사용된다.) 

@RequestMapping("/search/searchInfo.do")
public Map<Sttring, Object> search() {
    HashMap<String, Object> model = new HashMap<String, Object>();
    ....
    return model;
}

 

위 코드는 뷰에 전달할 모델 데이터를 갖고 있는 Map을 리턴하고 있다. 이 경우 ReqeustToViewTranslator를 이용해서 결과를 보여줄 뷰 이름을 결정하게 되는데 ,DefaultRequestToViewNameTranslator가 사용될 경우 다음과 같이 URL로 부터 뷰 이름이 결정된다.

 /search/searchInfo.do  --> search/searchInfo

전체 경로 사용 여부에 따라서 뷰 이름이 결정되는 방식이 달라진다.

 

리다이렉트 뷰

뷰 이름에 "redirect:" 접두어를 붙이면 지정한 페이지로 리다이렉트 된다.

리다이렉트 URL은 다음과 같이 두 가지 방식으로 입력할 수 있다.

 

◎redirect : /board/list - 현재 서블릿 컨텍스트에 대한 상대적인 경로로 리다이렉트

◎redirect:http://host/bbs/list - 지정한 절대 URL로 리다이렉트

 

아래 코드는 "redirect:" 접두어를 사용하여 뷰 이름을 지정한 예이다.

ModelAndView mav = mew ModelAndView();
mav.setViewName("redirect:/error.do");
return mav;

redirect 접두어는 UrlBasedViewResolver Class를 상속받은 ViewResolver에서 처리된다. InternalResourceViewResolver or VelocityViewResolver와 같이 사용되는 ViewResolver는 UrlBasedViewResolver Class 상속받고 있기 때문에 모두 redirect 접두어를 지원하고 있다.

Map, Model ,ModelMap을 통한 모델설정

Map, Model, ModelMap을 이용하면 뷰에 전달할 모델을 생성할 수 있다.

첫 번째 방법은 이들 세 가지 타입 중 한가지를 파라미터로 전달받는 것이다.

@RequestMapping("/search1.do")
public String search1(Map model) {
    model.put("result", searchResult);
    ...
}

@RequestMapping("/search2.do")
public String search1(Model model) {
    model.addAttribute("result", searchResult);
    ...
}

@ResultMapping("/search3.do")
public String1(ModelMap model) { 
    model.addAttribute("result", searchResult);
    ...
}

Map, Model, ModelMap을 파라미터로 전달받는 경우, 이들이 제공하는 메서드를 이용해서 모델 데이터를 추가할수 있다.

두 번째 방법은 Map과 Model을 리턴하는 것이다. 이 둘은 모두 인터페이스이기 때문에 실제로는 인터페이스를 구현한 클래스의 객체를 생성해서 리턴하면된다.

사용예)

@RequestMapping("/search1.do")
public Map<String, Object> search1() {
    ...
    HashMap<String, Object> model = new HashMap<String, Object>();
    model.put("result", searchResult);
    return model;
}

@RequestMapping("/search2.do")
public Model search2() {
    ...
    Model model = new ExtendedModelMap();
    model.addAttrubute("result", searchResult);
    return model;
}

Spring은  org.springframework.ui.Model 인터페이스의 구현 클래스인 ExtendedModelMap 클래스를 동일한 패키지에 제공하고 있으므로, ExtendedModelMap 클래스를 이용해서 모델을 설정하면된다. Map의 경우 많이 사용하는 java.util.HashMap 클래스를 이용해서 모델을 설정한다.

 

Model 인터페이스의 주요 메서드

org.springframework.ui.Model 인터페이스는 모델을 설정할 수 있도록 다음과 같은 메서드를 제공한다.

 

◎ModeladdAttriibute(String name, Object value)

value 객체를 name 이름으로 추가한다. 뷰 코드에는 name으로 지정한 이름을 통해서 value를 사용한다.

 

◎ModeladdAttribute(object value)

value를 추가한다. value의 패키지 이름을 제외한 단순  클래스 이름을 모델이름으로 사용한다. 이 떄 첫 글자는 소문자로 처리한다.

value가 배열이거나 콜렉션인 경우  첫 번째 원소의 클래스 이름뒤에 "List" 를 붙일 걸 모델이름으로 사용한다. 이 경우에도 클래스 이름의 첫글자는 소문자로 처리한다.

 

◎ModeladdAllAttributes(Collection<?> values)

addAttribute(Object value)) 메서드를 이용해서 콜렉션에 포함된 객체들을 차례대로 추가한다.

 

◎ModeladdAllAttributes(Map<String,?> attributes)
Map에 포함된 <key, value>에 대해 키를 모델 이름으로 사용해서 값을 모델로 추가한다.

 

◎Model mergeAttributes(Map<String,?> attributes)

Map에 포함된 <key, value>을 현재 모델에 추가한다. 단, 키와 동일한 이름을 갖는 모델 객체가 존재하지 않는 경우에만 추가한다.

 

◎Boolean containsAttributes(String name) 

지정한 이름의 도델 객체를 포함하고 있는 경우 true를 리턴한다.

 

ModelAndView 를 통한 모델 설정

객체생성방법

ModelAndView객체 생성은 setViewName(String viewName) 메서드를 이용해서 뷰 이름을 설정하고, 

addObject(String name, Object value) 메서드를 이용해 뷰에 전달할 값을 추가하는 것이다.

@RequestMapping("/search/product.do")
public ModelAndView search(SearchCommand command) {
    ...
    ModelAndView mav = new ModelAndView();
    mav.setViewName("search/product");
    mav.addObject("searchResult", searchResult);
    mav.addObject("searchTypeList", typeList);
    return mav;
}

 

Map에 저장된 <key, value> 쌍 전체를 뷰에 전달할 값으로 ModelAndView 객체에 추가하고 싶다면 다음과 같이 addAllObjects(Map modelMap) 메서드를 사용하면 된다.

Map referenceMap = referenceDate();
mav.addAllObjects(referenceMap);

 

생성자를 사용해서 뷰 이름과 Map을 전달할 수도 있다.

Map referenceMap = referenceDate();
return new ModelAndView("search/product", referenceMap);

 

뷰에 전달할 객체가 한 개 뿐이라면 다음과 같은 생성자를 이용해서 코드 분량을 줄일 수 있을 것이다.

return new ModelAndView("search/game","result", searchResult);