一、断言(Predicate)的意义
断言是路由配置的一部分,当断言条件满足,即执行Filter的逻辑,如下例所示
spring:
cloud:
gateway:
routes:
- id: add_request_header_route
uri: https://example.org
predicates:
- Path=/red/{segment}
filters:
- AddRequestHeader=X-Request-Red, Blue-{segment}
当请求路径满足条件/red/,即添加头信息:X-Request-Red,value为Blue-{segment},segment是路径里面带的信息。
gateWay的主要功能之一是转发请求,转发规则的定义主要包含三个部分
Route(路由) | 路由是网关的基本单元,由ID、URI、一组Predicate、一组Filter组成,根据Predicate进行匹配转发。 |
Predicate(谓语、断言) | 路由转发的判断条件,目前SpringCloud Gateway支持多种方式,常见如:Path、Query、Method、Header等,写法必须遵循 key=vlue的形式 |
Filter(过滤器) | 过滤器是路由转发请求时所经过的过滤逻辑,可用于修改请求、响应内容 |
其中Route和Predicate必须同时申明
以下内容,来自于SpringCloud Gateway官网,经过整理得来。
二、配置路由断言
注意:以下的配置,只写了routes配置的predicates的部分,实际上,predicates单独用没有意义,一般要配置filter来用。如上面的添加头信息的示例。
1.1 简写配置
由过滤器名称,后跟等号,后跟逗号分割的参数值
spring:
cloud:
gateway:
routes:
- id: after_route
uri: https://example.org
predicates:
- Cookie=mycookie,mycookievalue
1.2 展开的写法
spring:
cloud:
gateway:
routes:
- id: test_cookie
uri: https://example.org
predicates:
- name: Cookie
args:
name: mycookie
regexp: mycookievalue
以上两个写法,效果是一样的。
问题1:展开的predicates的展开写法为什么是这么写?
原因是,这个配置对应的配置类是这么写的
问题2:name:Cookie是怎么来的?
根据类名来的,CookieRoutePredicateFactory,取的Cookie前缀,还有很多断言工厂,如下:
问题3:为啥args下面是name和regexp?
三、路由断言工厂示例
Spring Cloud Gateway 路由匹配作为Spring WebFlux HandlerMapping 基础设施的一部分。Spring Cloud Gateway内置了很多路由断言工厂。用于匹配HTTP请求的不同属性。
注意:以下的配置,只写了routes配置的predicates的部分,实际上,predicates单独用没有意义,一般要配置filter来用。如上面的添加头信息的示例。
2.1 The After Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: after_route
uri: https://example.org
predicates:
- After=2017-01-20T17:42:47.789-07:00[America/Denver]
匹配2017-01-20T17:42:47.789-07:00之后的请求
2.2 The Before Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: before_route
uri: https://example.org
predicates:
- Before=2017-01-20T17:42:47.789-07:00[America/Denver]
匹配2017-01-20T17:42:47.789-07:00之前的请求
2.3 The Between Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: between_route
uri: https://example.org
predicates:
- Between=2017-01-20T17:42:47.789-07:00[America/Denver], 2017-01-21T17:42:47.789-07:00[America/Denver]
表示在第一个时间之后,第二个时间之前的请求才能正确匹配路由
2.4 The Cookie Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: cookie_route
uri: https://example.org
predicates:
- Cookie=chocolate, ch.p
接收两个参数,分别为name 和 regexp(Java正则表达式),表示cookie中携带的name值满足正则表达式regexp,则被路由
2.5 The Header Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: header_route
uri: https://example.org
predicates:
- Header=X-Request-Id, \d+
接收两个参数,header 和 regexp(Java正则表达式),表示header中携带的name值满足正则表达式regexp,则被路由
2.6 The Host Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: host_route
uri: https://example.org
predicates:
- Host=**.somehost.org,**.anotherhost.org
支持URI模板变量(如{sub}.myhost.org)。当Host 头的值为 www.somehost.org 或 beta.somehost.org 或 www.anotherhost.org 都能匹配该路由。
Predicate 会提取URI模板变量作为map集合,并放置在 ServerWebExchange.getAttributes() 中,key定义为 ServerWebExchangeUtils.URI_TEMPLATE_VARIABLES_ATTRIBUTE ,这些值能在 GatewayFilter工厂中使用。
2.7 The Method Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: method_route
uri: https://example.org
predicates:
- Method=GET,POST
上面示例表示匹配 GET ,POST请求
2.8 The Path Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: path_route
uri: https://example.org
predicates:
- Path=/red/{segment},/blue/{segment}
如果请求地址是 /red/1 或 /red/1/ 或 /red/blue 或 /blue/green ,那么路由将会被匹配。
如果 matchTrailingSlash 设置为 false ,那么 /red/1/ 不会被匹配。
Predicate 会提取URI模板变量作为map集合,并放置在 ServerWebExchange.getAttributes() 中,key定义
为 ServerWebExchangeUtils.URI_TEMPLATE_VARIABLES_ATTRIBUTE ,这些值能在 GatewayFilter 工厂中使用。
可以使用个实用法(调用get)来简化对这些变量的访问。下面的例示展示了如何使用get方法:
Map<String, String> uriVariables = ServerWebExchangeUtils.getPathPredicateVariables(exchange);
String segment = uriVariables.get("segment");
2.9 The Query Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: query_route
uri: https://example.org
predicates:
- Query=green
接收两个参数,分别是一个必须的param和一个可选的regexp。
spring:
cloud:
gateway:
routes:
- id: query_route
uri: https://example.org
predicates:
- Query=red, gree.
red和gree两个参数都有才满足
2.10 The RemoteAddr Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: remoteaddr_route
uri: https://example.org
predicates:
- RemoteAddr=192.168.1.1/24.
接收⼀个sources列表(最小1个),CIDR表示法(IPv4或IPv6)字符串,例如192.168.0.1/16(其中192.168.0.1是
⼀个IP地址,16是⼀个⼦网掩码)。
如果请求的远程地址是 192.168.1.10 ,则此路由被匹配
2.11 The Weight Route Predicate Factory
spring:
cloud:
gateway:
routes:
- id: weight_high
uri: https://weighthigh.org
predicates:
- Weight=group1, 8
- id: weight_low
uri: https://weightlow.org
predicates:
- Weight=group1, 2
将有80%的流量被路由到 weighthigh.org ,20%的流量被路由到 weightlow.org 。