1 前言
在史上最简单的 Spring MVC 教程（九）中，咱们已经实现了图片的上传及显示功能，那么接下来，在本篇博文中，咱们更进一步，以实体类（Person）中的字段“name”和控制器（PersonController）中的方法 updatePersonList 为例，实现参数的校验功能。
2 注解示例 - 参数校验
老规矩，首先给出项目结构图：
项目结构图
在给出代码之前， 咱们先明确参数校验的步骤：
- 导入参数校验的 jar 包；
- 在实体上配置需要校验的属性；
- 在控制器的方法中用注解 @Valid 明确开启校验；
- 校验错误后，传递错误信息；
- 返回错误页面，并提示错误信息。
其中，参数校验所需的 jar 包可以在Spring MVC框架的各种依赖包 中进行下载，然后导入到“External Libraries”之中。
第一步：修改实体类（Person），明确需要校验的属性
package spring.mvc.domain;
import javax.validation.constraints.Size;
/**
* Created by 维C果糖 on 2017/1/30.
*/
public class Person {
private Integer id;
@Size(min = 6, max = 12, message = "姓名必须大于6个字符，小于12个字符！")
private String name;
private Integer age;
private String photoPath; // 图片存储路径
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
public String getPhotoPath() {
return photoPath;
}
public void setPhotoPath(String photoPath) {
this.photoPath = photoPath;
}
@Override
public String toString() {
return "Person{" +
"id=" + id +
", name='" + name + '\'' +
", age=" + age +
'}';
}
}
第二步：在控制器（PersonController）的方法 updatePersonList 中开启校验功能
package spring.mvc.controller;
import org.apache.commons.io.FileUtils;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
import spring.mvc.domain.Person;
import spring.mvc.service.PersonService;
import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;
import javax.validation.Valid;
import java.io.File;
import java.io.IOException;
import java.util.List;
import java.util.Map;
/**
* Created by 维C果糖 on 2017/1/30.
*/
@Controller
public class PersonController {
@Resource
PersonService ps; // 注入 service 层
@RequestMapping(value = "/person/all")
public String findAll(Map<String, Object> model) { // 声明 model 用来传递数据
List<Person> personList = ps.findAll();
model.put("personList", personList); // 通过这一步，JSP 页面就可以访问 personList
return "/person/jPersonList"; // 跳转到 jPersonList 页面
}
@RequestMapping("/person/toCreatePersonInfo")
public String toCteatePersonInfo() { // 跳转新增页面
return "/person/jPersonCreate";
}
@RequestMapping("/person/toUpdatePersonInfo")
public String toUpdatePersonInfo(Integer id, Model model) { // 跳转修改页面
Person p = ps.get(id); // 获得要修改的记录，重新设置页面的值
model.addAttribute("p", p); // 将数据放到 response
return "/person/jPersonUpdate";
}
@RequestMapping("/person/updatePersonList")
public String updatePersonList(HttpServletRequest request,
@Valid Person p,
BindingResult bindingResult,
Model model,
@RequestParam("photo") MultipartFile photeFile) throws IOException { // 更新人员信息
if (p.getId() == null) {
ps.insert(p); // 调用 Service 层方法，插入数据
} else {
if(bindingResult.hasErrors()){ // 判断校验是否发现错误
model.addAttribute("bindingResult", bindingResult);
model.addAttribute("p",p);
return "/person/jPersonUpdate"; // 校验错误，返回错误页面，进行错误提示
}
String dir = request.getSession().getServletContext().getRealPath("/") + "/upload/";
String fileName = photeFile.getOriginalFilename(); // 原始的文件名
String extName = fileName.substring(fileName.lastIndexOf(".")); // 扩展名
fileName = fileName.substring(0, fileName.lastIndexOf(".")) + System.nanoTime() + extName; // 防止文件名冲突
FileUtils.writeByteArrayToFile(new File(dir + fileName), photeFile.getBytes()); // 写文件到 upload 目录
p.setPhotoPath("/upload/" + fileName);
ps.update(p); // 调用 Service 层方法，更新数据
}
return "redirect:/person/all.action"; // 转向人员列表 action
}
@RequestMapping("/person/deleteById")
public String deleteById(Integer id) { // 删除单条记录
ps.deleteById(id);
return "redirect:/person/all.action"; // 转向人员列表 action
}
@RequestMapping("/person/deleteMuch")
public String deleteMuch(String id) { // 批量删除记录
for (String delId : id.split(",")) {
ps.deleteById(Integer.parseInt(delId));
}
return "redirect:/person/all.action"; // 转向人员列表 action
}
}
第三步：修改 jPersonUpdate.jsp 页面，用于展示错误信息
<%--
Created by IntelliJ IDEA.
User: 维C果糖
Date: 2017/1/30
Time: 22:30
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<%@ taglib uri="http://www.springframework.org/tags/form" prefix="sf" %>
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>PersonList</title>
</head>
<body>
<!-- 其中，modelAttribute 属性用于接收设置在 Model 中的对象，必须设置，否则会报 500 的错误 -->
<sf:form enctype="multipart/form-data"
action="${pageContext.request.contextPath}/person/updatePersonList.action"
modelAttribute="p"
method="post">
<sf:hidden path="id"/>
<div style="padding:20px;">
修改人员信息
</div>
<div style="padding:10px;">
错误信息：<fond color="red"><sf:errors path="*"/></fond>
</div>
<table>
<tr>
<td>姓名:</td>
<td><sf:input path="name"/><sf:errors path="name"/></td>
</tr>
<tr>
<td>年龄:</td>
<td><sf:input path="age"/></td>
</tr>
<tr>
<td>图片:</td>
<td><input type="file" name="photo" value=""/></td>
</tr>
<tr>
<td colspan="2"><input type="submit" name="btnOK" value="保存"/></td>
</tr>
</table>
</sf:form>
</body>
</html>
此外，还有一点值得大家注意，那就是：在前九篇的博文中，咱们在构建项目的时候，在“WEB-INF”目录下建立了一个名为“lib”的目录，并将项目所需的 jar 都导入其中，在这里，其实不同 IDE 有不同的使用方法，例如在 Eclipse 中，我们就需要把 jar 包导入到 “lib”目录；但如果是 IntelliJ IDEA，我们则不需要建立“lib”目录，直接到 jar 包导入到“External Libraries”中即可。
