SpringCloudGateway-过滤器（五）

概述

Filter作用：在路由转发到代理服务之前和代理服务返回结果之后额外做的事情。
Filter执行了说明谓词条件通过了。
在Spring Cloud Gateway的路由中Filter分为：

• 内置Filter，都是GatewayFilter实现类。
• 自定义
• GlobalFilter

内置过滤器

注意简写和完整的配置写法。

AddRequestHeader

添加请求头参数，参数和值直接使用都会分隔

filters:
	- StripPrefix=1
	- AddRequestHeader=MyHeader,jqk

AddRequestParameter

添加请求表单参数，多个参数需要有多个过滤器

	- StripPrefix=1
	- AdddRequestParameter=name,bjxt
	- AddRequestParameter=age,123

AddResponseHeader

添加响应头

DedupeResponseHeader

对指定响应头去重复。
语法：DedupeResponseHeader=响应头参数 响应头参数,strategy
可选参数 strategy可取值：
RETAIN_FIRST 默认值，保留第一个
RETANIN_LAST 保留最后一个
RETAIN_UNIQUE 保留唯一的，出现重复的属性值，会保留一个。例如有两个my:bbb的属性，最后会留一个。

- DedupeResponseHeader=My Content-Type,RETAIN_UNIQUE

CircuitBreaker

实现熔断时使用，支持CircuitBreaker和Hystrix两种。

FallbackHeaders

可以添加降级时的异常信息。

PrefixPath

匹配所有前缀满足条件的URI

RequestRateLimiter

限流过滤器。

RedirectTO

重定向。有两个参数，status和url。其中status应该300系列重定向状态码。

RemoveRequestHeader

删除请求头参数。

RemoveResponseHeader

删除响应头参数。

RemoveRequestParameter

删除请求参数。

RewritePath

重新请求路径。

RewriteResponseHeader

重写响应头参数。

SaveSession

如果项目中使用Spring Security和Spring Session整合时，此属性特别重要。

SecureHeaders

具有权限验证时，建议的头信息内容。

SetPath

功能和StripPrefix有点类似。语法更贴近restful。
比如下面的当前请求路径为/read/blue时会将/blue发送给下游。

spring:
  cloud:
    gateway:
      routes:
        - id:setpath_route
        uri:https://example.org
        predicates:
          - Path=/red/{segment}
		filters:
		  - SetPath=/{segment}

SetRequestHeader

替换请求头参数，不是添加。

同名替换，不同名设值。

SetResponseHeader

替换响应头参数。

SetStatus

设置响应状态码。

StripPrefix

跳过路由uri中前几段后发送给下游。

Retry

设置重试次数。

RequestSize

请求最大大小。包含maxSize参数，可以有单位"KB"或者“MB”默认为“B”。

ModifyRequestBody

修改请求体内容。

ModifyResponseBody

修改响应体。