本文主要是介绍SpringCloud Gateway中Filters详细说明,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
前面 SpringCloud Gateway中Route Predicate Factories详细说明 我们研究了GateWay中各种路由断言的使用。另外,SpringCloud GateWay 还提供了各种过滤器用来对请求和响应进行处理。
官网地址:SpringCloud Gateway Filter
【1】GatewayFilter Factories
路由过滤器允许对请求和响应进行修改。路由过滤器只作用于特定路由,如果想某些规则应用于所有路由,那么需要使用 spring.cloud.gateway.default-filters.
。
Spring Cloud Gateway包含了许多内置GatewayFilter Factories。
如图所示这里有31个过滤器,这里只捡几个说明,感兴趣的可以查看官方文档。
① AddRequestHeader GatewayFilter Factory
为指定路由添加请求头,需要两个参数:请求头名称和值。值格式同样支持URI variables 。
spring:cloud:gateway:routes:- id: add_request_header_routeuri: https://example.orgfilters:- AddRequestHeader=X-Request-red, blue
② AddRequestParameter GatewayFilter Factory
为指定路由匹配的所有请求添加请求参数。需要两个参数:请求参数名称和值。值格式同样支持URI variables 。
spring:cloud:gateway:routes:- id: add_request_parameter_routeuri: https://example.orgfilters:- AddRequestParameter=red, blue
③ AddResponseHeader GatewayFilter Factory
为指定路由匹配的所有请求添加响应头。需要两个参数:响应头名称和值。值格式同样支持URI variables 。
spring:cloud:gateway:routes:- id: add_response_header_routeuri: https://example.orgfilters:- AddResponseHeader=X-Response-Red, Blue
④ DedupeResponseHeader GatewayFilter Factory
Dedupe是重复数据消除的意思,也就是消除指定的请求头重复数据。
spring:cloud:gateway:routes:- id: dedupe_response_header_routeuri: https://example.orgfilters:- DedupeResponseHeader=Access-Control-Allow-Credentials Access-Control-Allow-Origin
上面将会消除Access-Control-Allow-Credentials和Access-Control-Allow-Origin的重复值。
⑨ PrefixPath GatewayFilter Factory
添加统一的请求前缀。
spring:cloud:gateway:routes:- id: prefixpath_routeuri: https://example.orgfilters:- PrefixPath=/mypath
将会为匹配的所有请求添加前缀 /mypath
,假设请求为/hello
将会变为 /mypath/hello
。
【2】Global Filters
SpringCloud Gateway同样内置了一些全局过滤器GlobalFilter ,GlobalFilter接口具有与GatewayFilter相同的特征。这些是有条件地应用于所有路由的特殊过滤器。
① Forward Routing Filter
从ServerWebExchangeUtils.GATEWAY_REQUEST_URL_ATTR获取uri,如果这个uri有一个 forward 协议比如forward:///localendpoint。那么就会使用Spring的DispatcherHandler 进行处理。
The path part of the request URL is overridden with the path in the forward URL. The unmodified original URL is appended to the list in the ServerWebExchangeUtils.GATEWAY_ORIGINAL_REQUEST_URL_ATTR attribute.
核心处理逻辑如下:
public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {URI requestUrl = (URI)exchange.getRequiredAttribute(ServerWebExchangeUtils.GATEWAY_REQUEST_URL_ATTR);String scheme = requestUrl.getScheme();if (!ServerWebExchangeUtils.isAlreadyRouted(exchange) && "forward".equals(scheme)) {if (log.isTraceEnabled()) {log.trace("Forwarding to URI: " + requestUrl);}return this.getDispatcherHandler().handle(exchange);} else {return chain.filter(exchange);}}
② LoadBalancerClient Filter
LoadBalancerClientFilter 会从 ServerWebExchangeUtils.GATEWAY_REQUEST_URL_ATTR获取uri,如果这个uri有一个 lb 协议比如lb://myservice
,它使用Spring Cloud LoadBalancerClient将服务名称(在本例中为myservice)解析为实际的主机和端口,并替换同一属性中的URI。
未被修改的原始URL将会追加到ServerWebExchangeUtils.GATEWAY_ORIGINAL_REQUEST_URL_ATTR中。
这个过滤器同样从ServerWebExchangeUtils.GATEWAY_SCHEME_PREFIX_ATTR寻找并判断是否有值等于lb,如果是,同样适用于该规则。下述实例配置了一个LoadBalancerClientFilter:
spring:cloud:gateway:routes:- id: myRouteuri: lb://servicepredicates:- Path=/service/**
默认情况下如果服务实例在LoadBalancer找不到,那么将会返回503。你可以通过配置将其修改为404.
spring.cloud.gateway.loadbalancer.use404=true
【3】自定义全局过滤器
上面都是Gateway给我们提供的各种Filter,实际业务中我们往往是通过实现GlobalFilter接口达到我们预期目标。
参考博文:SpringCloud Gateway使用过滤器对IP和接口进行策略限制
这篇关于SpringCloud Gateway中Filters详细说明的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!