AddRequestParameter 过滤器

DeepSeek V3 中英对照 AddRequestParameter Filter AddRequestParameter Filter

AddRequestParameter 过滤器接收 name 和 value 参数。以下示例配置了一个 AddRequestParameter 过滤器：

application.yml

spring:
  cloud:
    gateway:
      server:
        webmvc:
          routes:
            - id: add_request_parameter_route
              uri: https://example.org
              predicates:
              - Path=/anything/addrequestparam
              filters:
              - AddRequestParameter=red, blue

import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.uri;
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> gatewayRouterFunctionsAddReqParameter() {
        return route("add_request_parameter_route")
            .GET("/anything/addrequestparam", http())
            .before(uri("https://example.org"))
            .before(addRequestParameter("red", "blue"))
            .build();
    }
}

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

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

import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.uri;
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> gatewayRouterFunctionsAddReqParameter() {
        return route("add_request_parameter_route")
            .route(host("{segment}.myhost.org"), http())
            .before(uri("https://example.org"))
            .before(addRequestParameter("foo", "bar-{segment}"))
            .build();
    }
}