欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

Grails的域类验证详解

程序员文章站 2022-07-12 20:43:13
...

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

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

class TUser {
    String name
    String password
    String demo
    String help
   
    String toString(){
        "$name:$password"
    }
   
    static constraints = {
        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为空时返回"Please enter your email",则可以在message.properties定义:
user.email.blank=Please enter your email
如果用户没有自定义错误消息,系统则会用默认的设置。当然默认的消息肯定不会是你想要的......

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

blank
验证属性能否为空,不允许为空则设为false。
Note: 如果在form里为空而提交,则属性的值是一个空字符串,而不是null。
Example: login(blank:false)
Error message code: className.propertyName.blank

creditCard
如果要求属性为信用卡号码,则设为true。
Example: cardNumber(creditCard:true)
Error message code: className.propertyName.creditCard.invalid

email
如果要求属性为emial地址,则设为true。
Example: contactEmail(email:true)
Error message code: className.propertyName.email.invalid

inList
如果要求属性的值必须为规定的值,则定义规定的值。
Example: name(inList:"Joe", "Fred", "Bob" )
Error message code: className.propertyName.not.inList

length
约束字符串或者数组的长度。
这个约束属性在0.5版本是被取消,用size代替。
Example: login(length:5..15)
Error message code:
className.propertyName.length.toolong
className.propertyName.length.tooshort

matches
应用正则表达式对字符串进行验证。
Example: login(matches:"a-zA-Z +")
Error message code: className.propertyName.matches.invalid

max
设定属性的最大值,值的类型必须跟属性一样。
Example:
age(max:new Date())
price(max:999F)
Error message code: className.propertyName.max.exceeded

maxLength
设定字符串或者数组的最大长度。
在0.5版本中被取消,由maxSize代替。
Example: login(maxLength:5)
Error message code: className.propertyName.maxLength.exceeded

maxSize
设定一个数字或者集合的最大大小。
在0.5版本中不被建议用在数字上,改用max。
Example: children(maxSize:25)
Error message code: className.propertyName.maxSize.exceeded

min
设定属性的最小值。类型必须跟属性一致。
Example:
age(min:new Date())
price(min:0F)
Error message code: className.propertyName.min.notmet

minLength
设定字符串属性或者数组属性的最小长度。
在0.5版本中被取消,由minSize代替。
Example: login(minLength:5)
Error message code: className.propertyName.minLength.notmet

minSize
设定一个数字或者集合的最小大小。
在0.5版本中不被建议用在数字属性上,改用min。
Example: children(minSize:5)
Error message code: className.propertyName.minSize.notmet

notEqual
验证属性的值是否跟指定的值相等。
Example: login(notEqual:"Bob")
Error message code: className.propertyName.notEqual

nullable
如果属性不可以为null,则设为false。
Note: 如果在表单里未填任何东西而提交时,则作为request parameter,属性的值为一个空字符串,而不是null。
Example: age(nullable:false)
Error message code: className.propertyName.nullable

range
限制属性的值在指定的范围里。
Example: age(range:minAge..maxAge)
Error message code:
className.propertyName.range.toosmall
className.propertyName.range.toobig

scale
版本0.4才开始出现的约束属性。
根据设定的scale数值,自动把浮点型数字小数点后的位数调整为设定的值。
适用于以下数值类型:java.lang.Float, Java.lang.Double, and Java.math.BigDecimal (and its subclasses)。
Example: salary(scale:2)
Error message code: 不返回错误信息

size
规定一个数值,集合或者字符串长度的大小。
在版本0.5中不被建议用在数字类型的属性上,改用range。
Example: children(size:5..15)
Note: 不能使用这个约束属性如果blank设为true或者nullable设为true。
Error message code:
className.propertyName.size.toosmall
className.propertyName.size.toobig

unique
如果属性必须为唯一,则设为true。
Example: login(unique:true)
Note: 有可能会发生通过unique验证但是在随后的数据库储存出现错误的情况。预防这种情况发生的方法是使用连续事务隔离级别或者进行eception的处理。
从版本0.5开始,unique的范围(Scope)可以被指定。"Scope"是同一个类里其他属性的名字,或者这些属性名字的一个list。
Example: group(unique:'department')
上面的例子里group名在一个department里是唯一的,但是可能在其他department里有相同名字的groups。
Another Example: login(unique:'group','department' )
在这个例子,login在group和department里必须是唯一的。可能在不同等group和department里会有相同的login。
Error message code: className.propertyName.unique

url
如果属性为一个URL地址,则设为true。
Example: homePage(url:true)
Error message code: className.propertyName.url.invalid

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

even( validator:
{ return

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

): className.propertyName.validator.invalid
相关标签: grails constraints