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自己的注解。