spring mvc json数据的格式化和数据校验

ゝ一纸荒年。 2022-06-05 07:16 291阅读 0赞

常用的：  
@DatetimeFormat是将String转换成Date，一般前台给后台传值时用  
@JsonFormat(pattern=”yyyy-MM-dd”) 将Date转换成String 一般后台传值给前台时

DateFormatter java.util.Date<—->String  
实现日期的格式化/解析

NumberFormatter java.lang.Number<—->String  
实现通用样式的格式化/解析

CurrencyFormatter java.lang.BigDecimal<—->String  
实现货币样式的格式化/解析

PercentFormatter java.lang.Number<—->String  
实现百分数样式的格式化/解析

NumberFormatAnnotationFormatterFactory  
@NumberFormat注解类型的数字字段类型<—->String  
①通过@NumberFormat指定格式化/解析格式  
②可以格式化/解析的数字类型：Short、Integer、Long、Float、Double、BigDecimal、BigInteger

JodaDateTimeFormatAnnotationFormatterFactory  
@DateTimeFormat注解类型的日期字段类型<—->String  
①通过@DateTimeFormat指定格式化/解析格式  
②可以格式化/解析的日期类型：  
joda中的日期类型（org.joda.time包中的）：LocalDate、LocalDateTime、LocalTime、ReadableInstant  
java内置的日期类型：Date、Calendar、Long

classpath中必须有Joda-Time类库，否则无法格式化日期类型

使用内置的注解进行字段级别的解析/格式化：  
（1、测试模型类准备：  
Java代码

package cn.javass.chapter7.model;  
    public class FormatterModel {   
        @NumberFormat(style=Style.NUMBER, pattern="#,###")  
        private int totalCount;  
        @NumberFormat(style=Style.PERCENT)  
        private double discount;  
        @NumberFormat(style=Style.CURRENCY)  
        private double sumMoney;  
    
        @DateTimeFormat(iso=ISO.DATE)   
        private Date registerDate;  
    
        @DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss")   
        private Date orderDate;  
    
        //省略getter/setter 
    }

此处我们使用了Spring字段级别解析/格式化的两个内置注解：

@Number：定义数字相关的解析/格式化元数据（通用样式、货币样式、百分数样式），参数如下：  
style：用于指定样式类型，包括三种：Style.NUMBER（通用样式） Style.CURRENCY（货币样式） Style.PERCENT（百分数样式），默认Style.NUMBER；  
pattern：自定义样式，如patter=”\#,\#\#\#”；

@DateTimeFormat：定义日期相关的解析/格式化元数据，参数如下：  
pattern：指定解析/格式化字段数据的模式，如”yyyy-MM-dd HH:mm:ss”  
iso：指定解析/格式化字段数据的ISO模式，包括四种：ISO.NONE（不使用） ISO.DATE(yyyy-MM-dd) ISO.TIME(hh:mm:ss.SSSZ) ISO.DATE\_TIME(yyyy-MM-dd hh:mm:ss.SSSZ)，默认ISO.NONE；  
style：指定用于格式化的样式模式，默认“SS”，具体使用请参考Joda-Time类库的org.joda.time.format.DateTimeFormat的forStyle的javadoc；  
优先级： pattern 大于 iso 大于 style。

JSR(Java Specification Requests，Java规范提案) 303 – Bean Validation 是一个数据验证的规范，2009 年 11 月确定最终方案。2009 年 12 月 Java EE 6 发布，Bean Validation 作为一个重要特性被包含其中。  
Hibernate Validator 是 Bean Validation 的参考实现 . Hibernate Validator 提供了 JSR 303 规范中所有内置 constraint 的实现，除此之外还有一些附加的 constraint。  
Bean Validation 中的 constraint  
表 1. Bean Validation 中内置的 constraint  
Constraint 详细信息  
@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(value) 被注释的元素必须符合指定的正则表达式表 2. Hibernate Validator 附加的 constraint  
Constraint 详细信息  
@Email 被注释的元素必须是电子邮箱地址  
@Length 被注释的字符串的大小必须在指定的范围内  
@NotEmpty 被注释的字符串的必须非空  
@Range 被注释的元素必须在合适的范围内 有些时候，在用户的应用中需要一些更复杂的 constraint。Bean Validation 提供扩展 constraint 的机制。可以通过两种方法去实现，一种是组合现有的 constraint 来生成一个更复杂的 constraint，另外一种是开发一个全新的 constraint。