首页 > 代码库 > SpringMVC之表单校验

SpringMVC之表单校验

2024-09-02 12:44:02   221人阅读

　　SpringMVC已经实现了对Java校验API（JSR-303）的支持，通过使用该API可以实现对数据的校验。要使用SpringMVC的Java校验API并不需要任何配置，只要引入其实现即可。本文使用hibernate-validator 5.2.4。

　　首先使用Maven使用hibernate-validator 5.2.4。接着就可以直接使用了。本文使用场景为注册，注册时需要提供用户名、密码以及出生日期，用户名以及密码的长度为5到20，出生日期必须为过去时间。

　　首先使用Java校验API提供的注解来注解需要校验的bean，具体的注解在本文最后列出注册前的数据校验

package cn.powerfully.demo.domain;

import java.util.Date;

import javax.validation.constraints.NotNull;
import javax.validation.constraints.Past;
import javax.validation.constraints.Size;

public class User {
    @NotNull
    @Size(min = 5, max = 20)
    private String username;
    @NotNull
    @Size(min = 5, max = 20)
    private String password;
    @NotNull
    @Past
    private Date birth;

    public Date getBirth() {
        return birth;
    }

    public void setBirth(Date birth) {
        this.birth = birth;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String passwrod) {
        this.password = passwrod;
    }

}

　　对于Controller中方法，使用bean来传递参数，使用@Validated注解该参数表示该bean需要进行校验，并且该方法中必须要有类型为Errors的参数（当然实现了Errors旗下的都可以，例如BindingResult）。

@RequestMapping(path = "register", method = RequestMethod.POST)
public String doRegister(Model model, @Validated User user, Errors errors) {
    if (errors.hasErrors()) {
        model.addAttribute("errors", errors);
        return "register";
    }
    // ...
    model.addAttribute(user);
    return "msg";
}

　　如果校验存在错误，则将错误信息存放在request中并转发到注册表单。对于jsp页面，从request域中获取错误信息。　　

<%@ page language="java" contentType="text/html; charset=UTF-8"
    isELIgnored="false" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
    <h1>注册</h1>
    <br>
    <form method="post"
        action="${pageContext.request.contextPath }/user/register">
        <input type="text" name="username" placeholder="用户名"> ${errors.getFieldError("username").defaultMessage }<br>
        <input type="password" name="password" placeholder="密码"> ${errors.getFieldError("password").defaultMessage }<br>
        <input type="date" name="birth" placeholder="出生日期"> ${errors.getFieldError("birth").defaultMessage }<br> <input
            type="submit" value="注册">
    </form>
</body>
</html>

　　JAVA EE6以上版本中EL表达式可以直接调用方法，不可以直接使用errors.fieldError["username"].defaultMessage，因为fieldError在其实现类里面并不是一个数组或集合。效果如下：

技术分享

　　关于错误信息的显示，还有更方便的方法，那就是使用Spring提供的Jsp标签，关于Spring的JSP标签，这里就不写了。

　　如果先自定义错误信息，可以编写ValidationMessages.properties文件并置于类目录，在properties文件里下：

username.size=用户名长度必须为{min}到{max}
password.size=密码长度必须为{min}到{max}
birth.notNull=日期不能为空
birth.past=日期必须是过去的

　　在bean注解时，使用message属性来指定错误信息：

@NotNull
@Size(min = 5, max = 20, message = "{username.size}")
private String username;
@NotNull
@Size(min = 5, max = 20, message = "{password.size}")
private String password;
@NotNull(message = "{birth.notNull}")
@Past(message = "{birth.past}")
private Date birth;

　　如果想使用国际化，需要创建ValidationErrors_xx.properties。

以下是Java校验API提供的校验注解

注解 描述
@AssertFalse  注解在Boolean类型上，并且值为false
@AssertTrue  注解在Boolean类型上，并且值为true 
@DecimalMax  所注解的元素必须是数字， 并且它的值要小于或等于给定的BigDecimalString值
@DecimalMin  所注解的元素必须是数字， 并且它的值要大于或等于给定的BigDecimalString值
@Digits  所注解的元素必须是数字， 并且它的值必须有指定的位数
@Future  所注解的元素的值必须是一个将来的日期
@Max  所注解的元素必须是数字， 并且它的值要小于或等于给定的值
@Min  所注解的元素必须是数字， 并且它的值要大于或等于给定的值
@NotNull  所注解元素的值必须不能为null
@Null  所注解元素的值必须为null
@Past  所注解的元素的值必须是一个已过去的日期
@Pattern  所注解的元素的值必须匹配给定的正则表达式
@Size  所注解的元素的值必须是String、 集合或数组， 并且它的长度要符合给定的范围

SpringMVC之表单校验


联系
我们