内置的约束条件
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(略)