`AddRequestHeadersIfNotPresent` 過濾器

AddRequestHeadersIfNotPresent 過濾器接收一個由冒號分隔的 name 和 value 對的集合。以下示例配置了一個 AddRequestHeadersIfNotPresent 過濾器。

application.yml

spring:
  cloud:
    gateway:
      mvc:
        routes:
        - id: add_request_headers_route_inp
          uri: https://example.org
          predicates:
          - Path=/red
          filters:
          - AddRequestHeadersIfNotPresent=X-Request-Color-1:blue,X-Request-Color-2:green

GatewaySampleApplication.java

import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.uri;
import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.addRequestHeadersIfNotPresent;
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> gatewayRouterFunctionsAddReqHeaderInp() {
        return route("add_request_headers_route_inp")
            .GET("/red", http())
            .before(uri("https://example.org"))
            .before(addRequestHeadersIfNotPresent("X-Request-Color-1:blue","X-Request-Color-2:green"));
    }
}

此清單為所有匹配請求的下游請求頭添加了兩個請求頭 X-Request-Color-1:blue 和 X-Request-Color-2:green。這與 AddRequestHeader 的工作方式類似，但與 AddRequestHeader 不同的是，它只會在請求頭不存在時才新增。否則，將傳送客戶端請求中的原始值。

此外，要設定一個多值請求頭，請多次使用請求頭名稱，例如 addRequestHeadersIfNotPresent("X-Request-Color-1:blue","X-Request-Color-1:green")。

AddRequestHeadersIfNotPresent 也支援用於匹配路徑或主機的 URI 變數。URI 變數可在值中使用，並在執行時進行擴充套件。以下示例配置了一個使用變數的 AddRequestHeadersIfNotPresent 過濾器。

GatewaySampleApplication.java

import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.addRequestHeadersIfNotPresent;
import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.uri;
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> gatewayRouterFunctionsAddReqHeaderInp() {
        return route("add_request_header_route_inp")
            .GET("/red/{segment}", http())
            .before(uri("https://example.org"))
            .before(addRequestHeadersIfNotPresent("X-Request-red", "blue-{segment}"));
    }
}

application.yml

spring:
  cloud:
    gateway:
      routes:
      - id: add_request_header_route_inp
        uri: https://example.org
        predicates:
        - Path=/red/{segment}
        filters:
        - AddRequestHeadersIfNotPresent=X-Request-Red:Blue-{segment}

AddRequestHeadersIfNotPresent 過濾器

`AddRequestHeadersIfNotPresent` 過濾器