笔记25 传递模型数据到视图中

在 Spittr应用中，我们需要有一个页面展现最近提交的Spittle列表。因此，我们需要一个新的方法来处理这个页面。

1.首先，需要定义一个数据访问的Repository。为了实现解耦以及避免 陷入数据库访问的细节之中，我们将Repository定义为一个接口，并在稍后实现它我们只需要一个能够获取Spittle 列表的Repository，如下所示的SpittleRepository.java

findSpittles()方法接受两个参数。其中max参数代表所返回的 Spittle中，Spittle ID属性的最大值，而count参数表明要返回多少个Spittle对象，调用时以findSpittles(Long.MAX_VALUE，20)这样的方式。

package spittr.data;

import java.util.List;

import org.springframework.stereotype.Component;

import spittr.spittle.Spittle;

@Component
public interface SpittleRepository {
    List<Spittle> findSpittles(long max, int count);

}

2.然后创建它的实现类JdbcSpittleRepository.java用来访问数据库，然后读取数据，但是目前还不需要对数据库进行操作，所以需要自己做一下假数据。

package spittr.data;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

import spittr.spittle.Spittle;

public class JdbcSpittleRepository implements SpittleRepository {

    private List<Spittle> createSpittleList(int count) {
        List<Spittle> spittles = new ArrayList<Spittle>();
        for (int i = 0; i < count; i++) {
            spittles.add(new Spittle("Spittle" + i, new Date()));
        }
        return spittles;
    }

    @Override
    public List<Spittle> findSpittles(long max, int count) {
        // TODO Auto-generated method stub

        return createSpittleList(count);
    }

}

有一个createSpittleList方法，根据传入的数值，创建相应条目的数据。然后由findSpittles进行返回。

3.创建Spittle类，包含消息内容、时间戳和位置信息

package spittr.spittle;

import java.util.Date;

import org.apache.commons.lang3.builder.EqualsBuilder;
import org.apache.commons.lang3.builder.HashCodeBuilder;

public class Spittle {
    private final Long id;
    private final String message;
    private final Date time;
    private Double latitude;
    private Double longitude;

    public Spittle(String message, Date time) {
        this(message, time, null, null);
    }

    public Spittle(String message, Date time, Double latitude, Double longitude) {
        this.id = null;
        this.message = message;
        this.time = time;
        this.latitude = latitude;
        this.longitude = longitude;
    }

    public long getId() {
        return id;
    }

    public String getMessage() {
        return message;
    }

    public Date getTime() {
        return time;
    }

    public Double getLongitude() {
        return longitude;
    }

    public Double getLatitude() {
        return latitude;
    }

    @Override
    public boolean equals(Object that) {
        return EqualsBuilder.reflectionEquals(this, that, "id", "time");
    }

    @Override
    public int hashCode() {
        return HashCodeBuilder.reflectionHashCode(this, "id", "time");
    }
}

4.创建控制器，SpittleController.java

package spittr.web;

import java.util.List;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import spittr.data.JdbcSpitterRepository;
import spittr.data.SpittleRepository;
import spittr.spittle.Spittle;

@Controller

public class SpittleController {
    private SpittleRepository spittleRepository;

    @Autowired
    public SpittleController(SpittleRepository spittleRepository) { // 注入SpittleRepository
        this.spittleRepository = spittleRepository;
    }

    @RequestMapping(value = "spittles", method = RequestMethod.GET)
    public String spittles(Model model) {
        // 将spittle添加到模型中
        SpittleRepository spittleRepository = new JdbcSpittleRepository();
        List<Spittle> data = spittleRepository.findSpittles(Long.MAX_VALUE, 20);
        model.addAttribute(data);
        return "spittles"; // 返回视图名
    }

}

到SpittleController有一个构造器，这个构造器使 用了@Autowired注解，用来注入SpittleRepository。这 个SpittleRepository随后又用在spittles()方法中，用来获 取最新的spittle列表。在spittles()方法中给定了一个Model作为参数。这样，spittles()方法就能将Repository中获取到的 Spittle列表填充到模型中。Model实际上就是一个Map（也就是 key-value对的集合），它会传递给视图，这样数据就能渲染到客户端 了。当调用addAttribute()方法并且不指定key的时候，那么key会 根据值的对象类型推断确定。在本例中，因为它是一 个List<Spittle>，因此，键将会推断为spittleList。spittles()方法所做的最后一件事是返回spittles作为视图的名字，这个视图会渲染模型。也可以显式声明模型的key，如下代码：

    public String spittles(Model model) {
        // 将spittle添加到模型中
        SpittleRepository spittleRepository = new JdbcSpittleRepository();
        List<Spittle> data = spittleRepository.findSpittles(Long.MAX_VALUE, 20);
        model.addAttribute("spittleList", data);
        return "spittles"; // 返回视图名
    }

