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

@RequestHeader

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

您可以使用@RequestHeader注解将请求头绑定到控制器中的方法参数。spring-doc.cadn.net.cn

以下示例展示了一个带有标头的请求：spring-doc.cadn.net.cn

Host                    localhost:8080
Accept                  text/html,application/xhtml+xml,application/xml;q=0.9
Accept-Language         fr,en-gb;q=0.7,en;q=0.3
Accept-Encoding         gzip,deflate
Accept-Charset          ISO-8859-1,utf-8;q=0.7,*;q=0.7
Keep-Alive              300

以下示例获取标头 Accept-Encoding 和 Keep-Alive 的值：spring-doc.cadn.net.cn

@GetMapping("/demo")
public void handle(
		@RequestHeader("Accept-Encoding") String encoding, (1)
		@RequestHeader("Keep-Alive") long keepAlive) { (2)
	//...
}
1 获取 Accept-Encoding 标头的值。
2 获取 Keep-Alive 标头的值。 
@GetMapping("/demo")
fun handle(
		@RequestHeader("Accept-Encoding") encoding: String, (1)
		@RequestHeader("Keep-Alive") keepAlive: Long) { (2)
	//...
}
1 获取 Accept-Encoding 标头的值。
2 获取 Keep-Alive 标头的值。

类型转换会自动应用，如果目标方法参数类型不是String。请参见类型转换。spring-doc.cadn.net.cn

当一个@RequestHeader注解用于一个Map<String, String>, MultiValueMap<String, String>, 或 HttpHeaders参数时，该映射将填充 所有头值。spring-doc.cadn.net.cn

内置支持可用于将逗号分隔的字符串转换为字符串数组或类型转换系统已知的其他类型的集合。例如，带有@RequestHeader("Accept")注解的方法参数可以是String类型，也可以是String[]或List<String>。