springMVC-10验证及国际化

验证

概述

● 概述

1. 对输入的数据(比如表单数据)，进行必要的验证，并给出相应的提示信息。
2. 对于验证表单数据，springMVC提供了很多实用的注解, 这些注解由JSR303 验证框架提供.

●JSR 303 验证框架

1. JSR 303 的含义
JSR（Java Specification Request）是 Java 社区提案的缩写，由 Java Community Process（JCP）管理。每个 JSR 对应一项 Java 技术规范，例如 JSR 303 即第 303 号提案

2. JSR 303 是 Java 为 Bean 数据合法性校验提供的标准框架，它已经包含在 JavaEE 中
3. JSR 303 通过在 Bean 属性上标注类似于 @NotNull、@Max 等标准的注解指定校验规则， 并通过标准的验证接口对 Bean 进行验证
4. JSR 303 提供的基本验证注解有: 

●HibernateValidator扩展注解
1.HibernateValidator和Hibernate没有关系，只是JSR303实现的一个扩展.
2.HibernateValidator是JSR303的一个参考实现，除支持所有标准的校验注解外，它还支 持以下的扩展注解:
3.扩展注解有如下

应用实例

1. 引入验证和国际化相关的jar包

2. 修改Monster.java

    @NotEmpty//表示该字段不能为null，或者String不为""，或者集合、映射的size != 0，这样的情况。//Asserts that the annotated string, collection, map or array is not null or empty.private String name;@Range(min = 1, max = 200)//表示取值范围在1-200之间private Integer age;

3.修改MonsterHandler.java

/*** 编写方法，处理添加妖怪* 1.springmvc可以将提交的数据，按照参数名和对象的属性名匹鹿配* 2.直接封装到对象中->前面讲解模型数据时，讲过*         String =>Integer* 3.@Valid Monster monster:表示对monster接收的数据进行校验* 4.Errors errors表示如果校验出现错误，将校验的错误信息保存errors* 5.Map<String,Object>map表示如果校验出现错误，将校验的错误信息保存至map；同时保存monster对象(与errors的区别)* 6.校验发生的时机： 在springmvc底层，反射调用目标方法时，会接收到http请求的数据，然后根据注解来进行验证，* 在验证过程中，如果出现了错误，就把错误信息填充errors 和 map*/@RequestMapping("/save")//这儿的monster,springMVC会进行自动装配public String addMonster(@Valid Monster monster, Errors errors ,Map<String, Object> map) {System.out.println(monster);System.out.println("=========errors===========");List<ObjectError> allErrors = errors.getAllErrors();for(ObjectError error : allErrors) {System.out.println("error=" + error);}System.out.println("==========map============");for (Map.Entry<String,Object> entry : map.entrySet()) {System.out.println("key=" + entry.getKey() + " value=" + entry.getValue());}return "success";}

4.测试

和预期一样，姓名空报错，年龄超出范围。

验证信息回显至页面

1.修改monster_addUI.jsp，添加errors标签

    妖怪姓名:<s:input path="name" /><s:errors path="name"/><br><br>妖怪年龄:<s:input path="age" /><s:errors path="age"/><br><br>电子邮件:<s:input path="email"/><s:errors path="email"/><br><br>妖怪生日:<s:input path="birthday"/><s:errors path="birthday"/>  要求以"9999-11-11"的形式<br><br>妖怪薪水:<s:input path="salary"/>><s:errors path="salary"/>  要求以"123,890.12"的形式<br><br>

2.修改MonsterHandler

        发现报错，便阻止进入到下一个页面，返回当前输入页面。

        System.out.println("==========map============");for (Map.Entry<String,Object> entry : map.entrySet()) {System.out.println("key=" + entry.getKey() + " value=" + entry.getValue());}//交换了map和errors的代码顺序，是因为map有monster，通常不会为nullSystem.out.println("=========errors===========");if(errors.hasErrors()){List<ObjectError> allErrors = errors.getAllErrors();for(ObjectError error : allErrors) {System.out.println("error=" + error);}return "datavalid/monster_addUI";}return "success";

3.测试

        可以看到返回的错误信息了。

国际化/自定义验证信息

概念

        国际化（简称 i18n，因“internationalization”一词首尾字母间有18个字符）是指设计和开发软件、产品或服务时，使其能够适应不同语言、地区和文化需求的技术与流程。核心目标是无需重构代码或设计，即可快速适配多语言和多区域市场。

应用实例

原始的生日和薪水报错是用英文显示的：

1.配置国际化文件，springMVC-servlet.xml中添加bean

    <bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource"><!--属性作用： 配置国际化文件名字--><!--如果你这样配的话，表示messageSource会到src/i18nXXX.properties去读取错误信息--><property name="basename" value="i18n"/></bean>

2.创建src/i18n.properties

        这儿的文件名，和上面的配置文件一致
        等号=前面的key，来自于报错代码的第一个字段，比如：
                [NotEmpty.monster.name, ...],[Range.monster.age, ...]
        等号=后面的value值，是unicode编码，可以在相应的工具网站“unicode编码转换工具”中查询

NotEmpty.monster.name=\u59d3\u540d\u4e0d\u80fd\u4e3a\u7a7a
Range.monster.age=\u5e74\u9f84\u9700\u8981\u5728\u0031\u81f3\u0032\u0030\u0030\u5c81\u4e4b\u95f4
typeMismatch.monster.birthday=\u751f\u65e5\u683c\u5f0f\u4e0d\u6b63\u786e
typeMismatch.monster.salary=\u85aa\u6c34\u5fc5\u987b\u5168\u90e8\u662f\u6570\u5b57

 3.测试

        可以看到报错回显的内容，全部按照自己定义的内容进行显示了。  

