史上最简单的 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 教程 <- 目录 —— ☆☆☆ ————