Spring 全家桶之 Spring Web MVC(五)- Data Binder(下)

简介: Spring 全家桶之 Spring Web MVC(五)- Data Binder

四、数据格式化及校验

4-1 数据格式化

  • Spring 在格式化模块中定义了一个实现ConversionService接口的FormattingConversionService实现类,该实现类扩展了GenericConversionService,因此它也具有类型转换的功能又具有格式化的功能。
  • FormattingConversionService拥有一个FormattingConversionServiceFactory工厂类,后者用于在Spring上下文中构造前者。

以时间格式化为例,在add.jsp页面添加员工表单增加birth属性

db6b888a45f746e5bf1a3d9976168024_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

list.jsp页面添加birth属性列,在Employee实体类增加birth属性

96076fd886cc4251bcd13d3db758624f_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

运行添加员工,输入的时间格式为yyyy-MM-DD

78e6b76d0ac443179149e4913abf0e51_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

只有当时间格式为yyyy/MM/DD时才才能成功添加

ae4978bac49e45e18115fe67769180b8_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

如何能正确处理yyyy-MM-DD?使用@DataTimeFormate注解可以指定日期的格式

在Employee实体类的birth属性上添加@DateTimeFormat注解,指定时间的格式

@DateTimeFormat(pattern = "yyyy-MM-dd")
private Date birth;
复制代码

添加还是失败,只是因为我们使用的conversionService不具备格式化功能,将 Spring MVC 配置文件中注册的

org.springframework.context.support.ConversionServiceFactoryBean
复制代码

换成

org.springframework.format.support.FormattingConversionServiceFactoryBean
复制代码
<!--使用自定义的ConverterService-->
<bean id="conversionServiceFactory" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
    <!--中间内容不变-->
</bean>
复制代码

再次测试可以添加成功

fbf46483a47d481db6871f673a37b723_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

FormattingConversionServiceFactoryBean内部注册了以下组件

  • NumberFormatAnnotationFormatterFactory:支持对数字类型的属性使用@NumberFormat注解
  • JodaDateTimeFormatAnnotationFormatterFactory:支持对日期类型的属性使用@DateTimeFormat注解

@NumerbFormat注解可以对数值类型的属性进行设置,该注解本身拥有两个属性 style:类型为NumberFormat.Style,用于指定样式类型,有三种:Style.NUMBER正常数字类型、Style.CURRENCY既货币类型、Style.PERCENT百分比类型 pattern:类型为String,可以自定义样式,如“#,###,###”等

4-2 数据校验

JSR 既 Java Specification Requests,Java规范请求,是Java为Bean数据合法性校验提供的标准框架,JSR 通过在Bean的属性上增加@NotNull、@Null、@Max等注解来指定属性的校验规则,并且自定义校验失败的提示信息。JSR是一套校验规范,Hibernate Validator实现了JSR,并且扩展了@Email、@Length、@NotEmpty、@Range注解。

关于校验框架的介绍及使用也可以参考你有没有使用过这些编程骚操作(二)- 验证框架   Part A、B、C 三部分

在Spring MVC中使用校验框架首先要引入validation依赖和hibernate实现以及el表达式的规范和实现

<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>2.0.1.Final</version>
</dependency>
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.0.16.Final</version>
</dependency>
<dependency>
    <groupId>javax.el</groupId>
    <artifactId>javax.el-api</artifactId>
    <version>3.0.0</version>
</dependency>
<dependency>
    <groupId>org.glassfish.web</groupId>
    <artifactId>javax.el</artifactId>
    <version>2.2.6</version>
</dependency>
复制代码

添加依赖后,要将Jar包全部PUT 进 lib目录下

48da6130976545a5a725348aa328da42_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

在Employee实体类的属性上增加校验的注解

@NotEmpty
@Length(min = 5,max = 8)
private String lastName;
@Email
private String email;
复制代码

在方法入参中加入@Valid注解,对出传来的参数进行校验,并使用BindingResult来保存校验的结果

@RequestMapping(value = "/emp", method = RequestMethod.POST)
public String addEmp(@Valid Employee employee, BindingResult result){
    System.out.println("要添加的员工信息:" + employee);
    boolean hasErrors = result.hasErrors();
    if (hasErrors){
        System.out.println("属性校验错误");
        return "add";
    }
    employeeDao.save(employee);
    // 返回列表页面
    return "redirect:/emps";
}
复制代码

在jsp页面中解析校验结果

LastName:<form:input path="lastName"/><form:errors path="lastName" /><br/>
Email:<form:input path="email"/><form:errors path="email" /><br/>
<!--其他内容不变-->
birth:<form:input path="birth" /><form:errors path="birth" /><br>
复制代码

重启Tomcat,执行添加操作

b50cd511cb204360a7878fdc9068d3c1_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

