《SpringMVC从入门到放肆》十三、SpringMVC数据校验

上一章,我们学习了SpringMVC的自定义类型转换器,但是如果转换后的数据传递到Controller的方法中,忽然发现有某些属性为Null了,这怎么办?我们需要一种有效的数据校验机制,来对数据进行有效的校验。

一、什么是数据校验?

数据校验,顾名思义,就是对数据进行校验,比如在进行登录操作时,我们就需要对用户名和密码进行验证,最起码需要保证用户名和密码不能为空,其次还需要保证密码的长度在多少位之内,这就叫作数据校验。

数据校验分为客户端和服务端两种:

1、客户端校验:JS校验。

2、服务端校验:SpringMVC的validation、Struts的validation,都有自己的校验机制。

二、开发准备

1、添加JAR包

hibernate-validator-5.1.2.Final.jar

validation-api-1.1.0.Final.jar

2、MAVEN的话,需要引入以下依赖

<!-- jsr303 validation dependencies-->
<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>${javax.validation.version}</version>
</dependency>
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>${hibernate.validator.version}</version>
</dependency>

3、在spring-servlet.xml.xml中配置validator校验器

<!-- 校验器,配置validator -->
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
    <property name="providerClass" value="org.hibernate.validator.HibernateValidator"></property>
    <property name="validationMessageSource" ref="validationMessageSource"></property>
</bean>

<!-- 配置validationMessageSource -->
<bean id="validationMessageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
    <!-- 指定校验信息的资源文件的基本文件名称,不包括后缀,后缀默认是properties -->
    <property name="basenames">
        <list>
            <value>classpath:validation</value>
        </list>
    </property>
    <!-- 指定文件的编码 -->
    <property name="fileEncodings" value="utf8"></property>
    <!-- 对资源文件内容缓存的时间,单位秒 -->
    <property name="cacheSeconds" value="120"></property>
</bean>

4、将校验器注册到适配器中

方法一(推荐,如果大家用的是注解式编程,推荐使用该方法):

<mvc:annotation-driven validator="validator" />

方法二(如果大家使用非注解式变成,则可以按以下配置方法)

<!-- 自定义WebBinding -->
<bean id="myWebBinding" class="org.springframework.web.bind.support.ConfigurableWebBindingInitializer">
    <property name="validator" ref="validator" />
</bean>

<!-- 适配器 -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="webBindingInitializer" ref="myWebBinding" />
</bean>

5、validation.properties

在src/main/resources下创建validation.properties文件,该配置文件的作用就是存校验失败的提示信息,如下:

user.username.notnull=用户名不能为空
user.password.notnull=密码不能为空
user.password.size=密码长度必须为6-16位

三、具体开发

1、创建实体SysUser.java,并指定校验规则

package cn.itechyou.entity;

import java.io.Serializable;

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

public class SysUser implements Serializable {
    @NotNull(message = "{user.username.notnull}")
    private String username;
    @NotNull(message = "{user.password.notnull}")
    @Size(min = 6, max = 16, message = "{user.password.size}")
    private String password;

    //省略getter、setter
}

注意:

1:{user.username.notnull}和{user.password.size}就是读取validation.properties配置文件中配置的信息。

2:使用注解对需要进行校验的属性进行绑定,而能够使这些注解生效的前提就是配置此前的几个步骤

2、在Controller中使用

package cn.itechyou.controller;

import java.util.List;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.validation.BindingResult;
import org.springframework.validation.ObjectError;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.RequestMapping;

import cn.itechyou.entity.SysUser;

@Controller
@RequestMapping("/user")
public class UserController {
    
    /**
     * 登录
     * @param model
     * @param user
     * @param result
     * @return
     */
    @RequestMapping("/login")
    public String login(Model model,@Validated SysUser user,BindingResult result) {
        if(result.hasErrors()) {
            List<ObjectError> allErrors = result.getAllErrors();
            for (ObjectError objectError : allErrors) {
                System.out.println(objectError.getDefaultMessage());
            }
            model.addAttribute("errors", allErrors);
            return "login";
        }
        return "success";
    }
}

注意:@Validated作用是使SysUser类中的的注解生效,如果没有该注解,SysUser类中的注解则不会生效。BindingResult对象用来获取校验失败的信息(@NotNull中的message),与@Validated注解必须配对使用,一前一后。

四、运行结果

总结:其实使用起来还是很简单的,校验都为我们写好了,我们只需要使用注解配置上就好了。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

扫码关注云+社区

领取腾讯云代金券