Grails的域类验证详解

本文参考：http://hi.baidu.com/javacookies/blog/item/18fc2a3d30181ccf9e3d62b1.html

在Grails里，可以通过定义约束属性来验证一个领域类的实例。约束属性在一个叫"constraints"闭包的定义。可以为领域类里的每个属性定义约束。

class TUser {

Stringname

Stringpassword

Stringdemo

Stringhelp

StringtoString(){

"$name:$password"

}

staticconstraints={

name(blank:false)

password(blank:false,size:6..16)

demo(blank:true,nullable:true)

help(blank:true,nullable:true)

}

constraints必须声明为static。

同时，每个属性的约束属性都有与之对应的错误消息（Error message code），当表单未能通过验证的时候，将会返回这些错误消息。

这些错误消息在grails-app/i18n/message.properties里定义。

例如我们要让User的email为空时返回"Pleaseenteryouremail"，则可以在message.properties定义：

user.email.blank=Pleaseenteryouremail

Grails提供很多验证属性，可以满足一些基本的验证需求：

blank

验证属性能否为空，不允许为空则设为false。

Note:如果在form里为空而提交，则属性的值是一个空字符串，而不是null。

Example:login(blank:false)

creditCard

如果要求属性为信用卡号码，则设为true。

Example:cardNumber(creditCard:true)

email

如果要求属性为emial地址，则设为true。

Example:contactEmail(email:true)

inList

如果要求属性的值必须为规定的值，则定义规定的值。

Example:name(inList:"Joe","Fred","Bob")

length

约束字符串或者数组的长度。

这个约束属性在0.5版本是被取消，用size代替。

Example:login(length:5..15)

Errormessagecode:

className.propertyName.length.toolong

matches

应用正则表达式对字符串进行验证。

Example:login(matches:"a-zA-Z+")

max

设定属性的最大值，值的类型必须跟属性一样。

Example:

age(max:newDate())

price(max:999F)

maxLength

设定字符串或者数组的最大长度。

在0.5版本中被取消，由maxSize代替。

Example:login(maxLength:5)

maxSize

设定一个数字或者集合的最大大小。

在0.5版本中不被建议用在数字上，改用max。

Example:children(maxSize:25)

min

设定属性的最小值。类型必须跟属性一致。

Example:

age(min:newDate())

price(min:0F)

minLength

设定字符串属性或者数组属性的最小长度。

在0.5版本中被取消，由minSize代替。

Example:login(minLength:5)

minSize

设定一个数字或者集合的最小大小。

在0.5版本中不被建议用在数字属性上，改用min。

Example:children(minSize:5)

notEqual

验证属性的值是否跟指定的值相等。

Example:login(notEqual:"Bob")

nullable

如果属性不可以为null，则设为false。

Note:如果在表单里未填任何东西而提交时，则作为requestparameter，属性的值为一个空字符串，而不是null。

Example:age(nullable:false)

range

限制属性的值在指定的范围里。

Example:age(range:minAge..maxAge)

Errormessagecode:

className.propertyName.range.toosmall

scale

版本0.4才开始出现的约束属性。

根据设定的scale数值，自动把浮点型数字小数点后的位数调整为设定的值。

适用于以下数值类型：java.lang.Float,Java.lang.Double,andJava.math.BigDecimal(anditssubclasses)。

Example:salary(scale:2)

size

规定一个数值，集合或者字符串长度的大小。

在版本0.5中不被建议用在数字类型的属性上，改用range。

Example:children(size:5..15)

Note:不能使用这个约束属性如果blank设为true或者nullable设为true。

Errormessagecode:

className.propertyName.size.toosmall

unique

如果属性必须为唯一，则设为true。

Example:login(unique:true)

Note:有可能会发生通过unique验证但是在随后的数据库储存出现错误的情况。预防这种情况发生的方法是使用连续事务隔离级别或者进行eception的处理。

从版本0.5开始，unique的范围（Scope）可以被指定。"Scope"是同一个类里其他属性的名字，或者这些属性名字的一个list。

Example:group(unique:'department')

上面的例子里group名在一个department里是唯一的，但是可能在其他department里有相同名字的groups。

AnotherExample:login(unique:'group','department')

在这个例子，login在group和department里必须是唯一的。可能在不同等group和department里会有相同的login。

url

如果属性为一个URL地址，则设为true。

Example:homePage(url:true)

validator

在闭包里设定自定义的验证。

even( validator:
{ return

 (it % 2) == 0 }
)
Error message code (default

): className.propertyName.validator.invalid