跳到主要内容

AddRequestParameter 过滤器

DeepSeek V3 中英对照 AddRequestParameter Filter AddRequestParameter Filter

AddRequestParameter 过滤器需要一个 namevalue 参数。以下示例配置了一个 AddRequestParameter 过滤器:

application.yml
yaml
spring:
cloud:
gateway:
mvc:
routes:
- id: add_request_parameter_route
uri: https://example.org
filters:
- AddRequestParameter=red, blue
yaml
import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.addRequestParameter;
import static org.springframework.cloud.gateway.server.mvc.handler.GatewayRouterFunctions.route;
import static org.springframework.cloud.gateway.server.mvc.handler.HandlerFunctions.http;

@Configuration
class RouteConfiguration {

@Bean
public RouterFunction<ServerResponse> gatewayRouterFunctionsAddReqHeader() {
return route("add_request_parameter_route")
.GET("/anything/addrequestparam", http("https://example.org"))
.before(addRequestParameter("red", "blue"))
.build();
}
}
java

这将会为所有匹配的请求在下游请求的查询字符串中添加 red=blue

AddRequestParameter 能够识别用于匹配路径或主机的 URI 变量。URI 变量可以在值中使用,并在运行时进行扩展。以下示例配置了一个使用变量的 AddRequestParameter 过滤器:

import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.addRequestParameter;
import static org.springframework.cloud.gateway.server.mvc.handler.GatewayRouterFunctions.route;
import static org.springframework.cloud.gateway.server.mvc.handler.HandlerFunctions.http;
import static org.springframework.cloud.gateway.server.mvc.predicate.GatewayRequestPredicates.host;

@Configuration
class RouteConfiguration {

@Bean
public RouterFunction<ServerResponse> gatewayRouterFunctionsAddReqHeader() {
return route("add_request_parameter_route")
.route(host("{segment}.myhost.org"), http("https://example.org"))
.before(addRequestParameter("foo", "bar-{segment}"))
.build();
}
}
java