hibernate_validator_08

时间：2025-03-12 16:37:07

内置的约束条件

Hibernate Validator包含了一些基本的使用比较广的约束,下面是一些Hibernate Validator给出的最常用的约束.另外Hibernate Validator还提供了一些有有的custom约束.

一.Bean Validation constraints

下面是一些常的constraints,它们的作用,支持的数据类型.它们全部都是属性级别的注释,如果你使用Hibernate 对象-关系映射,当你为你的model创建ddl时,有一些约束是要被考虑在内的.

注意:Hibernate Validator的有些约束是能支持比Bean Validation specification要求的数据类型的更多的类型.e.g. @Max can be applied to Strings

 
Annotation

Supported data types

 作用 Hibernate metadata impact
@AssertFalse Boolean ,  boolean 

Checks that the
annotated element
is false .

 没有
 @AssertTrue  Boolean ,  boolean

Checks that the
annotated element
is true .

  没有
 @DecimalMax

BigDecimal ,
BigInteger , String ,
byte , short , int ,
long and the
respective wrappers
of the primitive
types. Additionally
supported by
HV: any sub-type

of Number and
CharSequence .

被标注的值必须
不大于约束中指定
的最大值. 这个约
束的参数是一个通
过 BigDecimal 定义的最
大值的字符串表示.

  没有
@DecimalMin

BigDecimal ,
BigInteger , String ,
byte , short , int ,
long and the
respective wrappers
of the primitive
types. Additionally
supported by
HV: any sub-type
of Number and
CharSequence .

被标注的值必须
不小于约束中指定
的最小值. 这个约
束的参数是一个通
过 BigDecimal 定义的最
小值的字符串表示.

  没有

