使用 @ModelAttribute 实现模型数据绑定

## 章节一：理解 `@ModelAttribute` 注解的作用

### 1.1 `@ModelAttribute` 注解的作用介绍

`@ModelAttribute` 注解是 Spring MVC 提供的一个用于实现模型数据绑定的注解。它可以应用在方法参数、方法和表单字段上，用于将请求参数绑定到模型对象并传递给控制器方法进行处理。

### 1.2 `@ModelAttribute` 注解的使用场景

- 在方法参数中使用 `@ModelAttribute` 注解：用于绑定请求参数到特定的模型对象上，然后将该模型对象作为方法的参数来使用。
- 在方法中使用 `@ModelAttribute` 注解：用于声明一个方法，该方法会在每个请求处理方法之前执行，用于初始化模型对象。
- 在表单字段中使用 `@ModelAttribute` 注解：用于绑定表单字段到模型对象的属性上。

## 章节二：@ModelAttribute 注解的用法

在本章节中，我们将介绍如何正确使用 @ModelAttribute 注解来实现模型数据绑定。首先，我们将学习在方法参数中使用 @ModelAttribute 注解的用法，接着我们会说明如何在方法中使用 @ModelAttribute 注解。最后，我们会展示如何在表单中使用 @ModelAttribute 注解。

### 2.1 在方法参数中使用 @ModelAttribute 注解

`@ModelAttribute` 注解可以应用在方法的形参上，用于将请求参数绑定到模型数据上。当请求到达处理器方法时，DispatcherServlet会自动尝试将请求参数与方法参数进行绑定。

@Controller
public class UserController {

    @RequestMapping("/user/{id}")
    public String getUserById(@PathVariable("id") long id, @ModelAttribute("user") User user) {
        // 根据用户id查询数据库，然后将查询结果设置到User对象中
        // ...
        
        return "user";
    }
}

在上述例子中，`getUserById` 方法中的 `@ModelAttribute("user")` 注解将会将请求参数绑定到 `User` 对象中，并将对象设置到模型中，模型的属性名为 "user"。这样，在返回的视图中，可以直接使用 `user` 来获取模型中的数据。

### 2.2 在方法中使用 @ModelAttribute 注解

除了在方法参数中使用 `@ModelAttribute` 注解，我们还可以在方法体内使用该注解，将数据添加到模型中。

@Controller
public class UserController {

    @ModelAttribute("cities")
    public List<String> getCities() {
        // 查询数据库获取城市列表
        // ...
        
        return cities;
    }

    @RequestMapping("/user/{id}")
    public String getUserById(@PathVariable("id") long id, Model model) {
        // 查询数据库获取用户数据
        // ...
        model.addAttribute("user", user);
        
        return "user";
    }
}

在上述例子中，`getCities` 方法中的 `@ModelAttribute("cities")` 注解将会将查询得到的城市列表设置到模型中，模型的属性名为 "cities"。这样，在返回的视图中，可以直接使用 `${cities}` 来获取模型中的数据。

### 2.3 在表单中使用 @ModelAttribute 注解

除了从方法参数或方法体中将数据绑定到模型中，我们还可以在表单中使用 `@ModelAttribute` 注解。在提交表单时，`@ModelAttribute` 注解可以将表单的数据绑定到模型中。

<form action="/user/save" method="post">
    <input type="text" name="username" />
    <input type="password" name="password" />
    <input type="submit" value="Save" />
</form>

@Controller
public class UserController {

    @PostMapping("/user/save")
    public String saveUser(@ModelAttribute("user") User user) {
        // 保存用户数据到数据库
        // ...
        
        return "redirect:/user/" + user.getId();
    }
}

在上述例子中，表单中的用户名和密码会被自动绑定到 `User` 对象的相应属性中，然后可以通过 `@ModelAttribute`