一 . 前言
文档目的
- 梳理 Gateway 生产中转发请求的细节
- 梳理 转发的定制点
知识补充
请求转发是 Gateway 最核心的功能之一 , 他涉及到三个主要的概念 :
Route(路由): 路由是网关的基本单元,由ID、URI、一组Predicate、一组Filter组成,如果 Predicate 匹配 True ,则进行转发
Predicate(谓语、断言): 路由转发的判断条件,这是一个 Java 8函数断言, 输入类型是 Spring Framework ServerWebExchange , 目前SpringCloud Gateway支持多种方式,常见如:Path、Query、Method、Header等,写法必须遵循 key=vlue的形式
Filter(过滤器): 过滤器是路由转发请求时所经过的过滤逻辑,使用特定工厂构建的 GatewayFilter 实例 , 可用于修改请求、响应内容
二 . 简单使用
2.1 predicates 汇总
//
- After=2017-01-20T17:42:47.789-07:00[America/Denver]
//
- Before=2017-01-20T17:42:47.789-07:00[America/Denver]
//
- Between=2017-01-20T17:42:47.789-07:00[America/Denver], 2017-01-21T17:42:47.789-07:00[America/Denver]
//
- Cookie=chocolate, ch.p
复制代码
2.2 Mono 和 Flux
Mono 和 Flux 是贯穿了整个流程的核心对象 ,根据 reactive-streams 规范,发布服务器提供了数量可能无限的有序元素,并根据从其订阅服务器接收到的需求发布这些元素。Reactor-core 有一组此 Publisher 接口的实现。我们将要创建序列的两个重要实现是 Mono 和 Flux。
- Flux 表示的是包含 0 到 N 个元素的异步序列
- Mono 表示的是包含 0 或 1 个元素的异步序列
> SpringGateway 是使用 webflux 作为底层调用框架的 , 其中涉及到 mono 和 Flux 对象
> 该序列中可以包含 3 种通知 :
- 正常的包含元素的消息
- 序列结束的消息
- 序列出错的消息
Flux
- Flux是一个标准Publisher,表示0到N个发射项的异步序列,选择性的以完成或错误信号终止。与Reactive Streams规范中一样,这三种类型的信号转换为对下游订阅者的onNext、onComplete或onError方法的调用。
Mono
- Mono 是 Publisher 的另一个实现。它最多发出一个条目,然后(可选)以 onComplete 信号或 onError 信号终止 , Mono 在本质上也是异步的
- 它只提供了可用于Flux的操作符的子集,并且一些操作符(特别是那些将Mono与另一个发布者组合的操作符)切换到Flux。
- 例如,Mono#concatWith(Publisher)返回一个Flux ,而Mono#then(Mono)则返回另一个Mono。
常见的方法如下 :
- create : 以编程方式创建具有多次发射能力的Flux,
- empty : 发出0元素或返回空 Flux < t >
- just : 创建一个基础
- error : 创建一个Flux,它在订阅之后立即以指定的错误终止
PS : 这一块就不深入看了 , 先看完 Gateway 的主流程
三 . 拦截深入
3.1 原理图
首先来看一下 SpringGateway 的原理图
四 . 调用的入口
4.1 调用流程
- Step 1 : HttpWebHandlerAdapter # handle : 构建 ServerWebExchange , 发起 Handler 处理
- Step 2 : DispatcherHandler # handle : 发起请求处理
- Step 3 : RoutePredicateHandlerMapping #