SpringMVC学习--校验

• 简介

　　项目中，通常使用较多是前端的校验，比如页面中js校验。对于安全要求较高点建议在服务端进行校验。

　　服务端校验：

　　控制层conroller：校验页面请求的参数的合法性。在服务端控制层conroller校验，不区分客户端类型（浏览器、手机客户端、远程调用）

　　业务层service（使用较多）：主要校验关键业务参数，仅限于service接口中使用的参数。

　　持久层dao：一般是不校验的。

• springmvc校验

　　springmvc使用hibernate的校验框架validation。

　　校验思路：页面提交请求的参数，请求到controller方法中，使用validation进行校验。如果校验出错，将错误信息展示到页面。

• 环境准备

　　hibernate的校验框架validation所需要jar包：

• 配置校验器

<!-- 校验器 -->
    <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>classpath:CustomValidationMessages</value> 
            </list>   
        </property>
        <!-- 资源文件编码格式 -->
        <property name="fileEncodings" value="utf-8" />
        <!-- 对资源文件内容缓存时间，单位秒 -->
        <property name="cacheSeconds" value="120" />
    </bean>

• 校验器注入到处理器适配器中

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

• 在POJO中添加校验规则

//字符长度在1-30个字符之间
    //message提示校验出错显示的信息
    @Size(min=1,max=30,message="{items.length.error.message}")
    private String name;
//创建日期非空校验
@NotNull(message="{items.createtime.isNull}")
    private Date createtime;

• 校验信息配置文件

　　CustomValidationMessages.properties

• 捕获校验错误和页面显示校验错误信息　

　　

// 商品信息修改提交
    @RequestMapping("/editItemsSubmit")
    public String editItemsSubmit(HttpServletRequest request, Integer id,
            @Validated ItemsCustom itemsCustom,BindingResult bindingResult) throws Exception {
        //获取校验错误信息
        if(bindingResult.hasErrors()){
            //输出错误信息
            List<ObjectError> allerrors = bindingResult.getAllErrors();
            for (ObjectError objectError : allerrors) {
                System.out.println(objectError.getDefaultMessage());
            }
            //将错误信息回显到页面
            request.setAttribute("allerrors", allerrors);
            return "items/editItems";
        }
        // 调用service更新商品信息，页面需要将商品信息传到此方法
        itemsService.updateItems(id, itemsCustom);

        // 重定向到商品查询列表
        // return "redirect:queryItems.action";
        // 页面转发
        return "forward:queryItems.action";
        // return "success";
    }

　　页面显示错误信息：

<!-- 显示错误信息 -->
<c:if test="${allErrors!=null }">
    <c:forEach items="${allErrors }" var="error">
    ${ error.defaultMessage}<br/>
</c:forEach>
</c:if>

• 校验分组

　　在pojo中定义校验规则，而pojo是被多个 controller所共用，当不同的controller方法对同一个pojo进行校验，但是每个controller方法需要不同的校验。

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

　　1、校验分组

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

}

　　2、在校验中添加分组信息

@Size(min=1,max=30,message="{items.length.error.message}",groups={ValidGroup1.class})
    private String name;

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

public String editItemsSubmit(HttpServletRequest request, Integer id,
            @Validated(value={ValidGroup1.class}) ItemsCustom itemsCustom,BindingResult bindingResult) throws Exception 

　　主要添加如下信息：@Validated(value={ValidGroup1.class})

　　注解的主要用法：

@Null   被注释的元素必须为 null   

@NotNull    被注释的元素必须不为 null   

@AssertTrue     被注释的元素必须为 true   

@AssertFalse    被注释的元素必须为 false   

@Min(value)     被注释的元素必须是一个数字，其值必须大于等于指定的最小值   

@Max(value)     被注释的元素必须是一个数字，其值必须小于等于指定的最大值   

@DecimalMin(value)  被注释的元素必须是一个数字，其值必须大于等于指定的最小值   

@DecimalMax(value)  被注释的元素必须是一个数字，其值必须小于等于指定的最大值   

@Size(max=, min=)   被注释的元素的大小必须在指定的范围内   

@Digits (integer, fraction)     被注释的元素必须是一个数字，其值必须在可接受的范围内   

@Past   被注释的元素必须是一个过去的日期   

@Future     被注释的元素必须是一个将来的日期   

@Pattern(regex=,flag=)  被注释的元素必须符合指定的正则表达式   

Hibernate Validator 附加的 constraint   

@NotBlank(message =)   验证字符串非null，且长度必须大于0   

@Email  被注释的元素必须是电子邮箱地址   

@Length(min=,max=)  被注释的字符串的大小必须在指定的范围内   

@NotEmpty   被注释的字符串的必须非空   

@Range(min=,max=,message=)  被注释的元素必须在合适的范围内