(Quick Reference)
unique
Purpose
Constrains a property as unique at the database level
Examples
Description
Set to
true if the property must be unique. This is a persistent call and will query the database.
It is possible (though unlikely in practice) for uniqueness validation to pass but for the subsequent save to fail. If another save or update happens to update the database between the Grails check and the actual save of your instance, the call will fail. The only way to prevent this would be to use a transaction at the SERIALIZABLE isolation level, but this is very bad for performance.
You can also define multi-column
unique constraints by declaring the other field(s) to be included as the parameter value. If there is one other field, specify its name, but if there are more than one use a List, for example:
Example:
group unique: 'department'
In this example the
group name must be unique in one
department but there might be groups with same name in different departments, i.e. the group name isn't unique by itself.
Another example:
username(unique: ['group', 'department'])
In this example
username must be unique in
group and
department. There might be same logins in different groups or different departments.
This constraint influences
schema generation.
Error Code:
className.propertyName.unique
