Spring-Cloud-Gateway介绍（中篇）

最新推荐文章于 2024-07-27 22:26:21 发布

椰果学Android

最新推荐文章于 2024-07-27 22:26:21 发布

阅读量1.4k

点赞数

分类专栏：程序员文章标签：面试 java 经验分享

本文链接：https://blog.csdn.net/CHAMPION8888/article/details/117884613

版权

程序员专栏收录该内容

1580 篇文章 4 订阅

订阅专栏

享学课堂特邀作者：老顾

转载请声明出处！

前言

前篇我们介绍了Gateway的由来，这一篇我们介绍一下Gateway的使用，希望能够帮到小伙伴们。

Gateway网关路由有两种配置方式：
1、在配置文件yml中配置
2、代码中注入RouteLocator的Bean
这两种方式是等价的，建议使用yml配置方式

项目依赖

我们采用最新的版本

因为Gateway使用的是Netty + webflux，所以不需要引入web模块；只要引入spring-cloud-starter-gateway就行了，里面包含了spring-boot-starter-webflux
注：什么是webflux，老顾以后介绍

配置

属性含义如下：

id：我们自定义的路由 ID，保持唯一
uri：目标服务地址
predicates：路由条件，Predicate 接受一个输入参数，返回一个布尔值结果。该属性包含多种默认方法来将 Predicate 组合成其他复杂的逻辑（比如：与，或，非）

请求效果

上面这段配置的意思是，配置了一个id为route-name的路由规则，当访问地址 http://localhost:8080/get 时会自动转发到地址：http://httpbin.org:80/get

代码实现

效果和配置方式是一样的。
上面我们简单的用两个案例演示了Gateway的路由转发，下面我们详细介绍一下路由规则。

路由规则

Spring Cloud Gateway 的功能很强大，前面我们只是使用了 predicates 进行了简单Path的条件匹配，其实Gataway帮我们内置了很多 Predicates功能。

在项目启动日志中，我们就能发现有很多PredicateFactory。Gateway 是通过Spring WebFlux的HandlerMapping做为底层支持来匹配到转发路由，这些 Predicates 工厂通过不同的HTTP请求参数来匹配，多个 Predicates 工厂可以组合使用。

Predicate 介绍

Predicate 来源于 Java 8，Predicate 接受一个输入参数，返回一个布尔值结果。该接口包含多种默认方法来将 Predicate 组合成其他复杂的逻辑（比如：与，或，非）。

在 Spring Cloud Gateway 中 Spring 利用 Predicate 的特性实现了各种路由匹配规则，有通过 Header、请求参数等不同的条件来进行作为条件匹配到对应的路由。
网上有一张图总结了 Spring Cloud 内置的几种 Predicate 的实现。

上图中，很清晰的说明了各个工厂的规则，说到底Predicate就是为了实现一组匹配规则，方便让请求过来找到对应的 Route 进行处理。

时间匹配

Gateway支持设置一个时间，在请求进行转发的时候，可以通过判断在这个时间之前或者之后进行转发。比如我们现在设置只有在2019年9月10日才会路由转发，在这之前不进行转发，我就可以这样配置：

上面的配置After属性，设置时间，代表在这时间之后才能匹配；我们设置的是2019-9-10，这里的时间通过ZonedDateTime来对时间进行的对比，ZonedDateTime 是 Java 8 中日期时间功能里，用于表示带时区的日期与时间信息的类，ZonedDateTime 支持通过时区来设置时间，中国的时区是：Asia/Shanghai。

上面的示例是指，请求路径为/get，且请求时间在 2019年9月10日0点0分0秒之后的所有请求都转发到地址http://httpbin.org:80。+08:00是指时间和UTC时间相差八个小时，时间地区为Asia/Shanghai。

添加完路由规则之后，如果当地时间为9月4日访问地址http://localhost:8080/get不会转发，如果是9月10日会自动转发到http://httpbin.org:80/get。
Before Route Predicate 刚好相反，在某个时间之前的请求都进行转发。
我们把上面路由规则中的 After 改为 Before，如下：

就表示在这个时间之前可以进行路由，在这时间之后停止路由。
有了时间前与时间后，当然就会有时间之间Between，如下：

意思一看就能看出，在两时间之间即可路由，不在不可路由。

Cookie 匹配

Cookie Route Predicate 可以接收两个参数，一个是 Cookie name ,一个是正则表达式，路由规则会通过获取对应的 Cookie name 值和正则表达式去匹配，如果匹配上就会执行路由，如果没有匹配上则不执行。

