对于最新的稳定版本，请使用 Spring Framework 7.0.6!spring-doc.cadn.net.cn

模型

请参阅响应式栈中的等效项spring-doc.cadn.net.cn

您可以使用@ModelAttribute注解：spring-doc.cadn.net.cn

  • 在 方法参数 中，在 @RequestMapping 个方法 中创建或访问模型中的 Object 并通过 WebDataBinder 将其绑定到请求。spring-doc.cadn.net.cn

  • 作为方法级别的注解在@Controller或@ControllerAdvice类中，这些类有助于在任何@RequestMapping方法调用之前初始化模型。spring-doc.cadn.net.cn

  • 在 @RequestMapping 方法上标记其返回值为模型属性。spring-doc.cadn.net.cn

本节讨论 @ModelAttribute 方法——前述列表中的第二项。
控制器可以有任意数量的 @ModelAttribute 方法。所有这些方法都在同一控制器中的 @RequestMapping 方法之前被调用。@ModelAttribute 方法也可以通过 @ControllerAdvice 在控制器之间共享。有关详细信息，请参阅控制器建议部分。spring-doc.cadn.net.cn

@ModelAttribute 方法具有灵活的方法签名。它们支持与 @RequestMapping 方法相同的许多参数，但不包括 @ModelAttribute 本身或任何与请求正文相关的内容。spring-doc.cadn.net.cn

以下示例展示了一个@ModelAttribute方法：spring-doc.cadn.net.cn

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

以下示例仅添加了一个属性：spring-doc.cadn.net.cn

@ModelAttribute
public Account addAccount(@RequestParam String number) {
	return accountRepository.findAccount(number);
}
@ModelAttribute
fun addAccount(@RequestParam number: String): Account {
	return accountRepository.findAccount(number)
}
当名称未明确指定时，将根据 Object 类型选择一个默认名称，如 Conventions 的 javadoc 中所述。您始终可以通过使用重载的 addAttribute 方法或通过 name 属性在 @ModelAttribute 上（对于返回值）来分配一个显式名称。

您还可以在@RequestMapping方法上使用@ModelAttribute作为方法级注解, 在这种情况下，@RequestMapping方法的返回值将被解释为模型属性。这通常不是必需的，因为这是HTML控制器中的默认行为, 除非@RequestMapping方法的返回值是String，否则会被解释为视图名称。@ModelAttribute还可以自定义模型属性名称，如下例所示:spring-doc.cadn.net.cn

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