细节说明和注意事项

1. 在需要验证的 Javabean/POJO的字段上加上相应的验证注解.

2. 目标方法上,在 JavaBean/POJO 类型的参数前, 添加 @Valid 注解. 告知 SpringMVC 该 bean 是需要验证的

3. 在 @Valid 注解之后, 添加一个 Errors 或 BindingResult 类型的参数, 可以获取到验证 的错误信息

4. 需要使用 标签来显示错误消息, 这个标签， 需要写在 springMVC的标签<s:form>内生效.

5. 错误消息的国际化文件i18n.properties, 中文需要是Unicode编码，使用工具转码.
√ 格式: 验证规则：表单modelAttribute值.属性名 = 消息信息
√ NotEmpty.monster.name=\u540D\u5B57\u4E0D\u80FD\u4E3A\u7A7A
√ typeMismatch.monster.age=\u7C7B\u578B\u4E0D\u5339\u914D

6. 注解@NotNull 和 @NotEmpty 的区别说明

1) 查看源码可以知道 :
@NotEmptyAsserts that the annotated string, collection, map or array is not {@code null} or empty.

2) 查看源码可以知道 :
@NotNull*Theannotated element must not be {@code null}.* Accepts any type.

种类	修饰类型	作用
@NotEmpty	String, collection, map	null || size=0
@NotNull	任意类型	null

3) 解读：如果是字符串验证空, 建议使用 @NotEmpty

7. SpingMVC 验证时，会根据不同的验证错误, 返回对应的信息

注解的组合使用

1.注解可以组合使用比如

@Range+@NotNull

2.返回的错误信息，除了通过国际化进行配置外，还可以通过注解的属性来修改

@NotNull(message="不能为空")

3.测试发现，同时配置了message和国际化的情况下，会优先显示国际化配置的信息。

DataBinder工作机制-了解

图例Spring MVC通过反射机制对目标方法进行解析，将请求消息绑定到处理方法的入参中。数据绑定的核心部件是DataBinder,运行机制如下

1.Tomcat封装请求到ServletRequest

2.处理方法入参对象

3.进行数据类型转换/格式化。ConversionService转换服务，如果转换出现错误，就会封装到最后的5BindingResult中

4.进行数据校验，出错也会封装到5BindResult中

5.返回数据转换和数据校验的结果

error的运行类型是BeanPropertyBindingResult, BeanPropertyBindingResult实现了BindingResult接口

取消属性绑定

说明

在默认情况下，表单提交的数据都会和pojo类型的javabean属性绑定，如果程序员在开发中，希望取消某个属性的绑定，也就是说，不希望接收到某个表单对应的属性的值，则可以通过
@InitBinder注解取消绑定

• POJO(Plain Old Java Object - 简单的 Java 对象): 一个普通的、不依赖特定框架的 Java 类。表单绑定的目标对象首先是一个 POJO。

• JavaBean: 一种遵循特定严格约定（无参构造、私有属性、公共标准 Getter/Setter）的 POJO。正是这些约定使得 Web 框架能够自动将表单提交的数据绑定到对象的属性上。

• 上面粗体子含义： 在 Spring MVC 等框架中，如果你创建一个符合 JavaBean 规范的类（比如 User），并将其作为控制器方法的参数（如 public String submitForm(User user)），那么框架在默认情况下，就能自动将 HTTP 请求中提交的表单字段的值，通过调用该 User 对象的对应 Setter 方法，填充到它的属性中去。这就是“表单提交的数据都会和 POJO 类型的 JavaBean 属性绑定”的意思。这里的“POJO 类型”强调目标是一个普通 Java 类，“JavaBean” 强调这个类需要遵循 JavaBean 规范以实现自动绑定。

• Entity： 一种特殊用途的 POJO/JavaBean，用于代表需要持久化到数据库的业务核心对象。它通过注解添加了数据库映射的元数据（映射到哪个表、哪个是主键、字段映射、关系映射等）。强调与数据库的映射关系。

1.编写一个方法，使用@InitBinder标识的该方法，可以对WebDataBinder对象进行初始化。
        WebDataBinder是DataBinder的子类，用于完成由表单字段到JavaBean属性的绑定
2.@InitBinder方法不能有返回值，它必须声明为void.
3.@InitBinder方法的参数通常是是WebDataBinder

应用实例

1.给MonsterHandler.java添加方法

    @InitBinderpublic void initBinder(WebDataBinder webDataBinder) {/*** 解读* 1.方法上需要标注@InitBinder springmvc底层会初始化WebDataBinder* 2.调用webDataBinder.setDisallowedFields("name")表示取消指定属性的绑定* 	即：当表单提交字段为name时，就不在把接收到的name值，填充到model数据monster的name属性* 3.机制：springmvc在底层通过反射调用目标方法时，接收到http请求的参数和值，使用反射+注解* 技术取消对指定属性的填充* 4.setDisallowedFields支特可变参数，可以填写多个字段。比如（"name","email"）* 5.如果我们取消某个属性绑定，验证就没有意义了，应当把验证的注解去掉，否则容易出错*     //@NotEmpty(message="不能为空")*     private String name;*/webDataBinder.setDisallowedFields("name");}

2.测试

后台输出：

name='null'

注意这儿的'null'就是null的意思。