也可以用java.util.Map来代替Model。

@RequestMapping(value = "spittles", method = RequestMethod.GET)
    public String spittles(Map<String, List<Spittle>> model) {
        SpittleRepository spittleRepository = new JdbcSpittleRepository();
        List<Spittle> data = spittleRepository.findSpittles(Long.MAX_VALUE, 20);
        model.put("spittles", data);
        return "spittles";
    }

不管你选择哪种方式来编写spittles()方法，所达成的结果都是相同的。模型中会存储一个Spittle列表，key为spittleList，然 后这个列表会发送到名为spittles的视图中。按照我们配 置InternalResourceViewResolver的方式，视图的JSP将会 是“/WEB-INF/views/spittles.jsp”。 

5.创建模型视图spittles.jsp

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%@ taglib prefix="c"  uri="http://java.sun.com/jsp/jstl/core"%>
<%@ taglib prefix="s" uri="http://www.springframework.org/tags"%>
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>Spitter</title>
    <link rel="stylesheet" type="text/css" href="<c:url value="/resources/style.css" />" >
  </head>
  <body>
    <div class="spittleForm">
      <h1>Spit it out...</h1>
      <form method="POST" name="spittleForm">
        <input type="hidden" name="latitude">
        <input type="hidden" name="longitude">
        <textarea name="message" cols="80" rows="5"></textarea><br/>
        <input type="submit" value="Add" />
      </form>
    </div>
    <div class="listTitle">
      <h1>Recent Spittles</h1>
      <ul class="spittleList">
        <c:forEach items="${spittleList}" var="spittle" >
          <li id="spittle_<c:out value="spittle.id"/>">
            <div class="spittleMessage"><c:out value="${spittle.message}" /></div>
            <div>
              <span class="spittleTime"><c:out value="${spittle.time}" /></span>
              <span class="spittleLocation">(<c:out value="${spittle.latitude}" />, <c:out value="${spittle.longitude}" />)</span>
            </div>
          </li>
        </c:forEach>
      </ul>

    </div>
  </body>
</html>

6.测试

单元测试：

单元测试类SpittleControllerTest.java

package spittr.test;

import static org.hamcrest.CoreMatchers.hasItems;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.model;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.view;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

import org.junit.Test;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import org.springframework.web.servlet.view.InternalResourceView;

import spittr.data.SpittleRepository;
import spittr.spittle.Spittle;
import spittr.web.SpittleController;

public class SpittleControllerTest {

    @Test
    public void shouldShowRecentSpittles() throws Exception {
        List<Spittle> expectedSpittles = createSpittleList(20);
        SpittleRepository mockRepository = mock(SpittleRepository.class);
        when(mockRepository.findSpittles(Long.MAX_VALUE, 20)).thenReturn(expectedSpittles);

        SpittleController controller = new SpittleController(mockRepository);

        MockMvc mockMvc = MockMvcBuilders.standaloneSetup(controller)
                .setSingleView(new InternalResourceView("/WEB-INF/views/spittles.jsp")).build();
        mockMvc.perform(get("/spittles")).andExpect(view().name("spittles"))
                .andExpect(model().attributeExists("spittleList"))
                .andExpect(model().attribute("spittleList", hasItems(expectedSpittles.toArray())));
    }

    private List<Spittle> createSpittleList(int count) {
        List<Spittle> spittles = new ArrayList<Spittle>();
        for (int i = 0; i < count; i++) {
            spittles.add(new Spittle("Spittle" + i, new Date()));
        }
        return spittles;
    }
}

这个测试首先会创建SpittleRepository接口的mock实现，这个 实现会从它的findSpittles()方法中返回20个Spittle对象。然后，它将这个Repository注入到一个新的SpittleController 实例中，然后创建MockMvc并使用这个控制器。

与HomeController不同，这个测试在MockMvc构 造器上调用了setSingleView()。这样的话，mock框架就不用解析 控制器中的视图名了。在很多场景中，其实没有必要这样做。但是对 于这个控制器方法，视图名与请求路径是非常相似的，这样按照默认 的视图解析规则时，MockMvc就会发生失败，因为无法区分视图路 径和控制器的路径。

在这个测试中，构建InternalResourceView 时所设置的实际路径是无关紧要的，但我们将其设置为 与InternalResourceViewResolver配置一致。这个测试对“/spittles”发起GET请求，然后断言视图的名称为spittles并 且模型中包含名为spittleList的属性，在spittleList中包含 预期的内容。 

服务器上测试：

结果

7.配置文件RootConfig.java、SpittrWebAppInitializer.java、WebConfig.java参照笔记23