在方法参数上使用@ModelAttribute表明参数的值需要从model中获取。如果model不存在，参数应当首先被实例化然后添加进model。一旦model存在，参数的属性需要从名称匹配的请求参数中获取。

示例

@RequestMapping(value="/owners/{ownerId}/pets/{petId}/edit", method=RequestMethod.POST)public String processSubmit(@ModelAttribute Pet pet){}

上面示例中pet实例的来源，有以下几种情况：

    可能已经存在由于使用了@SessionAttributes。    由于在同一个控制器中的@ModelAttribute方法。    可能基于URI模板变量和类型转换器检索。    可能有默认的构造函数实例化。

@ModelAttribute方法是一种获取通过使用@SessionAttributes存储在请求中的属性普通方式。在某些情况下通过使用URI模板变量和类型转换器检索属性会更方便。

示例

@RequestMapping(value="/account/{account}", method=RequestMethod.PUT)public String save(@ModelAttribute("account") Account account){}

示例中model属性与URI模板变量名相匹配。如果注册了可以将String类型的account值转换为Account实例的Converter<String, Account>，上面的示例可以不需要@ModelAttribute方法。

下一步是数据绑定。WebDataBinder类将表单域和字符串参数按照名字与model属性匹配。

匹配的域会进过必要的类型转换。

数据绑定过程中可能会产生缺少必须的域或类型转换等错误。在紧跟@ModelAttribute参数添加BindingResult参数来检查此类错误。

示例

@RequestMapping(value="/owners/{ownerId}/pets/{petId}/edit", method=RequestMethod.POST)public String processSubmit(@ModelAttribute("pet") Pet pet, BindResult result){  if(result.hasErrors()){    retrun "petForm";  }}

通过BindResult可以检查是否存在错误。通过使用Spring的errors表单标签显示错误。

在数据绑定中可以通过BindingResult使用自定义的校验器来记录数据绑定错误。这样可以将数据绑定错误存放在一个地方反馈给用户。

示例

@RequestMapping(value="/owners/{ownerId}/pets/{petId}/edit", method=RequestMethod.POST)public String processSubmit(@ModelAttribute("pet") Pet pet, BindingResult result){  new PetValidator().validate(pet, reult);  if(result.hasErrors){    return "petForm";  }}

或者通过添加JSR-303@Valid注解自动校验。