(Quick Reference)



Allows fine-grained control of binding request parameters from strings onto objects and the necessary types (data binding).


// binds request parameters to a target object
bindData(target, params)

// exclude firstName and lastName bindData(target, params, ['firstName', 'lastName'])

// only use parameters starting with "author." e.g. author.email bindData(target, params, "author") bindData(target, params, ['firstName', 'lastName'], "author")

// using inclusive map bindData(target, params, [include: ['firstName', 'lastName']], "author")

// using exclusive map bindData(target, params, [exclude: ['firstName', 'lastName']], "author")


Usage: bindData(target, params, excludes, prefix)


  • target - The target object to bind to
  • params - A Map of source parameters, often the params object when used in a controller
  • excludes - The parameter names to exclude
  • prefix - A string representing a prefix to use to filter parameters. A prefix separator of "." is assumed

The underlying implementation uses Spring's Data Binding framework. If the target is a domain class, type conversion errors are stored in the errors property of the domain class.

Refer to the section on Data Binding in the user guide for more information.