@Digits(integer=,
fraction=

BigDecimal ,
BigInteger , String ,
byte , short , int ,
long and the
respective wrappers
of the primitive
types. Additionally
supported by
HV: any sub-type
of Number and
CharSequence .

Checks whether the
annoted value is a
number having up to
integer digits and
fraction fractional
digits

对应的数据库表
字段会被设置精度
(precision)和准度
(scale).

@Future

java.util.Date ,
java.util.Calendar ;
Additionally
supported by HV,
if the Joda Time
[http://joda-
time.sourceforge.net/
] date/time API is
on the class path:
any implementations
of ReadablePartial
and ReadableInstant .

检查给定的日期是否
比现在晚.

  没有
 @Max

BigDecimal ,
BigInteger , byte ,
short , int , long
and the respective
wrappers of the
primitive types.
Additionally
supported by HV:
any sub-type of
CharSequence (the
numeric value
represented by the
char sequence is
evaluated), any
sub-type of Number .

检查该值是否大于或
等于约束条件中规定
的最大值

会给对应的数据库表
字段添加一个check的
约束条件.
@Min 

BigDecimal ,
BigInteger , byte ,
short , int , long
and the respective
wrappers of the
primitive types.
Additionally
supported by HV:
any sub-type of
CharSequence (the
numeric value
represented by the
char sequence is
evaluated), any
sub-type of Number .

检查该值是否大于或
等于约束条件中规定
的最小值.

的最小值.
会给对应的数据库表
字段添加一个check的
约束条件.
@NotNull Any type

Checks that the
annotated value is
not null.

对应的表字段不允许
为null.
@Null Any type

Checks that the
annotated value is
 null.

没有
 @Past

java.util.Date ,
java.util.Calendar ;
Additionally
supported by HV,
if the Joda Time
[http://joda-
time.sourceforge.net/
] date/time API is
on the class path:
any implementations

of ReadablePartial
and ReadableInstant .

检查标注对象中的值
表示的日期比当前早.

 没有

@Pattern(regex=,
flag=

String . Additionally
supported by HV:
any sub-type of
CharSequence

检查该字符串是否能
够在 match 指定的情况
下被 regex 定义的正则
表达式匹配.

  没有
 @Size(min=, max=)

String , Collection ,
Map and arrays .
Additionally
supported by HV:
any sub-type of
CharSequence .

Checks if the
annotated element's
size is between
min and max
(inclusive).

对应的数据库表字段
的长度会被设置成约
束中定义的最大值.
 @Valid 

Any non-primitive
type

递归的对关联对象进
行校验, 如果关联对
象是个集合或者数组,
那么对其中的元素进
行递归校验,如果是一
个map,则对其中的值
部分进行校验

  没有
注意:        这些约束都能支持message,groups,payload的参数

二,Additional constraints

除了Bean Validation API Hibernate Validator中的约束外,还有一些有用的定制的约束.其中@ScriptAssert是一个类级别的注释

Annotation

Supported data
types

 作用

Hibernate metadata
impact
@CreditCardNumber CharSequence

Checks that the
annotated character
sequence passes
the Luhn checksum

test. Note, this
validation aims
to check for
user mistakes,
not credit card
validity! See
also Anatomy
of Credit Card
Numbers [http://
www.merriampark.com/
anatomycc.htm].

 没有
@Email CharSequence

Checks whether the
specified character
sequence is a valid
email address. The
optional parameters
regexp and flags
allow to specify
an additional
regular expression
(including regular
expression flags)
which the email
must match.

  没有
 @Length(min=, max=)  CharSequence

Validates that
the annotated
character sequence
is between min and
max included.

对应的数据库表字段
的长度会被设置成约
束中定义的最大值

@ModCheck(modType=,
multiplier=,
startIndex=,
endIndex=,
checkDigitPosition=,
ignoreNonDigitCharacters=)

  CharSequence

Checks that the
digits within
the annotated
character sequence
pass the mod 10
or mod 11 checksum
algorithm. modType
is used to select
the modulo type
and the multiplier
determines the
algorithm specific

multiplier
(see also Luhn
algorithm [http://
en.wikipedia.org/
wiki/
Luhn_algorithm]).
startIndex and
endIndex allow
to only run the
modulo algorithm
on the specified
sub-string.
checkDigitPosition
allows to use
an arbitrary
digit within
the character
sequence to be the
check digit. If
not specified it
is assumed that
the check digit
is part of the
specified range.
Last but not least,
ignoreNonDigitCharacters
allows to
ignore non digit
characters.

  没有
 @NotBlank  CharSequence

Checks that the
annotated character
sequence is not
null and the
trimmed length is
greater than 0.
The difference to
@NotEmpty is that
this constraint
can only be applied
on strings and
that trailing

whitespaces are
ignored.

  没有
 @NotEmpty

CharSequence ,
Collection , Map and
arrays

Checks whether the
annotated element
is not null nor
empty

  没有
 @Range(min=, max=)

BigDecimal ,
BigInteger ,
CharSequence , byte ,
short , int , long
and the respective
wrappers of the
primitive types

Checks whether
the annotated
value lies between
(inclusive) the
specified minimum
and maximum.

  没有

@SafeHtml(whitelistType=,
additionalTags=)

  CharSequence

Checks whether
the annotated
value contains
potentially
malicious fragments
such as <script/
> . In order to use
this constraint,
the jsoup [http://
jsoup.org/] library
must be part of the
class path. With
the whitelistType
attribute
predefined
whitelist types
can be chosen. You
can also specify
additional html
tags for the
whitelist with
the additionalTags
attribute.

  没有

@ScriptAssert(lang=,
script=, alias=)

  Any type

Checks whether the
given script can
successfully be
evaluated against
the annotated

element. In
order to use this
constraint, an
implementation
of the Java
Scripting API as
defined by JSR 223
("Scripting for the
Java TM Platform")
must part of the
class path. The
expressions to
be evaluated can
be written in
any scripting
or expression
language, for
which a JSR 223
compatible engine
can be found in the
class path.

  没有

@URL(protocol=,
host=, port=,
regexp=, flags=)

  CharSequence

Checks if the
annotated character
sequence is a valid
URL according to
RFC2396. If any
of the optional
parameters protocol ,
host or port are
specified, the
corresponding URL
fragments must
match the specified
values. The
optional parameters
regexp and flags
allow to specify
an additional
regular expression
(including regular
expression flags)

which the URL must
match.

  没有

三, Country specific constraints(略)

相关文章