【Spring MVC】5.2、编写基本的控制器

1、控制器的基本形式

@RequestMapping注解

声明这个控制器所要处理的请求

@Controller
public class HomeController{
    @RequestMapping(value="/", method=GET)
    public String home(){
        return "home";
    }
}

1.1、声明控制器

2种方式让控制器类能被扫描称为组件：

a、在类上使用@Controller声明这是一个控制器

b、在类上使用@Component声明这是一个组件，并且类名使用Controller作为结束

1.2、指定处理请求路径

@RequestMapping(value="/",method=GET)

value代表要处理的请求路径，method属性指定所处理的HTTP方法

1.3、返回视图名称

return "home";

返回一个字符串，代表需要渲染的视图名称。DispatcherServlet会要求视图解析器将这个逻辑名称解析为实际的视图。

基于我们在InternalResourceViewResolver的配置，视图名“home”将被解析为“/WEB-INF/views/home.jsp”路径的JSP。

2、测试控制器

控制器本身也是一个POJO，可用普通POJO的测试方法测试，但是没有太大的意义。

Public class HomeControllerTest{
    @Test
    public void testHomePage() throws Exception{
        HomeController controller = new HomeController();
        assertEquals("home", controller.home());
    }
}

这个测试只是测试home()方法的返回值，没有站在SpringMVC控制器的角度进行测试。

Spring 3.2开始可以按照控制器的方式来测试控制器。

Spring 3.2开始包含一种mock Spring MVC并针对控制器执行HTTP请求的机制，这样测试控制器就不用启动Web服务器和Web浏览器了。

Public class HomeControllerTest{
    @Test
    public void testHomePage() throws Exception{
        HomeController controller = new HomeController();
        MockMvc mockMvc = standaloneSetup(controller).build();//搭建MockMvc
        mockMvc.perform(get("/"))//对"/"执行GET请求
                      .andExpect(view().name("home"));//预期得到home视图
    }
}

先传递一个HomeController实例到standaloneSetup()并调用build()来构建MockMvc实例，然后用这个实例来执行针对“/”的GET请求并设置期望得到的视图名称。

3、定义类级别的请求处理

对类使用@RequestMapping注解，那么这个注解会应用到所有处理器方法中。

@Controller
@RequestMapping("/")
public class HomeController{
    @RequestMapping( method=GET)
    public String home(){
        return "home";
    }
}

路径还可以是一个数组，下面例子代表home()方法可以映射到对“/”和“homepage”的GET请求。

@Controller
@RequestMapping({"/", "/homepage"})
public class HomeController{
    @RequestMapping( method=GET)
    public String home(){
        return "home";
    }
}

4、传递模型数据到视图中

使用Model传递数据

@RequestMapping(method=RequestMethod.GET)
public String spittles(Model model){
    model.addAttribute(spittleRepository.findSpittles(Long.MAX_VALUE,20));
    return "spittles";
｝

通过Model参数，可以将控制器里面的值，传递到视图中，渲染到客户端。

Model实际上是一个Map（Key-Value对集合）

使用addAttribute并且不指定key的时候，Model会根据类型自动生成key，例如上面是一个List<Spittle>，那么key值就是spittleList

最后控制器返回视图逻辑名，标明需要渲染的视图。

改用Map传递数据

如果不想使用Spring类型，把Model改成Map类型也是可以的

@RequestMapping(method=RequestMethod.GET)
public String spittles(Map model){
    model.put("spittleList",spittleRepository.findSpittles(Long.MAX_VALUE,20));
    return "spittles";
｝

直接返回数据

@RequestMapping(method=RequestMethod.GET)
public List<Spittle> spittles(){
    return spittleRepository.findSpittles(Long.MAX_VALUE,20);
｝

这种写法，没有返回视图名称，也没有显式设定模型。

模型：当处理器方法直接返回对象或集合时，这个值会放进模型中，模型的key由类型推断出来。

视图：而视图的逻辑名称会根据请求路径推断得出，如/spittles的GET请求，逻辑视图名称就是spittles（去掉开头斜线）。

视图的渲染

无论使用哪种方法，结果是一样的：

在控制器中，将数据定义为模型，并发送到指定的视图，根据视图的逻辑名称，按照我们配置的InternalResourceViewResolver视图解析器，找到对应的视图文件（如"/WEB-INF/views/spittles.jsp"）。

当视图是JSP的时候，模型数据会作为请求属性放到请求（request）之中。

因此，在jsp文件中可以使用JSTL（JavaServer Pages Standard Tag Library）的<c:forEach>标签进行渲染。

测试控制器视图名以及传递的模型数据

@Test
public void houldShowRecentSpittles() throws Exception {
List<Spittle> expectedSpittles = createSpittleList(20);
SpittleRepository mockRepository = mock(SpittleRepository.class);//使用mock，利用接口创建一个实现，并创建一个实例对象
when(mockRepository.findSpittles(Long.MAX_VALUE, 20))
    .thenReturn(expectedSpittles);//调用mock实现，创建20个Spittle对象

SpittleController controller = new SpittleController(mockRepository);
MockMvc mockMvc = standaloneSetup(controller)//搭建MockMvc
    .setSingleView(new InternalResourceView("/WEB-INF/views/spittles.jsp"))
    .build();

mockMvc.perform(get("/spittles"))//对/spittles发起GET请求
   .andExpect(view().name("spittles"))//断言视图名为spittles
   .andExpect(model().attributeExists("spittleList"))
   .andExpect(model().attribute("spittleList", 
              hasItems(expectedSpittles.toArray())));
}