Hibernate Validator 第6篇:内建约束
Hibernate Validator包括一些列经常用到的约束,它们已经定义在Bean Validation 规范中。另外,Hibernate Validator也提供了有用的自定义约束。
一、Bean校验约束
在Bean Validation API中,你可以找到很多约束。所有这些约束都可以应用在成员变量,或属性上面,但是在这些约束中,没有类级别的约束。如果你在使用Hibernate 对象-关系映射,一些类级别的约束,可以考虑进来。
Hibernate Validator 的约束类型数量,超过Bean Validation 规范里的约束数量(例如@Max可以应用在String类型上)。依靠这些约束,可以提高程序的性能。
1.1 下面展示一些约束
- @AssertFalse:检查这个被注解的元素是false。
- 支持的数据类型:Boolean、boolean。
- Hibernate 元数据影响:无。
- @AssertTrue:检查这个被注解的元素是true。
- 支持的数据类型:Boolean、boolean。
- Hibernate元数据影响:无。
- @Decimal(value=, inclusive=):检查被注解的值是否小于指定的最大值,当inclusive=false。否则,检查是否小于或等于指定的最大值。这个参数值是一个String表达式,用来表示最大值。这个String会转化为BigDecimal。
- 支持的数据类型:BigDecimal,BigInteger,CharSequence,byte,short,int,long和对应基本类型的包装类。另外也支持HV:任何Number和javax.money.MontaryAmount的自类型。
- Hibernate元数据的影响:无。
- @DecimalMin(value=, inclusive=):和上面的@DecimalMax的功能正好相反,这里不再赘述。
- @Digits(integer = fraction=):检查是否被注解的值是一个数字,并且这个数字有integer位整数,fraction位小数。
- 支持的数据类型:BigDecimal, BigInteger, CharSequence, byte, short, int, long和对应的包装类;另外,还支持HV的Number的任何子类。
- Hibernate元数据影响:定义列精度和小数范围。
- @Email:检查指定的字符串是否是一个有效的邮箱地址。这个可选参数regexp和flags允许去指定一个额外的正则表达式,并被被注解的字符串去匹配。
- 支持的类型:CharSequence.
- Hibernate元数据影响:无。
- @Future:检查被注解的date是否是在未来的某个时间。
- 支持的类型:
- java.util.Date,
- java.util.Calendar,
- java.time.Instant,
- java.time.LocalDate,
- java.time.LocalDateTime,
- java.time.LocalTime,
- java.time.MonthDay,
- java.time.OffsetDateTime,
- java.time.OffsetTime,
- java.time.Year,
- java.time.YearMonth,
- java.time.ZonedDateTime,
- java.time.chrono.HijrahDate,
- java.time.chrono.JapaneseDate,
- java.time.chrono.MinguoDate,
- java.time.chrono.ThaiBuddhistDate。
- Hibernate元数据影响:无。
- 支持的类型:
- @FutureOrPresent:检查是否被注解的date是在现在或者是在未来的某个时刻。
- 支持的数据类型:
- java.util.Date,
- java.util.Calendar,
- java.time.Instant,
- java.time.LocalDate,
- java.time.LocalDateTime,
- java.time.LocalTime,
- java.time.MonthDay,
- java.time.OffsetDateTime,
- java.time.OffsetTime,
- java.time.Year,
- java.time.YearMonth,
- java.time.ZonedDateTime,
- java.time.chrono.HijrahDate,
- java.time.chrono.JapaneseDate,
- java.time.chrono.MinguoDate,
- java.time.chrono.
- ThaiBuddhistDate。
- 另外如果Joda.Time date/time API在类路径中的话,也支持HV。
还有任何实现了ReadablePartial和ReadableInstant的子类。 - Hibernate元数据影响:无。
- 支持的数据类型:
这只是Bean Validation API中的部分注解,后面还有Hibernate Validator额外自己的注解。
下篇会讲Hibernate Validator自己的注解。