Gateway(三)Spring Cloud Gateway内置各类型Predicate(断言)使用说明
目录
《SpringCloudAlibaba+Nacos整合Gateway网关》
《SpringCloudGateway结合Sentienl实现网关限流机制》
《Spring Cloud Gateway过滤器(GatewayFilter)工厂》
Spring Cloud Gateway 包含许多内置的路由断言工厂。所有这些断言都匹配 HTTP 请求的不同属性。您可以将多个路由断言工厂与逻辑and语句结合起来。
1、Path Route Predicate
Path是最常见的断言请求,匹配指定路径下的请求,可以是具体的请求,也可使用/**
表示匹配所有子级请求,配置如下。
spring: cloud:gateway: routes: - id: after_routeuri: https://example.orgpredicates:- Path=/user/**- Path=/wage/list
配置中匹配了以/user
开头或者URL为/wage/list
的请求,如果是其他URL的请求进入系统,会出现错误。
2、DateTimePredicate(匹配请求时间)
2.1 After Route Predicate(匹配时间后的请求)
After Route Predicate
可以匹配ZonedDateTime
类型的时间,表示:匹配在指定日期时间之后发生的请求,配置如下:
spring: cloud:gateway: routes: - id: after_routeuri: https://example.orgpredicates:- Path=/user/**- After=2022-02-26T13:00:00+08:00[Asia/Shanghai]
配置中匹配了2022-02-26 13:00:00
后的请求,如果是在指定时间之前进入系统的请求,会出现错误。
2.2 Before Route Predicate(匹配时间前的请求)
Before Route Predicate
可以匹配ZonedDateTime
类型的时间,表示:匹配在指定日期时间之前发生的请求,配置如下:
spring: cloud:gateway: routes: - id: after_routeuri: https://example.orgpredicates:- Path=/user/**- Before=2022-02-26T13:00:00+08:00[Asia/Shanghai]
配置中匹配了2022-02-26 13:00:00
之前的请求,如果是在指定时间之后进入系统的请求,会出现错误。
2.3 Between Route Predicate(匹配时间之间的请求)
Between Route Predicate
可以匹配ZonedDateTime
类型的时间,由两个ZonedDateTime
参数组成,第一个参数为开始时间
,第二参数为结束时间
,表示:匹配在指定的开始时间
与结束时间
之内发生的请求,配置如下:
spring: cloud:gateway: routes: - id: after_routeuri: https://example.orgpredicates:- Path=/user/**- Between=2022-02-26T13:00:00+08:00[Asia/Shanghai],2022-02-27T13:00:00+08:00[Asia/Shanghai]
配置中匹配了2022-02-26 13:00:00
到2022-02-27 13:00:00
之内时间段的请求,如果是在指定时间段外的进入系统的请求,会出现错误。
3、Cookie Route Predicate
CookieRoutePredicate
由两个参数组成,第一个参数为cookie的Key
,第二参数为cookie的Value
,表示:匹配指定名称且其值与正则表达式匹配的cookie的请求,配置如下:
spring: cloud:gateway: routes: - id: cookie_routeuri: https://example.orgpredicates:- Path=/user/**- Cookie=cokieName, \d+
配置中匹配了cookie的Key为cookieName
,值为满足\d+
的正则表达式请求,如果满足cookieName
不满足\d+
的请求,会出现错误。
4、Header Route Predicate
HeaderRoutePredicate
由两个参数组成,第一个参数为Header名称
,第二参数为Header的Value值
,表示:匹配指定名称且其值与正则表达式匹配的Header
的请求,配置如下:
spring: cloud:gateway: routes: - id: cookie_routeuri: https://example.orgpredicates:- Path=/user/**- Header=headerName, \d+
配置中匹配了Header的名称为headerName
,值为满足\d+
的正则表达式请求,如果满足headerName
不满足\d+
的请求,会出现错误。
5、Host Route Predicate
HostRoutePredicate
参数为请求的Host地址,多个参数使用逗号分割,设置的Host
地址可以使用**
表示通配符,配置如下:
spring: cloud:gateway: routes: - id: cookie_routeuri: https://example.orgpredicates:- Path=/user/**- Host=**.somehost.org,**.anotherhost.org
配置中匹配的Host
,可以匹配以somehost.org
或者anotherhost.org
结尾的Host地址
,其他Host地址
访问会出现错误。
6、Method Route Predicate
MethodRoutePredicate
由一个或多个HTTP Method
组成,比如:POST、PUT、GET、DELETE
,配置如下:
spring: cloud:gateway: routes: - id: cookie_routeuri: https://example.orgpredicates:- Path=/user/**- Method=GET,POST
配置中匹配了HTTP Method
的类型为GET和POST
,如果是其他类型的HTTP Method
,会出现错误。
7、Query Route Predicate
QueryRoutePredicate
由两个参数组成,第一个参数为参数名称
,第二参数为参数的值(满足正则即可)
,表示:匹配指定名称且其值与正则表达式匹配的带参
的请求,配置如下:
spring: cloud:gateway: routes: - id: cookie_routeuri: https://example.orgpredicates:- Path=/user/**- Query=name,\d+
配置中匹配了参数名称叫做name
,值满足\d+
的请求,如果不满足\d+
,会出现错误。
8、RemoteAddr Route Predicate
RemoteAddrRoutePredicate
的参数由CIDR 表示法(IPv4 或 IPv6)字符串组成,配置如下:
spring: cloud:gateway: routes: - id: cookie_routeuri: https://example.orgpredicates:- Path=/user/** - RemoteAddr=192.168.1.1/24
配置中可以匹配IP为192.168.1.100
的值,如果不满足192.168.1.1/24
的IP规则,会出现错误。
9、Weight Route Predicate
WeightAddrRoutePredicate
由group
和weight(权重数值)
组成,表示将相同的请求根据权重跳转到不同的uri地址,要求group
的名称必须一致,配置如下:
spring: cloud:gateway: routes: - id: weight_highuri: https://weighthigh.orgpredicates:- Weight=groupName, 8 - id: weight_lowuri: https://weightlow.orgpredicates:- Weight=groupName, 2
该路由会将约 80% 的流量转发到weighthigh.org,将约 20% 的流量转发到weightlow.org
作者:一恍过去
来源链接:https://blog.csdn.net/zhuocailing3390/article/details/123151458
版权声明:
1、JavaClub(https://www.javaclub.cn)以学习交流为目的,由作者投稿、网友推荐和小编整理收藏优秀的IT技术及相关内容,包括但不限于文字、图片、音频、视频、软件、程序等,其均来自互联网,本站不享有版权,版权归原作者所有。
2、本站提供的内容仅用于个人学习、研究或欣赏,以及其他非商业性或非盈利性用途,但同时应遵守著作权法及其他相关法律的规定,不得侵犯相关权利人及本网站的合法权利。
3、本网站内容原作者如不愿意在本网站刊登内容,请及时通知本站(javaclubcn@163.com),我们将第一时间核实后及时予以删除。