不带cookies访问

curl http://localhost:8080/get  //不带cookies

返回404

{"timestamp":"2019-09-04T09:28:45.726+0000","path":"/get","status":404,"error":"Not Found","message":null}

带上cookies访问，且userId为1

curl http://localhost:8080/get --cookie "userId=1"

返回正常

Header 匹配

Header Predicate 和 Cookie Predicate 一样，也是接收 2 个参数，一个 header 中属性名称和一个正则表达式，这个属性值和正则表达式匹配则执行。

上面的意思，就是请求头要有token属性，并且值为整数的正则表达式

curl http://localhost:8080/get  -H "token:12"

返回正常，将参数-H "token:12"改为-H "token:hello"再次执行时返回404证明没有匹配。

下面老顾就介绍快点，因为比较简单，一通百通

Host 匹配

Host Route Predicate 接收一组参数，一组匹配的域名列表，这个模板是一个 ant 分隔的模板，用.号作为分隔符。它通过参数中的主机地址作为匹配规则。

predicates:
   - Host=**.toutiao.com

请求匹配上的

curl http://localhost:8080/get  -H "Host: www.toutiao.com" 
curl http://localhost:8080/get  -H "Host: md.toutiao.com"

请求方式匹配

通过请求的方式是 POST、GET、PUT、DELETE 等进行路由。

predicates:
    - Method=GET          //或者POST，PUT

请求路径匹配

Path Route Predicate 接收一个匹配路径的参数来判断是否走路由。

predicates:
    - Path=/get/{segment}

如果请求路径符合要求，则此路由将匹配，例如：/get/1 或者 /get/bar。

请求参数匹配

Query Route Predicate 支持传入两个参数，一个是属性名，一个为属性值，属性值可以是正则表达式。

predicates:
   - Query=token

只有属性名token，表示只要有token参数就行，不管值为多少，即可路由

predicates:
    - Query=token, \d+

表示不但要有参数名token，值还要是整数才能路由

请求 ip 地址匹配

通过设置某个 ip 区间号段的请求才会路由，RemoteAddr Route Predicate 接受 cidr 符号(IPv4 或 IPv6 )字符串的列表(最小大小为1)，例如 192.168.0.1/16 (其中 192.168.0.1 是 IP 地址，16 是子网掩码)。

predicates:
   - RemoteAddr=192.168.1.1/24

如果请求的远程地址是 192.168.1.10，则此路由将匹配。

组合使用

predicates:
    - Host=**.toutiao.com
    - Path=/get
    - Method=GET
    - Query=token
    - After=2019-01-20T06:06:06+08:00[Asia/Shanghai]

各种 Predicates 同时存在于同一个路由时，请求必须同时满足所有的条件才被这个路由匹配

总结

老顾今天主要聊了Gateway的基础路由规则，当然我们也可以自定义predicates。下一篇我们就进入高级篇，主要介绍Gateway的filter、熔断以及限流等。

最后

由于文案过于长，在此就不一一介绍了，这份Java后端架构进阶笔记内容包括：Java集合，JVM、Java并发、微服务、SpringNetty与 RPC 、网络、日志、Zookeeper 、Kafka 、RabbitMQ 、Hbase 、MongoDB、Cassandra 、Java基础、负载均衡、数据库、一致性算法、Java算法、数据结构、分布式缓存等等知识详解。

本知识体系适合于所有Java程序员学习，关于以上目录中的知识点都有详细的讲解及介绍，掌握该知识点的所有内容对你会有一个质的提升，其中也总结了很多面试过程中遇到的题目以及有对应的视频解析总结。
有需要的朋友可以点击这里免费获取

提升，其中也总结了很多面试过程中遇到的题目以及有对应的视频解析总结。
有需要的朋友可以点击这里免费获取

[外链图片转存中…(img-YFYQPa3D-1623583654759)]

椰果学Android

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
1
评论
Spring-Cloud-Gateway介绍（中篇）

享学课堂特邀作者：老顾转载请声明出处！前言前篇我们介绍了Gateway的由来，这一篇我们介绍一下Gateway的使用，希望能够帮到小伙伴们。Gateway网关路由有两种配置方式：1、在配置文件yml中配置2、代码中注入RouteLocator的Bean这两种方式是等价的，建议使用yml配置方式项目依赖我们采用最新的版本因为Gateway使用的是Netty + webflux，所以不需要引入web模块；只要引入spring-cloud-starter-gateway就行了，里面包.
复制链接

扫一扫

专栏目录