我要评论
基本概念
路由(route)是gateway中最基本的组件之一，表示一个具体的路由信息载体。主要定义了下面的几个信息：
- id：路由标识符，区别于其他route。
- uri：路由指向的目的地uri，即客户端请求最终被转发到的微服务。
- order：用于多个route之间的排序，数值越小排序越靠前，匹配优先级越高。
- predicate：断言的作用是进行条件判断，只有断言都返回真，才会真正的执行路由。
- filter：过滤器用于修改请求和响应信息。
执行流程
执行流程大体如下:
gateway client向gateway server发送请求；- 请求首先会被
httpwebhandleradapter进行提取组装成网关上下文； - 然后网关的上下文会传递到
dispatcherhandler，它负责将请求分发给routepredicatehandlermapping routepredicatehandlermapping负责路由查找，并根据路由断言判断路由是否可用；- 如果断言成功，由
filteringwebhandler创建过滤器链并调用； - 请求会依次经过
prefilter->微服务->postfiter的方法，最终返回响应；
断言
predicate(断言，谓词)用于进行条件判断，只有断言都返回真，才会真正的执行路由。断言就是说: 在什么条件下才能进行路由转发。
内置路由断言工厂
spring cloud gateway 包括许多内置的断言工厂，所有这些断言都与http请求的不同属性匹配。具体如下：
（1）基于datetime类型的断言工厂，此类型的断言根据时间做判断，主要有三个：
- afterroutepredicatefactory：接收一个日期参数，判断请求日期是否晚于指定日期；
- beforeroutepredicatefactory：接收一个日期参数，判断请求日期是否早于指定日期；
- betweenroutepredicatefactory：接收两个日期参数，判断请求日期是否在指定时间段内；
（2）基于远程地址的断言工厂 remoteaddrroutepredicatefactory：接收一个ip地址段，判断请求主机地址是否在地址段中
（3）基于cookie的断言工厂 cookieroutepredicatefactory ，接收两个参数：cookie名字和一个正则表达式。判断请求cookie是否具有给定名称且值与正则表达式匹配。
（4）基于header的断言工厂 headerroutepredicatefactory，接收两个参数：标题名称和正则表达式。判断请求header是否具有给定名称且值与正则表达式匹配。
（5）基于host的断言工厂 hostroutepredicatefactory，接收一个参数：主机名模式。判断请求的host是否满足匹配规则。
（6）基于method请求方法的断言工厂 methodroutepredicatefactory，接收一个参数：判断请求类型是否跟指定的类型匹配。
（7）基于path请求路径的断言工厂 pathroutepredicatefactory，接收一个参数：判断请求的uri部分是否满足路径规则。
（8）基于query请求参数的断言工厂 queryroutepredicatefactory，接收两个参数：请求param和正则表达式，判断请求参数是否具有给定名称且值与正则表达式匹配。
（9）基于路由权重的断言工厂 weightroutepredicatefactory，接收一个[组名,权重]，然后对于同一个组内的路由按照权重转发
- id: weight_route1
uri: host1
predicates:
- path=/product/**
- weight=group3, 1
- id: weight_route2
uri: host2
predicates:
- path=/product/**
- weight=group3, 9
接下来我们验证几个内置断言的使用：
server:
port: 7000
spring:
application:
name: api-gateway
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
gateway:
discovery:
locator:
enabled: true # 让gateway可以发现nacos中的微服务
lowercaseserviceid: true # 将请求路径上的服务名配置为小写
routes:
- id: shop-product #当前路由标识，要求唯一
uri: lb://shop-product #lb代表从nacos中获取微服务，shop-product是微服务的名称
order: 1 #路由的优先级，数字越小级别越高
predicates: #断言(就是路由转发要满足的条件)
- path=/product/** #当请求路径满足path指定的规则时,才进行路由转发
- before=2019-08-30t15:46:00.000+08:00 #限制请求时间在2019-11-28之前
- method=post #限制请求方式为post
filters: #过滤器，请求在传递过程中可以通过过滤器对其进行一定的修改
- stripprefix=1 #去掉请求路径的第一层
自定义路由断言工厂
我们来设定一个场景：假设我们的应用仅仅让age在(min,max)之间的人来访问。
1、在配置文件中，添加一个age的断言配置
spring:
application:
name: api-gateway
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
gateway:
discovery:
locator:
enabled: true # 让gateway可以发现nacos中的微服务
lowercaseserviceid: true # 将请求路径上的服务名配置为小写
routes:
- id: shop-product #当前路由标识，要求唯一
uri: lb://shop-product #lb代表从nacos中获取微服务，shop-product是微服务的名称
order: 1 #路由的优先级，数字越小级别越高
predicates: #断言(就是路由转发要满足的条件)
- path=/product/** #当请求路径满足path指定的规则时,才进行路由转发
- age=18,60 #限制年龄只有在18到60岁之间的人能访问
filters: #过滤器，请求在传递过程中可以通过过滤器对其进行一定的修改
- stripprefix=1 #去掉请求路径的第一层
2、自定义一个断言工厂，实现断言方法
@component
//泛型用于接收一个配置类，配置类用于接收配置文件中的配置。
public class ageroutepredicatefactory extends abstractroutepredicatefactory<ageroutepredicatefactory.config> {
public ageroutepredicatefactory() {
super(ageroutepredicatefactory.config.class);
}
/**
* 用于从配置文件中获取参数值赋值到配置类中的属性上
**/
@override
public list<string> shortcutfieldorder() {
//这里的顺序要跟配置文件中的参数顺序一致
return arrays.aslist("minage","maxage");
}
/**
* 断言
**/
@override
public predicate<serverwebexchange> apply(ageroutepredicatefactory.config config) {
return new predicate<serverwebexchange>() {
@override
public boolean test(serverwebexchange serverwebexchange) {
//从 serverwebexchange 获取传入的参数
string agestr = serverwebexchange.getrequest().getqueryparams().getfirst("age");
if(stringutils.isnotempty(agestr)) {
int age = integer.parseint(agestr);
return age > config.getminage() && age < config.getmaxage();
}
return true;
}
} ;
}
/**
* 自定义一个配置类，用于接收配置文件中的参数
**/
@data
public static class config {
private int minage;
private int maxage;
}
}
3、启动测试
测试发现当age在(18，60)之间可以访问，其它范围不能访问。
总结
到这儿，gateway 服务网关核心架构的执行流程和断言就已经介绍完了。下一篇将为大家带来gateway 服务网关核心架构的过滤器相关的文章，敬请期待吧！
后续的文章，我们将继续完善我们的微服务系统，集成更多的alibaba组件。想要了解更多java后端知识，请点击文末名片与我交流吧。留下您的一键三连，让我们在这个寒冷的东西互相温暖吧！
发表评论