What is a data binder ?
Spring MVC uses Java beans for form modeling, it lets you create forms that have statically typed fields. Instead of retrieving a form in plain text, Spring does automatically the mapping between your HTML form and your Java Bean, even if the types are not only “String”.
The mechanism behind this is simple, by default Spring has registered a lot of data binders for common types (Integer, BigDecimal, Enum, etc.). For each HTML field binded to a Java Bean, Spring will look for the correct binder to use and will do the conversion. The binding between the HTML form and the Java Bean is done thanks to the Spring taglib “form”.
If you create a custom Java type and if you want to use in a HTML form, you should register a new data binder.
Example of use : Change the default data binder for the BigDecimal class
During a project I faced a problem with the default BigDecimal data binder, it does not allow the comma as decimal separator (by default it uses a dot).
In France we mainly use the comma, but it could be great if the dot could be used too. In order to allow the user to use these two characters, I created a specific data binder that replace each dot with a comma (we do not use thousand separator in France).
The following snippet contains the declaration of the binder, it should be put in the controller called at the submitting of your HTML form.
In this example I used Spring Web 3.2.
Et voilà! Now all the BigDecimal input fields used in our HTML form accept both comma and dot as the decimal separator character.