模型

DeepSeek V3 中英对照 Model

查看 Reactive 堆栈中的等效内容

你可以使用 @ModelAttribute 注解：

• 在 @RequestMapping 方法的方法参数上使用，以从模型中创建或访问一个 Object，并通过 WebDataBinder 将其绑定到请求中。

• 作为 @Controller 或 @ControllerAdvice 类中的方法级注解，用于在任何 @RequestMapping 方法调用之前初始化模型。

• 在 @RequestMapping 方法上使用，以标记其返回值是一个模型属性。

本节讨论 @ModelAttribute 方法——即前述列表中的第二项。一个控制器可以拥有任意数量的 @ModelAttribute 方法。所有这些方法都会在同一控制器中的 @RequestMapping 方法之前被调用。@ModelAttribute 方法还可以通过 @ControllerAdvice 在多个控制器之间共享。更多详细信息，请参阅 Controller Advice 部分。

@ModelAttribute 方法具有灵活的方法签名。它们支持许多与 @RequestMapping 方法相同的参数，除了 @ModelAttribute 本身或与请求体相关的任何内容。

以下示例展示了一个 @ModelAttribute 方法：

Java

@ModelAttribute
public void populateModel(@RequestParam String number, Model model) {
    model.addAttribute(accountRepository.findAccount(number));
    // add more ...
}

java

Kotlin

@ModelAttribute
fun populateModel(@RequestParam number: String, model: Model) {
    model.addAttribute(accountRepository.findAccount(number))
    // add more ...
}

kotlin

以下示例仅添加一个属性：

Java

@ModelAttribute
public Account addAccount(@RequestParam String number) {
    return accountRepository.findAccount(number);
}

java

Kotlin

@ModelAttribute
fun addAccount(@RequestParam number: String): Account {
    return accountRepository.findAccount(number)
}

kotlin

备注

当未明确指定名称时，将根据 Object 类型选择一个默认名称，如 Conventions 的 javadoc 中所述。您始终可以通过使用重载的 addAttribute 方法或通过 @ModelAttribute 的 name 属性（用于返回值）来分配显式名称。

你也可以在 @RequestMapping 方法上使用 @ModelAttribute 作为方法级别的注解，在这种情况下，@RequestMapping 方法的返回值会被解释为一个模型属性。这通常不是必需的，因为在 HTML 控制器中这是默认行为，除非返回值是一个 String，否则它会被解释为视图名称。@ModelAttribute 还可以自定义模型属性的名称，如下例所示：

Java

@GetMapping("/accounts/{id}")
@ModelAttribute("myAccount")
public Account handle() {
    // ...
    return account;
}

java

Kotlin

@GetMapping("/accounts/{id}")
@ModelAttribute("myAccount")
fun handle(): Account {
    // ...
    return account
}

kotlin