Adds rewriterequestparameter-factory.adoc

See gh-3081
This commit is contained in:
sgibb
2023-10-04 15:46:18 -04:00
parent 77779ff91a
commit 9c11a8ed8a
2 changed files with 27 additions and 0 deletions

View File

@@ -33,6 +33,7 @@
*** xref:spring-cloud-gateway/gatewayfilter-factories/requestratelimiter-factory.adoc[]
*** xref:spring-cloud-gateway/gatewayfilter-factories/rewritelocationresponseheader-factory.adoc[]
*** xref:spring-cloud-gateway/gatewayfilter-factories/rewritepath-factory.adoc[]
*** xref:spring-cloud-gateway/gatewayfilter-factories/rewriterequestparameter-factory.adoc[]
*** xref:spring-cloud-gateway/gatewayfilter-factories/rewriteresponseheader-factory.adoc[]
*** xref:spring-cloud-gateway/gatewayfilter-factories/savesession-factory.adoc[]
*** xref:spring-cloud-gateway/gatewayfilter-factories/secureheaders-factory.adoc[]

View File

@@ -0,0 +1,26 @@
= `RewriteRequestParameter` `GatewayFilter` Factory
The `RewriteRequestParameter` `GatewayFilter` factory takes a `name` parameter and a `replacement` parameter.
It will rewrite the value of the request parameter of the given `name`.
If multiple request parameters with the same `name` are set, they will be replaced with a single value.
If no request parameter is found, no changes will be made.
The following listing configures a `RewriteRequestParameter` `GatewayFilter`:
.application.yml
====
[source,yaml]
----
spring:
cloud:
gateway:
routes:
- id: rewriterequestparameter_route
uri: https://example.org
predicates:
- Path=/products
filters:
- RewriteRequestParameter=campaign,fall2023
----
====
For a request to `/products?campaign=old`, this sets the request parameter to `campaign=fall2023`.