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

Model

请参阅 Servlet 堆栈中的等效项spring-doc.cadn.net.cn

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

本节讨论@ModelAttribute方法或前面列表中的第二项。 控制器可以具有任意数量的@ModelAttribute方法。所有这些方法都是 之前调用@RequestMapping方法。一个@ModelAttribute方法也可以通过@ControllerAdvice.有关更多详细信息，请参阅 Controller Advice 部分。spring-doc.cadn.net.cn

@ModelAttribute方法具有灵活的方法签名。它们支持许多相同的 arguments 设置为@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);
}
如果未明确指定名称，则根据类型选择默认名称。 如 Javadoc 中所述Conventions. 您始终可以使用重载的addAttributemethod 或 通过 name 属性@ModelAttribute（对于返回值）。

与 Spring MVC 不同，Spring WebFlux 在模型中显式支持响应式类型 （例如，Mono<Account>或io.reactivex.Single<Account>).这种异步模型 属性可以透明地解析（并更新模型）为其实际值 在@RequestMappingininvokecation 中，提供了@ModelAttributeargument 是 在没有包装器的情况下声明，如下例所示：spring-doc.cadn.net.cn

@ModelAttribute
public void addAccount(@RequestParam String number) {
    Mono<Account> accountMono = accountRepository.findAccount(number);
    model.addAttribute("account", accountMono);
}

@PostMapping("/accounts")
public String handle(@ModelAttribute Account account, BindingResult errors) {
	// ...
}
import org.springframework.ui.set

@ModelAttribute
fun addAccount(@RequestParam number: String) {
	val accountMono: Mono<Account> = accountRepository.findAccount(number)
	model["account"] = accountMono
}

@PostMapping("/accounts")
fun handle(@ModelAttribute account: Account, errors: BindingResult): String {
	// ...
}

此外，任何具有响应式类型包装器的模型属性都会被解析为它们的 实际值（并更新了模型）。spring-doc.cadn.net.cn

您还可以使用@ModelAttribute作为@RequestMapping方法，在这种情况下，@RequestMappingmethod 被解释为 model 属性。这通常不是必需的，因为它是 HTML 中的默认行为 控制器，除非返回值是String否则会被解释为 作为视图名称。@ModelAttribute还可以帮助自定义 Model 属性名称， 如下例所示：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
}