对于最新稳定版本,请使用Spring Framework 7.0.1spring-doc.cadn.net.cn

方法参数

下表展示了支持的控制器方法参数。spring-doc.cadn.net.cn

反应类型(Reactor、RxJava 或其他)包括 支持需要阻塞I/O的参数(例如读取请求体) 解决。这在描述栏中标记。反应型不被期望 关于不需要阻挡的论点。spring-doc.cadn.net.cn

JDK 1.8java.util.Optional作为方法参数支持,与 具有必填属性(例如,@RequestParam,@RequestHeader, 以及其他)等价于required=false.spring-doc.cadn.net.cn

控制器方法参数 描述

ServerWebExchangespring-doc.cadn.net.cn

完整访问ServerWebExchange——用于HTTP请求和响应的容器, 请求属性和会话属性,检查非修改方法,以及其他。spring-doc.cadn.net.cn

ServerHttpRequest,ServerHttpResponsespring-doc.cadn.net.cn

访问HTTP请求或响应。spring-doc.cadn.net.cn

网络会话spring-doc.cadn.net.cn

访问会议内容。除非属性 被添加。支持反应型。spring-doc.cadn.net.cn

java.security.Principalspring-doc.cadn.net.cn

当前认证的用户——可能是某个特定的用户主要如果已知实现类。 支持反应型。spring-doc.cadn.net.cn

org.springframework.http.HttpMethodspring-doc.cadn.net.cn

请求的HTTP方法。spring-doc.cadn.net.cn

java.util.Localespring-doc.cadn.net.cn

当前请求地点,由最具体的决定LocaleResolver可得 — 在 效果,配置LocaleResolver/LocaleContextResolver.spring-doc.cadn.net.cn

java.util.TimeZone + java.time.ZoneIdspring-doc.cadn.net.cn

与当前请求相关的时区,由LocaleContextResolver.spring-doc.cadn.net.cn

@PathVariablespring-doc.cadn.net.cn

用于访问URI模板变量。参见URI模式spring-doc.cadn.net.cn

@MatrixVariablespring-doc.cadn.net.cn

用于访问URI路径段中的名值对。参见矩阵变量spring-doc.cadn.net.cn

@RequestParamspring-doc.cadn.net.cn

用于访问查询参数。参数值转换为声明的方法参数 类型。看@RequestParam.spring-doc.cadn.net.cn

注意 的使用@RequestParam是可选的——例如,用于设置其属性。 请参见表后面的“任何其他论证”。spring-doc.cadn.net.cn

@RequestHeaderspring-doc.cadn.net.cn

用于访问请求头。头部值会转换为声明的方法参数 类型。看@RequestHeader.spring-doc.cadn.net.cn

@CookieValuespring-doc.cadn.net.cn

用于访问Cookie。Cookie 值会转换为声明的方法参数类型。 看@CookieValue.spring-doc.cadn.net.cn

@RequestBodyspring-doc.cadn.net.cn

用于访问HTTP请求体。正文内容转换为声明的方法 参数类型通过使用HttpMessageReader实例。支持反应型。 看@RequestBody.spring-doc.cadn.net.cn

HttpEntity<B>spring-doc.cadn.net.cn

用于访问请求头和正文。主体被转换为HttpMessageReader实例。 支持反应型。看Http实体.spring-doc.cadn.net.cn

@RequestPartspring-doc.cadn.net.cn

访问 a 中的某个部分多部分/形式-数据请求。支持反应型。 参见多部分内容多部分数据spring-doc.cadn.net.cn

java.util.Map,org.springframework.ui.Modelorg.springframework.ui.ModelMap.spring-doc.cadn.net.cn

用于访问HTML控制器中使用并暴露于模板的模型,具体为 视图渲染的一部分。spring-doc.cadn.net.cn

@ModelAttributespring-doc.cadn.net.cn

对于访问模型中已有的属性(如果不存在则已实例化),用 采用数据绑定和验证。看@ModelAttribute也 如DataBinder.spring-doc.cadn.net.cn

注意 的使用@ModelAttribute是可选的——例如,用于设置其属性。 请参见表后面的“任何其他论证”。spring-doc.cadn.net.cn

错误,绑定结果spring-doc.cadn.net.cn

用于访问命令对象的验证和数据绑定错误,即@ModelAttribute论点。一错误绑定结果必须声明 紧接验证方法论元之后。spring-doc.cadn.net.cn

会话状态+ 班级@SessionAttributesspring-doc.cadn.net.cn

对于表单处理完成,触发会话属性清理 通过阶级层面宣布@SessionAttributes注解。 看@SessionAttributes更多细节请阅读。spring-doc.cadn.net.cn

UriComponents构建器spring-doc.cadn.net.cn

用于准备一个与当前请求主机、端口、方案相关的URL和 上下文路径。请参见URI链接spring-doc.cadn.net.cn

@SessionAttributespring-doc.cadn.net.cn

访问任何会话属性——与会话中存储的模型属性不同 作为类级的产物@SessionAttributes声明。看@SessionAttribute更多细节请阅读。spring-doc.cadn.net.cn

@RequestAttributespring-doc.cadn.net.cn

用于访问请求属性。看@RequestAttribute更多细节请阅读。spring-doc.cadn.net.cn

其他任何论点spring-doc.cadn.net.cn

如果方法参数与上述任何一项不匹配,默认解析为 一个@RequestParam如果它是简单类型,由 BeanUtils#isSimpleProperty 确定, 或者作为@ModelAttribute否则。spring-doc.cadn.net.cn