如何通过其他方式取出错误信息

修改addEmp方法,通过BindingResult的getFieldErrors方法取出具体的错误信息,并输出错误代码

@RequestMapping(value = "/emp", method = RequestMethod.POST)
public String addEmp(@Valid Employee employee, BindingResult result, Model model){
    Map<String, Object> errorMap = new HashMap<>();
    System.out.println("要添加的员工信息:" + employee);
    boolean hasErrors = result.hasErrors();
    if (hasErrors){
        System.out.println("属性校验错误");
        // 获取详细报错信息
        List<FieldError> fieldErrors = result.getFieldErrors();
        for (FieldError fieldError : fieldErrors) {
            System.out.println("出错字段为:" + fieldError.getField() + ",报错信息为:" + fieldError.getDefaultMessage());
            // 获取错误代码,用来作为国际化配置的Key
            String[] codes = fieldError.getCodes();
            for (String code : codes) {
                System.out.println(code);
            }
            errorMap.put(fieldError.getField(),fieldError.getDefaultMessage());
        }
        model.addAttribute("errorMap", errorMap);
        return "add";
    }
    System.out.println(result);
    employeeDao.save(employee);
    // 返回列表页面
    return "redirect:/emps";
}
复制代码

重启Tomcat,在执行添加操作

d7af327d6188414f90cafc2015d8303b_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

每个属性在数据绑定和数据校验发生错误时,都会生成一个FieldError对象 当一个属性校验失败后,校验框架会为该属性生成4个消息代码,这些代码以校验注解类名为前缀,结合modelAttribute、属性名以及属性类型名生成多个对应的消息代码

输出的错误信息都是英文,可以进行国际化配置根据浏览器的语言显示报错信息,当使用Spring MVC 时,Spring MVC会查看Web上下文是否配置了国际化消息,如果有则显示国际化消息,如果没有显示默认的信息

在resources目录下新增中文和英文的国际化配置文件error_zh_CN.properties和error_en_US.properties

Email.email=email wrong, retry
NotEmpty=can't be empty
Length.java.lang.String=length incorrect
Past=must be a past time
复制代码
Email.email=\u90AE\u7BB1\u4E0D\u5BF9
NotEmpty=\u4E0D\u80FD\u4E3A\u7A7A
Length.java.lang.String= \u957F\u5EA6\u4E0D\u5BF9
Past=\u65F6\u95F4\u5FC5\u987B\u662F\u8FC7\u53BB\u7684
typeMismatch.birth=\u751F\u65E5\u7684\u683C\u5F0F\u4E0D\u6B63\u786E
复制代码

在Spring MVC 配置文件中增加国际化配置

<!--国际化配置-->
<bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
    <property name="basename" value="error"></property>
</bean>
复制代码

重启Tomcat,执行添加操作

70388ab996604a40b5e3ae46a1ce501e_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

如何将错误的字段值回显到报错信息中?

以中文的国际化配置文件为例

Email.email=\u90AE\u7BB1\u4E0D\u5BF9 - {0} 
NotEmpty=\u4E0D\u80FD\u4E3A\u7A7A - {0} 
Length.java.lang.String= \u957F\u5EA6\u4E0D\u5BF9 - {0} {1} {2}
Past=\u65F6\u95F4\u5FC5\u987B\u662F\u8FC7\u53BB\u7684 - {0}
typeMismatch.birth=\u751F\u65E5\u7684\u683C\u5F0F\u4E0D\u6B63\u786E - {0}
复制代码
  • {0}:永远表示当前校验的属性名
  • {1}和{2}表示注解中设置的属性的value,取得顺序是按照字母排列来的

重新启动Tomcat,执行添加操作

5f3268893e0a4b97a8d499f289c86fd8_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png


