1、HttpServletRequest
所属框架:Java Servlet API(基于阻塞式 I/O)。
使用场景:传统的 Servlet 应用(如 Spring MVC的Tomcat、常用的容器等等)。
作用:表示客户端的 HTTP 请求。
常用方法:
getParameter(String name):获取请求参数。
getHeader(String name):根据名称获取单一的请求头
getMethod():获取 HTTP 方法(如 GET、POST)。
getRequestURI():获取请求的 URI。
getInputStream():获取请求体的输入流。
getSession():获取会话。
getAttribute(String name):获取请求属性。
示例:
@RestController
public class MyController {
@GetMapping("/hello")
public String hello(HttpServletRequest request) {
String name = request.getParameter("name");
return "Hello, " + name;
}
}
2、ServerHttpRequest
所属框架:Spring WebFlux(基于响应式编程,非阻塞式 I/O)。
使用场景:响应式 Web 应用(如 Spring WebFlux)。
作用:提供了访问请求信息的方法,如请求头、请求参数、请求体、支持响应式流处理。
常用方法:
getHeaders():获取请求头。
getMethod():获取 HTTP 方法。
getURI():获取请求的 URI。
getBody():获取请求体的响应式流(Flux)。
示例:
@RestController
public class MyController {
@GetMapping("/hello")
public Mono<String> hello(ServerHttpRequest request) {
String name = request.getQueryParams().getFirst("name");
return Mono.just("Hello, " + name);
}
}
3、ServerWebRequest
所属框架:Spring WebFlux(基于响应式编程,非阻塞式 I/O)。
使用场景:响应式 Web 应用(如 Spring WebFlux)。
作用:是对 ServerHttpRequest 和 ServerHttpResponse 的封装、提供了更高级的 API,用于访问请求和响应信息、支持响应式流处理。
常用方法:
getHeaders():获取请求头。
getMethod():获取 HTTP 方法。
getURI():获取请求的 URI。
getBody():获取请求体的响应式流(Flux)。
getAttribute(String name):获取请求属性。
getSession():获取会话。
示例:
@RestController
public class MyController {
@GetMapping("/hello")
public Mono<String> hello(ServerWebRequest request) {
String name = request.getQueryParams().getFirst("name");
return Mono.just("Hello, " + name);
}
}
4、使用场景总结
4.1、HttpServletRequest:
适用于传统的 Servlet 应用(如 Spring MVC)。
适合阻塞式 I/O 的场景。
4.2、ServerHttpRequest:
适用于响应式 Web 应用(如 Spring WebFlux)。
适合非阻塞式 I/O 的场景。
4.3、ServerWebRequest:
适用于响应式 Web 应用(如 Spring WebFlux)。
提供了更高级的 API,封装了 ServerHttpRequest 和 ServerHttpResponse。
5、总结
如果你使用的是传统的 Spring MVC,选择 HttpServletRequest。
如果你使用的是响应式 Spring WebFlux,选择 ServerHttpRequest 或 ServerWebRequest。
ServerHttpRequest 更底层,适合直接操作请求和响应。
ServerWebRequest 更高级,封装了更多功能,适合复杂的业务场景。