锋哥原创的微服务网关Gateway视频教程:
Spring Cloud Gateway将路由作为Spring WebFluxHandlerMapping
基础架构的一部分进行匹配。Spring Cloud Gateway包括许多内置的路由断言工厂。所有这些断言都与HTTP请求的不同属性匹配。您可以将多个路由断言工厂与逻辑and
语句结合使用。
路由断言工厂RoutePredicateFactory包含的主要实现类如图所示,包含Datetime、Cookie、Header、Host、Method、Path、Query、RemoteAddr、Weight等类型的路由断言。
匹配指定日期时间之后的请求 After
- spring:
- application:
- name: gateway-server
- cloud:
- gateway:
- routes:
- - id: after_route
- uri: http://localhost:8080/
- predicates:
- - After=2021-04-20T06:06:06+08:00[Asia/Shanghai]
匹配指定日期时间之前的请求 Before
- spring:
- application:
- name: gateway-server
- cloud:
- gateway:
- routes:
- - id: before_route
- uri: http://localhost:8080/
- predicates:
- - Before=2021-04-20T06:06:06+08:00[Asia/Shanghai]
匹配指定日期时间之间的请求 Between
- spring:
- application:
- name: gateway-server
- cloud:
- gateway:
- routes:
- - id: betwwen_route
- uri: http://localhost:8080/
- predicates:
- - Between=2021-01-20T06:06:06+08:00[Asia/Shanghai],2021-04-20T06:06:06+08:00[Asia/Shanghai]
所述Cookie路由断言工厂采用两个参数,该cookiename和regexp(其是Java正则表达式)。该断言匹配具有给定名称且其值与正则表达式匹配的cookie。以下示例配置cookie路由断言工厂:
- spring:
- application:
- name: gateway-server
- cloud:
- gateway:
- routes:
- - id: cookie_route
- uri: http://localhost:8080/
- predicates:
- - Cookie=token, \d+
所述Header
;路由断言工厂采用两个参数,报头name
和一个regexp
(其是Java正则表达式)。该断言与具有给定名称的头信息匹配,该标头的值与正则表达式匹配。以下示例配置Header路由断言:
- spring:
- application:
- name: gateway-server
- cloud:
- gateway:
- routes:
- - id: header_route
- uri: http://localhost:8080/
- predicates:
- - Header=X-Request-Id, \d+
该`Host`路由断言工厂需要一个参数:主机名的列表`patterns`。该模式是带有.分隔符的Ant样式的模式。断言与`Host`匹配模式的标头匹配。以下示例配置主机路由断言:
- spring:
- application:
- name: gateway-server
- cloud:
- gateway:
- routes:
- - id: host_route
- uri: http://localhost:8080/
- predicates:
- - Host=**.somehost.org,**.anotherhost.org
所述Method
路由断言厂需要methods
的参数,它是一个或多个参数:HTTP方法来匹配。以下示例配置方法路由断言:
- spring:
- application:
- name: gateway-server
- cloud:
- gateway:
- routes:
- - id: method_route
- uri: http://localhost:8080/
- predicates:
- - Method=GET,POST
该Path
路由断言厂有两个参数:春天的列表PathMatcher
patterns
和一个可选的标志叫matchOptionalTrailingSeparator
。以下示例配置路径路由断言:
- spring:
- application:
- name: gateway-server
- cloud:
- gateway:
- routes:
- - id: path_route
- uri: http://localhost:8080/
- predicates:
- - Path=/product/{segment}
所述Query
路由断言工厂采用两个参数:所要求的param
和可选的regexp
(其是Java正则表达式)。以下示例配置查询路由断言:
- spring:
- application:
- name: gateway-server
- cloud:
- gateway:
- routes:
- - id: query_route
- uri: http://localhost:8080/
- predicates:
- - Query=green
如果请求包含green
查询参数,则前面的路由匹配。
所述RemoteAddr
路由断言工厂需要的列表(分钟尺寸1) sources
,其是CIDR的表示法(IPv4或IPv6)的字符串,如192.168.0.1/16
(其中192.168.0.1
是一个IP地址和16
一个子网掩码)。下面的示例配置RemoteAddr路由断言:
- spring:
- cloud:
- gateway:
- routes:
- - id: remoteaddr_route
- uri: https://example.org
- predicates:
- - RemoteAddr=192.168.1.1/24
如果请求的远程地址为上面配置,则此路由匹配192.168.1.10。
该Weight
路由断言工厂有两个参数:group
和weight
(一个int)。权重是按组计算的。以下示例配置权重路由断言:
- 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。