AddRequestHeadersIfNotPresent
GatewayFilter
ファクトリ
AddRequestHeadersIfNotPresent
GatewayFilter
ファクトリは、コロンで区切られた name
と value
のペアのコレクションを取ります。次の例では、AddRequestHeadersIfNotPresent
GatewayFilter
を構成します。
application.yml
spring:
cloud:
gateway:
routes:
- id: add_request_headers_route
uri: https://example.org
filters:
- AddRequestHeadersIfNotPresent=X-Request-Color-1:blue,X-Request-Color-2:green
このリストは、一致するすべてのリクエストのダウンストリームリクエストのヘッダーに X-Request-Color-1:blue
と X-Request-Color-2:green
の 2 つのヘッダーを追加します。これは AddRequestHeader
の動作と似ていますが、AddRequestHeader
とは異なり、ヘッダーがまだ存在しない場合にのみ実行されます。それ以外の場合は、クライアントリクエストの元の値が送信されます。
さらに、多値ヘッダーを設定するには、AddRequestHeadersIfNotPresent=X-Request-Color-1:blue,X-Request-Color-1:green
のようにヘッダー名を複数回使用します。
AddRequestHeadersIfNotPresent
は、パスまたはホストの照合に使用される URI 変数もサポートしています。URI 変数は値で使用でき、実行時に展開されます。次の例では、変数を使用する AddRequestHeadersIfNotPresent
GatewayFilter
を構成します。
application.yml
spring:
cloud:
gateway:
routes:
- id: add_request_header_route
uri: https://example.org
predicates:
- Path=/red/{segment}
filters:
- AddRequestHeadersIfNotPresent=X-Request-Red:Blue-{segment}