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):获取请求属性。
示例:
-
java">@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)。
-
示例:
java">@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():获取会话。
-
示例:
java">@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 更高级,封装了更多功能,适合复杂的业务场景。