在Spring WebFlux框架中，org.springframework.http.server.reactive.ServerHttpRequest 是处理HTTP请求的核心接口，专为反应式编程设计。它提供了访问请求信息的方法，如请求头、路径、查询参数等，并支持非阻塞、事件驱动的数据处理。本文将详细介绍ServerHttpRequest的几个关键方法以及如何使用其Builder进行请求的修改与传递，尤其是在网关层面的高级应用。
ServerHttpRequest 简介
ServerHttpRequest 接口代表了一个HTTP请求，提供了访问请求各种属性的方法，如请求方法（GET、POST等）、请求路径、查询参数等。它是Spring WebFlux中实现异步、非阻塞HTTP请求处理的基础。
关键方法介绍
1. Builder
Builder是用于创建或修改ServerHttpRequest实例的工具。通过ServerHttpRequest.toBuilder()方法可以获得一个Builder实例，进而修改请求的各种属性，这对于在网关层面动态调整请求细节非常有用。
2. getId()
返回请求的唯一标识符。这在跟踪和日志记录中特别有用，帮助识别和关联特定的请求。
3. getPath()
返回请求的路径信息。可以通过此方法获取请求的目标资源路径。
4. getQueryParams()
获取请求的查询参数。返回的是一个MultiValueMap<String, String>，可以用来访问所有查询参数及其多个值。
5. getCookies()
获取请求中的Cookie。同样以MultiValueMap<String, Cookie>的形式返回，便于处理Cookie信息。
6. getLocalAddress()
返回接收请求的服务器的IP地址和端口号，这对于日志记录和调试很有帮助。
7. getRemoteAddress()
获取客户端的IP地址和端口号，对于安全验证、访问控制等场景非常重要。
8. getSslInfo()
当请求通过HTTPS发起时，此方法提供SSL会话的信息。可用于检查连接的安全性状态。
9. mutate()
此方法返回一个新的ServerHttpRequest.Builder，允许基于现有请求创建一个修改过的请求实例，而不会影响原始请求。这对于在网关中修改请求路径、添加/删除请求头等操作尤为关键。
网关中使用 mutate 传递和修改请求
在Spring Cloud Gateway或其他类似的API网关应用中，经常需要根据某些策略动态修改进来的请求，比如重定向请求、添加认证信息到请求头等。mutate方法正是实现这一需求的利器。
示例：动态添加请求头
假设在一个网关应用中，我们需要在每个请求上添加一个特定的请求头用于追踪或传递一些元数据。以下是如何使用mutate方法实现这一需求的示例：
public Mono<Void> modifyRequestHeader(ServerHttpRequest request, GatewayFilterChain chain) { // 创建请求的Builder并修改请求头 ServerHttpRequest mutatedRequest = request.mutate() .header("X-Custom-Header", "SomeValue") .build(); // 使用修改后的请求继续处理 return chain.filter(mutatedRequest); }
在这个例子中，我们通过调用request.mutate()获得一个Builder实例，然后使用.header()方法添加了一个新的请求头。最后，通过.build()生成一个新的ServerHttpRequest实例，并将它传递给过滤链的下一个处理器，这样后续的处理逻辑就会基于这个修改后的请求进行。
通过这种方式，网关不仅能够透明地代理请求，还能在不影响原有请求的前提下，灵活地对其进行定制化处理，增强了系统的灵活性和可扩展性。
