Validation

Validating Domain Classes

Grails allows you to apply constraints to a domain class that can then be used to validate a domain class instance. Constraints are applied using a "constraints" closure which uses the Groovy builder syntax to configure constraints against each property name, for example:

class User {
   @Property Long id
   @Property Long version

   @Property String login
   @Property String password
   @Property String email
   @Property Date age

   @Property constraints = {
          login(length:5..15,blank:false,unique:true)
          password(length:5..15,blank:false)
          email(email:true,blank:false)
          age(min:new Date(),nullable:false)
   }
}

To validate a domain class you can call the "validate()" method on any instance:

def user =  new User()
       // populate properties

       if(user.validate()) {
          // do something with user
       }
       else {
           user.errors.allErrors.each {
               println it
           }
       }

By default the persistent "save()" method calls validate before executing hence allowing you to write code like:

if(user.save()) {
           return user
       }
       else {
           user.errors.allErrors.each {
               println it
           }
       }

For a full reference see the Validation Reference

Display Errors in the View

So your instance doesn't validate, how do you now display an appropriate error message in the view? For starters you need to redirect to the right action or view with your erroneous bean:

class UserController {
    @Property save = {
           def u = new User()
           u.properties = params
           if(u.save()) {
              // do something
           }
           else {
               render(view:'create',model:[user:u])
           }
    }
}

In this case we use the render method to render the right view, alternatively you could chain the model back to a "create" action:

chain(action:create,model:[user:u])

The chain method stored the model in flash scope so that it is available in the request even after the redirect.

So now to the view, you clearly have an instance with errors, to display them we use a special tag called "hasErrors":

<g:hasErrors bean="${user}>
         <g:renderErrors bean="${user}" as="list" />
   </g:hasErrors>

This is used in conjunction with the tag "renderErrors" which renders the errors as a list. In GSP because you can call tags as regular methods calls it also means you can do some neat tricks to highlight the errors really easily such as:

<div class="prop ${hasErrors(bean:user,field:'login', 'errors')}">
    <label for="login"><input type="text" name="login" />
</div>

The above code will add the "errors" CSS class to the property if there are any errors for the field 'login' now simply add a CSS style:

.errors { border: 1px solid red }

And you have the erroneous field highlighting when there is a problem.

Changing the Error Message

Of course the default error message that Grails displays is probably not what you were after, so you will want to change this. The way you do this is by modifying the "grails-app/i18n/messages.properties" file and adding a message for the particular error code.

For example if we follow the above example the error code may be "user.login.length.tooshort" so we add an entry:

user.login.length.tooshort=I'm sorry the login you entered wasn't quite long enough, please make it longer

For a complete list of error codes and how they correspond to validation constraints see the Validation Reference