相关文章
|
2月前
|
消息中间件 缓存 NoSQL
基于Spring Data Redis与RabbitMQ实现字符串缓存和计数功能(数据同步)
总的来说,借助Spring Data Redis和RabbitMQ,我们可以轻松实现字符串缓存和计数的功能。而关键的部分不过是一些"厨房的套路",一旦你掌握了这些套路,那么你就像厨师一样可以准备出一道道饕餮美食了。通过这种方式促进数据处理效率无疑将大大提高我们的生产力。
115 32
|
3月前
|
NoSQL 安全 Java
深入理解 RedisConnectionFactory:Spring Data Redis 的核心组件
在 Spring Data Redis 中,`RedisConnectionFactory` 是核心组件,负责创建和管理与 Redis 的连接。它支持单机、集群及哨兵等多种模式,为上层组件(如 `RedisTemplate`)提供连接抽象。Spring 提供了 Lettuce 和 Jedis 两种主要实现,其中 Lettuce 因其线程安全和高性能特性被广泛推荐。通过手动配置或 Spring Boot 自动化配置,开发者可轻松集成 Redis,提升应用性能与扩展性。本文深入解析其作用、实现方式及常见问题解决方法,助你高效使用 Redis。
291 4
|
3月前
|
SQL Java 编译器
深入理解 Spring Data JPA 的导入与使用:以 UserRepository为例
本文深入解析了 Spring Data JPA 中 `UserRepository` 的导入与使用。通过示例代码,详细说明了为何需要导入 `User` 实体类、`JpaRepository` 接口及 `@Repository` 注解。这些导入语句分别用于定义操作实体、提供数据库交互方法和标识数据访问组件。文章还探讨了未导入时的编译问题,并展示了实际应用场景,如用户保存、查询与删除操作。合理使用导入语句,可让代码更简洁高效,充分发挥 Spring Data JPA 的优势。
158 0
|
4月前
|
JSON 前端开发 Java
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestBody
`@RequestBody` 是 Spring 框架中的注解,用于将 HTTP 请求体中的 JSON 数据自动映射为 Java 对象。例如,前端通过 POST 请求发送包含 `username` 和 `password` 的 JSON 数据,后端可通过带有 `@RequestBody` 注解的方法参数接收并处理。此注解适用于传递复杂对象的场景,简化了数据解析过程。与表单提交不同,它主要用于接收 JSON 格式的实体数据。
181 0
|
4月前
|
前端开发 Java 测试技术
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestParam
本文介绍了 `@RequestParam` 注解的使用方法及其与 `@PathVariable` 的区别。`@RequestParam` 用于从请求中获取参数值(如 GET 请求的 URL 参数或 POST 请求的表单数据),而 `@PathVariable` 用于从 URL 模板中提取参数。文章通过示例代码详细说明了 `@RequestParam` 的常用属性,如 `required` 和 `defaultValue`,并展示了如何用实体类封装大量表单参数以简化处理流程。最后,结合 Postman 测试工具验证了接口的功能。
149 0
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestParam
|
4月前
|
前端开发 Java 微服务
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@PathVariable
`@PathVariable` 是 Spring Boot 中用于从 URL 中提取参数的注解,支持 RESTful 风格接口开发。例如,通过 `@GetMapping(&quot;/user/{id}&quot;)` 可以将 URL 中的 `{id}` 参数自动映射到方法参数中。若参数名不一致,可通过 `@PathVariable(&quot;自定义名&quot;)` 指定绑定关系。此外,还支持多参数占位符,如 `/user/{id}/{name}`,分别映射到方法中的多个参数。运行项目后,访问指定 URL 即可验证参数是否正确接收。
116 0
|
4月前
|
JSON 前端开发 Java
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RequestMapping
@RequestMapping 是 Spring MVC 中用于请求地址映射的注解,可作用于类或方法上。类级别定义控制器父路径,方法级别进一步指定处理逻辑。常用属性包括 value(请求地址)、method(请求类型,如 GET/POST 等,默认 GET)和 produces(返回内容类型)。例如:`@RequestMapping(value = &quot;/test&quot;, produces = &quot;application/json; charset=UTF-8&quot;)`。此外,针对不同请求方式还有简化注解,如 @GetMapping、@PostMapping 等。
148 0
|
4月前
|
JSON 前端开发 Java
微服务——SpringBoot使用归纳——Spring Boot中的MVC支持——@RestController
本文主要介绍 Spring Boot 中 MVC 开发常用的几个注解及其使用方式,包括 `@RestController`、`@RequestMapping`、`@PathVariable`、`@RequestParam` 和 `@RequestBody`。其中重点讲解了 `@RestController` 注解的构成与特点:它是 `@Controller` 和 `@ResponseBody` 的结合体,适用于返回 JSON 数据的场景。文章还指出,在需要模板渲染(如 Thymeleaf)而非前后端分离的情况下,应使用 `@Controller` 而非 `@RestController`
127 0
|
5月前
|
消息中间件 Java Kafka
【Azure Kafka】使用Spring Cloud Stream Binder Kafka 发送并接收 Event Hub 消息及解决并发报错
reactor.core.publisher.Sinks$EmissionException: Spec. Rule 1.3 - onSubscribe, onNext, onError and onComplete signaled to a Subscriber MUST be signaled serially.
|
6月前
|
存储 NoSQL Java
使用Java和Spring Data构建数据访问层
本文介绍了如何使用 Java 和 Spring Data 构建数据访问层的完整过程。通过创建实体类、存储库接口、服务类和控制器类,实现了对数据库的基本操作。这种方法不仅简化了数据访问层的开发,还提高了代码的可维护性和可读性。通过合理使用 Spring Data 提供的功能,可以大幅提升开发效率。
148 21