SpringMVC框架 -- 注解开发validation校验

一.对于校验理解

项目中，通常使用较多是前端的校验

在服务端校验：

• 控制层conroller：校验页面请求的参数的合法性。在服务端控制层conroller校验，不区分客户端类型（浏览器、手机客户端、远程调用）
• 业务层service（使用较多）：主要校验关键业务参数，仅限于service接口中使用的参数。
• 持久层dao：一般是不校验的。

二.springmvc校验

校验思路：
页面提交请求的参数，请求到controller方法中，使用validation进行校验。如果校验出错，将错误信息展示到页面。
需要的jar包：
hibernate-validator.jar
jboss-logging.jar
validation-api.jar

1.maven依赖:

<!-- hibernate 校验 -->
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>5.2.4.Final</version>
</dependency>

2.在SpringMVC配置文件中添加配置校验器

<!--validation校验-->
    <bean id="validator"
          class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
        <!-- hibernate校验器-->
        <property name="providerClass" value="org.hibernate.validator.HibernateValidator" />
        <!-- 指定校验使用的资源文件，在文件中配置校验错误信息，如果不指定则默认使用classpath下的ValidationMessages.properties -->
        <property name="validationMessageSource" ref="messageSource" />
    </bean>
    <!-- 校验错误信息配置文件 -->
    <bean id="messageSource"
          class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
        <!-- 资源文件名-->
        <property name="basenames">
            <list>
                <value>CustomValidationMessages</value>
            </list>
        </property>
        <!-- 资源文件编码格式 -->
        <property name="fileEncodings" value="utf-8" />
        <!-- 对资源文件内容缓存时间，单位秒 -->
        <property name="cacheSeconds" value="120" />
    </bean>

3.校验器注入到处理器适配器中

<mvc:annotation-driven validator="validator" conversion-service="conversionService"/>

4.在pojo校验错误信息：

• user.java

public class User {
    private int id;

    @NotNull(message = "{user.name.isNull}")
    private String userName;
    @Size(min = 6,max = 40,message = "{user.password.length.error}")
    private String passWord;
    省略get&set方法........
}

4.在CustomValidationMessages.properties配置校验错误信息：

• CustomValidationMessages.properties

user.name.isNull = 用户名不能为空
user.password.length.error = 请输入名称6-40字符密码

5.捕获和显示校验错误信息

package com.huan.web.UserInfo;

import com.huan.entity.User;
import com.huan.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.validation.BindingResult;
import org.springframework.validation.ObjectError;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import java.util.List;

/**
 * Created by ubuntu on 17-7-10.
 */
@Controller
@RequestMapping("userController")

public class UserController {

    @Autowired
    private UserService userService;

    @RequestMapping("insertUser")
    public String insertUser (@Validated User user, BindingResult bindingResult){
        System.out.println(user.toString());
        //获取校验错误信息
        if(bindingResult.hasErrors()){
            List<ObjectError> allErrors = bindingResult.getAllErrors();
            for(ObjectError objectError:allErrors){
                //输出错误信息
                System.out.println(objectError.getDefaultMessage());
            }
            return "UserInfo/login";
        }
        userService.insertUser(user);
        return "success";
    }
}

三.测试：

注册测试用例：
用户名：admin
密码：12

控制台打印：

四.补充：分组校验

定义多个校验分组（其实是一个java接口），分组中定义有哪些规则
每个controller方法使用不同的校验分组

1.校验分组

public interface ValidGroup1 {
    //接口中不需要定义任何方法，仅是对不同的校验规则进行分组
    //此分组只校验商品名称长度

}

2.在校验规则中添加分组

//校验名称在1到30字符中间
//message是提示校验出错显示的信息
//groups：此校验属于哪个分组，groups可以定义多个分组
@Size(min=1,max=30,message="{items.name.length.error}",groups = {ValidGroup1.class})
private String name;

3.在controller方法使用指定分组的校验

    @RequestMapping("insertUser")
    public String insertUser (@Validated(value = ValidGroup1.class) User user, BindingResult bindingResult){
    .....
    }

上一篇文章：SpringMVC框架--注解的处理器映射器和适配器

文集：SpringMVC框架学习