資訊專欄INFORMATION COLUMN
摘要：的框架用于解決上述提到的問(wèn)題，基于模型，可以幫助開(kāi)發(fā)人員構(gòu)建靈活易擴(kuò)展的應(yīng)用。在這一章中，將專注于構(gòu)建該應(yīng)用的層，創(chuàng)建控制器和顯示，以及處理用戶注冊(cè)的表單。類有兩個(gè)靜態(tài)接口，代表兩種模擬服務(wù)的方式獨(dú)立測(cè)試和集成測(cè)試。
主要內(nèi)容
將web請(qǐng)求映射到Spring控制器
綁定form參數(shù)
驗(yàn)證表單提交的參數(shù)
寫(xiě)在前面：關(guān)于Java Web，首先推薦一篇文章——寫(xiě)給java web一年左右工作經(jīng)驗(yàn)的人，這篇文章的作者用精練的話語(yǔ)勾勒除了各種Java框架的緣由和最基本的原理。我們?cè)趯W(xué)習(xí)Spring的過(guò)程中也要切記，不僅要知道怎么做？還要深究背后的思考和權(quán)衡。
對(duì)于很多Java程序員來(lái)說(shuō)，他們的主要工作就是開(kāi)發(fā)Web應(yīng)用，如果你也在做這樣的工作，那么你一定會(huì)了解到構(gòu)建這類系統(tǒng)所面臨的挑戰(zhàn)，例如狀態(tài)管理、工作流和參數(shù)驗(yàn)證等。HTTP協(xié)議的無(wú)狀態(tài)性使得這些任務(wù)極具挑戰(zhàn)性。
Spring的web框架用于解決上述提到的問(wèn)題，基于Model-View-Controller（MVC）模型，Spring MVC可以幫助開(kāi)發(fā)人員構(gòu)建靈活易擴(kuò)展的Web
應(yīng)用。
這一章將涉及Spring MVC框架的主要知識(shí)，由于基于注解開(kāi)發(fā)是目前Spring社區(qū)的潮流，因此我們將側(cè)重介紹如何使用注解創(chuàng)建控制器，進(jìn)而處理各類web請(qǐng)求和表單提交。在深入介紹各個(gè)專題之前，首先從一個(gè)比較高的層面觀察和理解下Spring MVC的工作原理。
5.1 Spring MVC入門(mén) 5.1.1 request的處理過(guò)程用戶每次點(diǎn)擊瀏覽器界面的一個(gè)按鈕，都發(fā)出一個(gè)web請(qǐng)求（request）。一個(gè)web請(qǐng)求的工作就像一個(gè)快遞員，負(fù)責(zé)將信息從一個(gè)地方運(yùn)送到另一個(gè)地方。
從web請(qǐng)求離開(kāi)瀏覽器（1）到返回響應(yīng)，中間經(jīng)歷了幾個(gè)節(jié)點(diǎn)，在每個(gè)節(jié)點(diǎn)都進(jìn)行一些操作用于交換信息。下圖展示了Spring MVC應(yīng)用中web請(qǐng)求會(huì)遇到的幾個(gè)節(jié)點(diǎn)。
請(qǐng)求旅行的第一站是Spring的DispatcherServlet，和大多數(shù)Javaweb應(yīng)用相同，Spring MVC通過(guò)一個(gè)多帶帶的前端控制器過(guò)濾分發(fā)請(qǐng)求。當(dāng)Web應(yīng)用委托一個(gè)servlet將請(qǐng)求分發(fā)給應(yīng)用的其他組件時(shí)，這個(gè)servlert稱為前端控制器（front controller）。在Spring MVC中，DispatcherServlet就是前端控制器。
DispatcherServlet的任務(wù)是將請(qǐng)求發(fā)送給某個(gè)Spring控制器。控制器（controller）是Spring應(yīng)用中處理請(qǐng)求的組件。一般在一個(gè)應(yīng)用中會(huì)有多個(gè)控制器，DispatcherServlet來(lái)決定把請(qǐng)求發(fā)給哪個(gè)控制器處理。DispatcherServlet會(huì)維護(hù)一個(gè)或者多個(gè)處理器映射（2），用于指出request的下一站——根據(jù)請(qǐng)求攜帶的URL做決定。
一旦選好了控制器，DispatcherServlet會(huì)把請(qǐng)求發(fā)送給指定的控制器（3），控制器中的處理方法負(fù)責(zé)從請(qǐng)求中取得用戶提交的信息，然后委托給對(duì)應(yīng)的業(yè)務(wù)邏輯組件（service objects）處理。
控制器的處理結(jié)果包含一些需要傳回給用戶或者顯示在瀏覽器中的信息。這些信息存放在模型（model）中，但是直接把原始信息返回給用戶非常低效——最好格式化成用戶友好的格式，例如HTML或者JSON格式。為了生成HTML格式的文件，需要把這些信息傳給指定的視圖（view），一般而言是JSP。
控制器的最后一個(gè)任務(wù)就是將數(shù)據(jù)打包在模型中，然后指定一個(gè)視圖的邏輯名稱（由該視圖名稱解析HTML格式的輸出），然后將請(qǐng)求和模型、視圖名稱一起發(fā)送回DispatcherServlet（4）。
注意，控制器并不負(fù)責(zé)指定具體的視圖，返回給DispatcherServlet的視圖名稱也不會(huì)指定具體的JSP頁(yè)面（或者其他類型的頁(yè)面）；控制器返回的僅僅是視圖的邏輯名稱，DispatcherServlet用這個(gè)名稱查找對(duì)應(yīng)的視圖解析器（5），負(fù)責(zé)將邏輯名稱轉(zhuǎn)換成對(duì)應(yīng)的頁(yè)面實(shí)現(xiàn)，可能是JSP也可能不是。
現(xiàn)在DispatcherServlet就已經(jīng)知道將由哪個(gè)視圖渲染結(jié)果，至此一個(gè)請(qǐng)求的處理就基本完成了。最后一步就是視圖的實(shí)現(xiàn)（6），最經(jīng)典的是JSP。視圖會(huì)使用模型數(shù)據(jù)填充到視圖實(shí)現(xiàn)中，然后將結(jié)果放在HTTP響應(yīng)對(duì)象中（7）。
5.1.2 設(shè)置Spring MVC如上一小節(jié)的圖展示的，看起來(lái)需要填寫(xiě)很多配置信息。幸運(yùn)地是，Spring的最新版本提供了很多容易配置的選項(xiàng)，降低了Spring MVC的學(xué)習(xí)門(mén)檻。這里我們先簡(jiǎn)單配置一個(gè)Spring MVC應(yīng)用，作為這一章將會(huì)不斷完善的例子。
CONFIGURING DISPATCHERSERVLETDispatcherServlet是Spring MVC的核心，每當(dāng)應(yīng)用接受一個(gè)HTTP請(qǐng)求，由DispatcherServlet負(fù)責(zé)將請(qǐng)求分發(fā)給應(yīng)用的其他組件。
在舊版本中，DispatcherServlet之類的servlet一般在web.xml文件中配置，該文件一般會(huì)打包進(jìn)最后的war包種；但是Spring 3引入了注解，我們?cè)谶@一章將展示如何基于注解配置Spring MVC。
既然不適用web.xml文件，你需要在servlet容器中使用Java配置DispatcherServlet，具體的代碼列舉如下：
package org.test.spittr.config;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
public class SpittrWebAppInitializer
extends AbstractAnnotationConfigDispatcherServletInitializer {
@Override
protected Class[] getRootConfigClasses() { //根容器
return new Class[] { RootConfig.class };
}
@Override
protected Class[] getServletConfigClasses() { //Spring mvc容器
return new Class[] { WebConfig.class };
}
@Override
protected String[] getServletMappings() { //DispatcherServlet映射,從"/"開(kāi)始
return new String[] { "/" };
}
}
spitter這個(gè)單詞是我們應(yīng)用的名稱，SpittrWebAppInitializer類是整個(gè)應(yīng)用的總配置類。
AbstractAnnotationConfigDispatcherServletInitializer這個(gè)類負(fù)責(zé)配置DispatcherServlet、初始化Spring MVC容器和Spring容器。getRootConfigClasses()方法用于獲取Spring應(yīng)用容器的配置文件，這里我們給定預(yù)先定義的RootConfig.class；getServletConfigClasses負(fù)責(zé)獲取Spring MVC應(yīng)用容器，這里傳入預(yù)先定義好的WebConfig.class；getServletMappings()方法負(fù)責(zé)指定需要由DispatcherServlet映射的路徑，這里給定的是"/"，意思是由DispatcherServlet處理所有向該應(yīng)用發(fā)起的請(qǐng)求。
A TALE OF TWO APPLICATION CONTEXT當(dāng)DispatcherServlet啟動(dòng)時(shí)，會(huì)創(chuàng)建一個(gè)Spring MVC應(yīng)用容器并開(kāi)始加載配置文件中定義好的beans。通過(guò)getServletConfigClasses()方法，可以獲取由DispatcherServlet加載的定義在WebConfig.class中的beans。
在Spring Web應(yīng)用中，還有另一個(gè)Spring應(yīng)用容器，這個(gè)容器由ContextLoaderListener創(chuàng)建。
我們希望DispatcherServlet僅加載web組件之類的beans，例如controllers（控制器）、view resolvers（視圖解析器）和處理器映射（handler mappings）；而希望ContextLoaderListener加載應(yīng)用中的其他類型的beans——例如業(yè)務(wù)邏輯組件、數(shù)據(jù)庫(kù)操作組件等等。
實(shí)際上，AbstractAnnotationConfigDispatcherServletInitializer創(chuàng)建了DispatcherServlet和ContextLoaderListener：getServletConfigClasses()返回的配置類定義了Spring MVC應(yīng)用容器中的beans；getRootConfigClasses()返回的配置類定義了Spring應(yīng)用根容器中的beans。【書(shū)中沒(méi)有說(shuō)的】：Spring MVC容器是根容器的子容器，子容器可以看到根容器中定義的beans，反之不行。
注意：通過(guò)AbstractAnnotationConfigDispatcherServletInitializer配置DispatcherServlet僅僅是傳統(tǒng)的web.xml文件方式的另一個(gè)可選項(xiàng)。盡管你也可以使用AbstractAnnotationConfigDispatcherServletInitializer的一個(gè)子類引入web.xml文件來(lái)配置，但這沒(méi)有必要。
這種方式配置DispatcherServlet需要支持Servlert 3.0的容器，例如Apache Tomcat 7或者更高版本的。
ENABLING SPRING MVC正如可以通過(guò)多種方式配置DispatcherServlet一樣，也可以通過(guò)多種方式啟動(dòng)Spring MVC特性。原來(lái)我們一般在xml文件中使用
這里我們?nèi)匀皇褂肑avaConfig配置，最簡(jiǎn)單的Spring MVC配置類代碼如下：
package org.test.spittr.config;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
@Configuration
@EnableWebMvc
public class WebConfig {
}
@Configuration表示這是Java配置類；@EnableWebMvc注解用于啟動(dòng)Spring MVC特性。
僅僅這些代碼就可以啟動(dòng)Spring MVC了，雖然它換缺了一些必要的組件：
沒(méi)有配置視圖解析器。這種情況下，Spring會(huì)使用BeanNameViewResolver，這個(gè)視圖解析器通過(guò)查找ID與邏輯視圖名稱匹配且實(shí)現(xiàn)了View接口的beans。
沒(méi)有啟動(dòng)Component-scanning。
DispatcherServlet作為默認(rèn)的servlet，將負(fù)責(zé)處理所有的請(qǐng)求，包括對(duì)靜態(tài)資源的請(qǐng)求，例如圖片和CSS文件等。
因此，我們還需要在配置文件中增加一些配置，使得這個(gè)應(yīng)用可以完成最簡(jiǎn)單的功能，代碼如下：
package org.test.spittr.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.ViewResolver;
import org.springframework.web.servlet.config.annotation.DefaultServletHandlerConfigurer;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
import org.springframework.web.servlet.view.InternalResourceViewResolver;
@Configuration
@EnableWebMvc
@ComponentScan("org.test.spittr.web")
public class WebConfig extends WebMvcConfigurerAdapter{
@Bean
public ViewResolver viewResolver() { //配置JSP視圖解析器
InternalResourceViewResolver resolver = new InternalResourceViewResolver();
resolver.setPrefix("/WEB-INF/views/");
resolver.setSuffix(".jsp");
//可以在JSP頁(yè)面中通過(guò)${}訪問(wèn)beans
resolver.setExposeContextBeansAsAttributes(true);
return resolver;
}
@Override
public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
configurer.enable(); //配置靜態(tài)文件處理
}
}
首先，通過(guò)@ComponentScan("org.test.spittr.web")注解指定bean的自動(dòng)發(fā)現(xiàn)機(jī)制作用的范圍，待會(huì)會(huì)看到，被@Controller等注解修飾的web的bean將被發(fā)現(xiàn)并加載到spring mvc應(yīng)用容器。這樣就不需要在配置類中顯式定義任何控制器bean了。
然后，你通過(guò)@Bean注解添加一個(gè)ViewResolverbean，具體來(lái)說(shuō)是InternalResourceViewResolver。后面我們會(huì)專門(mén)探討視圖解析器，這里的三個(gè)函數(shù)的含義依次是：setPrefix()方法用于設(shè)置視圖路徑的前綴；setSuffix()用于設(shè)置視圖路徑的后綴，即如果給定一個(gè)邏輯視圖名稱——"home"，則會(huì)被解析成"/WEB-INF/views/home.jsp"； setExposeContextBeansAsAttributes(true)使得可以在JSP頁(yè)面中通過(guò)${ }訪問(wèn)容器中的bean。
最后，WebConfig繼承了WebMvcConfigurerAdapter類，然后覆蓋了其提供的configureDefaultServletHandling()方法，通過(guò)調(diào)用configer.enable()，DispatcherServlet將會(huì)把針對(duì)靜態(tài)資源的請(qǐng)求轉(zhuǎn)交給servlert容器的default servlet處理。
RootConfig的配置就非常簡(jiǎn)單了，唯一需要注意的是，它在設(shè)置掃描機(jī)制的時(shí)候，將之前WebConfig設(shè)置過(guò)的那個(gè)包排除了；也就是說(shuō)，這兩個(gè)掃描機(jī)制作用的范圍正交。RootConfig的代碼如下：
package org.test.spittr.config;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.FilterType;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
@Configuration
@ComponentScan(basePackages = {"org.test.spittr"},
excludeFilters = {@ComponentScan.Filter(type = FilterType.ANNOTATION, value = EnableWebMvc.class)})
public class RootConfig {
}
5.1.3 Spittr應(yīng)用簡(jiǎn)介
這一章要用的例子應(yīng)用，從Twitter獲取了一些靈感，因此最開(kāi)始叫Spitter；然后又借鑒了最近比較流行的網(wǎng)站Flickr，因此我們也把e去掉，最終形成Spittr這個(gè)名字。這也有利于區(qū)分領(lǐng)域名稱（類似于twitter，這里用spring實(shí)現(xiàn)，因此叫spitter）和應(yīng)用名稱。
Spittr應(yīng)用有兩個(gè)關(guān)鍵的領(lǐng)域概念：spitters（應(yīng)用的用戶）和spittles（用戶發(fā)布的狀態(tài)更新）。在這一章中，將專注于構(gòu)建該應(yīng)用的web層，創(chuàng)建控制器和顯示spittles，以及處理用戶注冊(cè)的表單。
基礎(chǔ)已經(jīng)打好了，你已經(jīng)配置好了DispatcherServlet，啟動(dòng)了Spring MVC特性等，接下來(lái)看看如何編寫(xiě)Spring MVC控制器。
5.2 編寫(xiě)簡(jiǎn)單的控制器在Spring MVC應(yīng)用中，控制器類就是含有被@RequestMapping注解修飾的方法的類，其中該注解用于指出這些方法要處理的請(qǐng)求類型。
我們從最簡(jiǎn)單的請(qǐng)求"/"開(kāi)始，用于渲染該應(yīng)用的主頁(yè)，HomeController的代碼列舉如下：
package org.test.spittr.web;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
@Controller
public class HomeController {
@RequestMapping(value = "/", method = RequestMethod.GET)
public String home() {
return "home";
}
}
@Controller是一個(gè)模式化的注解，它的作用跟@Component一樣；Component-scanning機(jī)制會(huì)自動(dòng)發(fā)現(xiàn)該控制器，并在Spring容器中創(chuàng)建對(duì)應(yīng)的bean。
HomeController中的home()方法用于處理http://localhost:8080/這個(gè)URL對(duì)應(yīng)的"/"請(qǐng)求，且僅處理GET方法，方法的內(nèi)容是返回一個(gè)邏輯名稱為"home"的視圖。DispatcherServlet將會(huì)讓視圖解析器通過(guò)這個(gè)邏輯名稱解析出真正的視圖。
根據(jù)之前配置的InternalResourceViewResolver，最后解析成/WEB-INF/views/home.jsp，home.jsp的內(nèi)容列舉如下：
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" session="false" %>
Spittr
Welcome to Spittr
">Spittles
">Register
啟動(dòng)應(yīng)用，然后訪問(wèn)http://localhost:8080/，Spittr應(yīng)用的主頁(yè)如下圖所示：
控制器的測(cè)試通過(guò)Mockito框架進(jìn)行，首先在pom文件中引入需要的依賴庫(kù)：
org.springframework spring-test org.mockito mockito-all ${mockito.version} junit junit ${junit.version}
然后，對(duì)應(yīng)的單元測(cè)試用例HomeControllerTest的代碼如下所示：
package org.test.spittr.web;
import org.junit.Before;import org.junit.Test;
import org.springframework.test.web.servlet.MockMvc;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
import static org.springframework.test.web.servlet.setup.MockMvcBuilders.*;
public class HomeControllerTest {
MockMvc mockMvc;
@Before
public void setupMock() {
HomeController controller = new HomeController();
mockMvc = standaloneSetup(controller).build();
}
@Test
public void testHomePage() throws Exception {
mockMvc.perform(get("/"))
.andExpect(view().name("home"));
}
}
首先stanaloneSetup()方法通過(guò)HomeController的實(shí)例模擬出一個(gè)web服務(wù)，然后使用perform執(zhí)行對(duì)應(yīng)的GET請(qǐng)求，并檢查返回的視圖的名稱。MockMvcBuilders類有兩個(gè)靜態(tài)接口，代表兩種模擬web服務(wù)的方式：獨(dú)立測(cè)試和集成測(cè)試。上面這段代碼是獨(dú)立測(cè)試，我們也嘗試了集成測(cè)試的方式，最終代碼如下：
package org.test.spittr.web;
import org.junit.Before;import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.ContextHierarchy;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import org.springframework.test.context.web.WebAppConfiguration;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.web.context.WebApplicationContext;
import org.test.spittr.config.RootConfig;
import org.test.spittr.config.WebConfig;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
import static org.springframework.test.web.servlet.setup.MockMvcBuilders.*;
@RunWith(SpringJUnit4ClassRunner.class)
@WebAppConfiguration(value = "src/main/webapp")
@ContextHierarchy({
@ContextConfiguration(name = "parent", classes = RootConfig.class),
@ContextConfiguration(name = "child", classes = WebConfig.class)})
public class HomeControllerTest {
@Autowired
private WebApplicationContext context;
MockMvc mockMvc;
@Before
public void setupMock() {
//HomeController controller = new HomeController();
//mockMvc = standaloneSetup(controller).build();
mockMvc = webAppContextSetup(context).build();
}
@Test
public void testHomePage() throws Exception {
mockMvc.perform(get("/"))
.andExpect(view().name("home"));
}
}
5.2.2 定義類級(jí)別的請(qǐng)求處理
上面一節(jié)對(duì)之前的HomeController進(jìn)行了簡(jiǎn)單的測(cè)試，現(xiàn)在可以對(duì)它進(jìn)行進(jìn)一步的完善：將@RequestMapping從修飾函數(shù)改成修飾類，代碼如下：
package org.test.spittr.web;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
@Controller
@RequestMapping(value = "/")
public class HomeController {
@RequestMapping(method = RequestMethod.GET)
public String home() {
return "home";
}
}
在新的HomeController中，"/"被移動(dòng)到類級(jí)別的@RequestMapping中，而定義HTTP方法的@RequestMapping仍然用于修飾home()方法。RequestMapping注解可以接受字符串?dāng)?shù)組，即可以同時(shí)映射多個(gè)路徑，因此我們還可以按照下面這種方式修改：
@Controller
@RequestMapping({"/", "/homepage"})
public class HomeController {
}
}
5.2.3 給視圖傳入模型數(shù)據(jù)
對(duì)于DispatcherServlet傳來(lái)的請(qǐng)求，控制器通常不會(huì)實(shí)現(xiàn)具體的業(yè)務(wù)邏輯，而是調(diào)用業(yè)務(wù)層的接口，并且將業(yè)務(wù)層服務(wù)返回的數(shù)據(jù)放在模型對(duì)象中返回給DispatcherServlet。
在Spittr應(yīng)用中，需要一個(gè)頁(yè)面顯示最近的spittles列表。首先需要定義數(shù)據(jù)庫(kù)存取接口，這里不需要提供具體實(shí)現(xiàn)，只需要用Mokito框架填充模擬測(cè)試數(shù)據(jù)即可。SpittleRepository接口的代碼列舉如下：
package org.test.spittr.data;
import java.util.List;
public interface SpittleRepository {
List findSpittles(long max, int count);
}
SpittleRepository接口中的findSpittles()方法有兩個(gè)參數(shù)：max表示要返回的Spittle對(duì)象的最大ID；count表示指定需要返回的Spittle對(duì)象數(shù)量。為了返回20個(gè)最近發(fā)表的Spittle對(duì)象，則使用List
package org.test.spittr.data;
import org.apache.commons.lang.builder.EqualsBuilder;
import org.apache.commons.lang.builder.HashCodeBuilder;
import java.util.Date;
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.time = time;
this.latitude = latitude;
this.longitude = longitude;
this.message = message;
}
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 obj) {
return EqualsBuilder.reflectionEquals(this, obj,
new String[]{"message","latitude", "longitude"});
}
@Override
public int hashCode() {
return HashCodeBuilder.reflectionHashCode(this,
new String[]{"message", "latitude", "longitude"});
}
}
Spittle對(duì)象還是POJO，并沒(méi)什么復(fù)雜的。唯一需要注意的就是，利用Apache Commons Lang庫(kù)的接口，用于簡(jiǎn)化equals和hashCode方法的實(shí)現(xiàn)。參考Apache Commons EqualsBuilder and HashCodeBuilder
首先為新的控制器接口寫(xiě)一個(gè)測(cè)試用例，利用Mockito框架模擬repository對(duì)象，并模擬出request請(qǐng)求，代碼如下：
package org.test.spittr.web;
import org.junit.Test;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.web.servlet.view.InternalResourceView;
import org.test.spittr.data.Spittle;import org.test.spittr.data.SpittleRepository;import java.util.ArrayList;
import java.util.Date;import java.util.List;
import static org.hamcrest.Matchers.hasItems;
import static org.mockito.Mockito.*;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
import static org.springframework.test.web.servlet.setup.MockMvcBuilders.*;
public class SpittleControllerTest {
@Test
public void shouldShowRecentSpittles() throws Exception {
//step1 準(zhǔn)備測(cè)試數(shù)據(jù)
List expectedSpittles = createSpittleList(20);
SpittleRepository mockRepository = mock(SpittleRepository.class);
when(mockRepository.findSpittles(Long.MAX_VALUE, 20))
.thenReturn(expectedSpittles);
SpittleController controller = new SpittleController(mockRepository);
MockMvc mockMvc = standaloneSetup(controller)
.setSingleView(new InternalResourceView("/WEB-INF/views/spittles.jsp"))
.build();
//step2 and step3
mockMvc.perform(get("/spittles"))
.andExpect(view().name("spittles"))
.andExpect(model().attributeExists("spittleList"))
.andExpect(model().attribute("spittleList",
hasItems(expectedSpittles.toArray())));
}
private List createSpittleList(int count) {
List spittles = new ArrayList();
for (int i = 0; i < count; i++) {
spittles.add(new Spittle("Spittle " + i, new Date()));
}
return spittles;
}
}
單元測(cè)試的基本組成是：準(zhǔn)備測(cè)試數(shù)據(jù)、調(diào)用待測(cè)試接口、校驗(yàn)接口的執(zhí)行結(jié)果。對(duì)于shouldShowRecentSpittles()這個(gè)用例我們也可以這么分割：首先規(guī)定在調(diào)用SpittleRepository接口的findSpittles()方法時(shí)將返回20個(gè)Spittle對(duì)象。
這里選擇獨(dú)立測(cè)試，跟HomeControllerTest不同的地方在于，這里構(gòu)建MockMvc對(duì)象時(shí)還調(diào)用了setSingleView()函數(shù)，這是為了防止mock框架從控制器解析view名字。在很多情況下并沒(méi)有這個(gè)必要，但是對(duì)于SpittleController控制器來(lái)說(shuō)，視圖名稱和路徑名稱相同，如果使用默認(rèn)的視圖解析器，則MockMvc會(huì)混淆這兩者而失敗，報(bào)出如下圖所示的錯(cuò)誤：
在這里其實(shí)可以隨意設(shè)置InternalResourceView的路徑，但是為了和WebConfig中的配置相同。
通過(guò)get方法構(gòu)造GET請(qǐng)求，訪問(wèn)"/spittles"，并確保返回的視圖名稱是"spittles"，返回的model數(shù)據(jù)中包含spittleList屬性，且對(duì)應(yīng)的值為我們之前創(chuàng)建的測(cè)試數(shù)據(jù)。
最后，為了使用hasItems，需要在pom文件中引入hamcrest庫(kù)，代碼如下
org.hamcrest hamcrest-library 1.3
現(xiàn)在跑單元測(cè)試的話，必然會(huì)失敗，因?yàn)槲覀冞€沒(méi)有提供SpittleController的對(duì)應(yīng)方法，代碼如下：
package org.test.spittr.web;
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 org.test.spittr.data.SpittleRepository;
@Controller
@RequestMapping("/spittles")
public class SpittleController {
private SpittleRepository spittleRepository;
@Autowired
SpittleController(SpittleRepository spittleRepository) {
this.spittleRepository = spittleRepository;
}
@RequestMapping(method = RequestMethod.GET)
public String spittles(Model model) {
model.addAttribute(
spittleRepository.findSpittles(Long.MAX_VALUE, 20));
return "spittles";
}
}
Model對(duì)象本質(zhì)上是一個(gè)Map，spittles方法負(fù)責(zé)填充數(shù)據(jù)，然后跟視圖的邏輯名稱一起回傳給DispatcherServlet。在調(diào)用addAttribute方法的時(shí)候，如果不指定key字段，則key字段會(huì)從value的類型推導(dǎo)出，在這個(gè)例子中默認(rèn)的key字段是spittleList。
如果你希望顯式指定key字段，則可以按照如下方式指定：
@RequestMapping(method = RequestMethod.GET)
public String spittles(Model model) {
model.addAttribute("spittleList",
spittleRepository.findSpittles(Long.MAX_VALUE, 20));
return "spittles";
}
另外，如果你希望盡量少使用Spring規(guī)定的數(shù)據(jù)類型，則可以使用Map代替Model。
還有另一種spittles方法的實(shí)現(xiàn)，如下所示：
@RequestMapping(method = RequestMethod.GET) public Listspittles() { return spittleRepository.findSpittles(Long.MAX_VALUE, 20)); }
這個(gè)版本和之前的不同，并沒(méi)有返回一個(gè)邏輯名稱以及顯式設(shè)置Model對(duì)象，這個(gè)方法直接返回Spittle列表。在這種情況下，Spring會(huì)將返回值直接放入Model對(duì)象，并從值類型推導(dǎo)出對(duì)應(yīng)的關(guān)鍵字key；然后從路徑推導(dǎo)出視圖邏輯名稱，在這里是spittles。
無(wú)論你選擇那種實(shí)現(xiàn)，最終都需要一個(gè)頁(yè)面——spittles.jsp。JSP頁(yè)面使用JSTL庫(kù)的
