史上最简单的 Spring MVC 教程（十）

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”中即可。

———— ☆☆☆ —— 返回 -> 史上最简单的 Spring MVC 教程 <- 目录 —— ☆☆☆ ————