一、概述
本文主要对 路由定义定位器 RouteDefinitionLocator 做整体的认识 。
在 《Spring-Cloud-Gateway 源码解析 —— 网关初始化》 中,我们看到路由相关的组件 RouteDefinitionLocator / RouteLocator 的初始化。涉及到的类比较多,我们用下图重新梳理下 :
RouteDefinitionLocator 负责读取路由配置( org.springframework.cloud.gateway.route.RouteDefinition ) 。从上图中我们可以看到,RouteDefinitionLocator 接口 有四种实现 :
另外, CachingRouteDefinitionLocator 也是 RouteDefinitionLocator 的实现类,已经被 CachingRouteLocator 取代。
RouteLocator 可以直接 自定义 路由( org.springframework.cloud.gateway.route.Route ) ,也可以通过 RouteDefinitionRouteLocator 获取 RouteDefinition ,并转换成 Route 。
重要 ,对于上层调用者 RoutePredicateHandlerMapping ,使用的是 RouteLocator 和 Route 。而 RouteDefinitionLocator 和 RouteDefinition 用于通过 配置定义路由 。 那么自定义 RouteLocator 呢 ?通过 代码定义路由 。
二、 RouteDefinition
org.springframework.cloud.gateway.route.RouteDefinition ,路由定义。代码如下 :
@Validated public class RouteDefinition { @NotEmpty private String id = UUID.randomUUID().toString(); /** * 谓语定义数组 */ @NotEmpty @Valid private List<PredicateDefinition> predicates = new ArrayList<>(); /** * 过滤器定义数组 */ @Valid private List<FilterDefinition> filters = new ArrayList<>(); /** * 路由向的 URI */ @NotNull private URI uri; /** * 顺序 */ private int order = 0; }
id 属性,ID 编号, 唯一 。
predicates 属性,谓语定义数组。 请求 通过 predicates 判断是否 匹配 。在 Route 里,PredicateDefinition 转换成 Predicate 。
filters 属性,过滤器定义数组。在 Route 里,FilterDefinition 转换成 GatewayFilter 。
uri 属性,路由向的 URI 。
order 属性,顺序。当请求匹配到多个路由时,使用顺序 小 的。
RouteDefinition 提供 text 字符串创建对象,代码如下 :
/** * 根据 text 创建 RouteDefinition * * @param text 格式 ${id}=${uri},${predicates[0]},${predicates[1]}...${predicates[n]} * 例如 route001= */ public RouteDefinition(String text) { int eqIdx = text.indexOf("="); if (eqIdx <= 0) { throw new ValidationException("Unable to parse RouteDefinition text '" + text + "'" + ", must be of the form name=value"); } // id setId(text.substring(0, eqIdx)); // predicates String[] args = tokenizeToStringArray(text.substring(eqIdx+1), ","); // uri setUri(URI.create(args[0])); for (int i=1; i < args.length; i++) { this.predicates.add(new PredicateDefinition(args[i])); } }
text 参数,格式为 ${id}=${uri},${predicates[0]},${predicates[1]}…${predicates[n]} 。举个例子, “route001=” 。创建的 RouteDefinition 如下图 :
filters 属性,需要通过调用 RouteDefinition#setFilters(filters) 方法进行设置。
order 属性,需要通过调用 RouteDefinition#setOrder(order) 方法进行设置。
predicates 属性,支持解析,但是如果此处 单个 PredicateDefinition 的 args[i] 存在 逗号 ( , ) ,会被错误的分隔,例如说,”Query=foo,bz” 。
三、 PredicateDefinition
org.springframework.cloud.gateway.handler.predicate.PredicateDefinition ,谓语定义。 请求 通过 predicates 判断是否 匹配 。代码如下 :
@Validated public class PredicateDefinition { /** * 谓语定义名字 */ @NotNull private String name; /** * 参数数组 */ private Map<String, String> args = new LinkedHashMap<>(); }
name 属性,谓语定义名字。通过 name 对应到 org.springframework.cloud.gateway.handler.predicate.RoutePredicateFactory 的 实现类 。例如说,name=Query 对应到 QueryRoutePredicateFactory 。
args 属性,参数数组。例如,name=Host / args={“_genkey_0” : “iocoder.cn”} ,匹配请求的 hostname 为 iocoder.cn 。
PredicateDefinition 提供 text 字符串创建对象,代码如下 :
/** * 根据 text 创建 PredicateDefinition * * @param text 格式 ${name}=${args[0]},${args[1]}...${args[n]} * 例如 Host=iocoder.cn */ public PredicateDefinition(String text) { int eqIdx = text.indexOf("="); if (eqIdx <= 0) { throw new ValidationException("Unable to parse PredicateDefinition text '" + text + "'" + ", must be of the form name=value"); } // name setName(text.substring(0, eqIdx)); // args String[] args = tokenizeToStringArray(text.substring(eqIdx+1), ","); for (int i=0; i < args.length; i++) { this.args.put(NameUtils.generateName(i), args[i]); } }
text 参数,格式为 ${name}=${args[0]},${args[1]}…${args[n]} 。举个例子, “Host=iocoder.cn” 。创建的 PredicateDefinition 如下图 :
四、 FilterDefinition
FilterDefinition 和 PredicateDefinition 的代码实现上 基本一致 。
org.springframework.cloud.gateway.filter.FilterDefinition ,过滤器定义。代码如下 :
@Validated public class FilterDefinition { /** * 过滤器定义名字 */ @NotNull private String name; /** * 参数数组 */ private Map<String, String> args = new LinkedHashMap<>(); }
name 属性,过滤器定义名字。通过 name 对应到 org.springframework.cloud.gateway.filter.factory.GatewayFilterFactory 的 实现类 。例如说,name=AddRequestParameter 对应到 AddRequestParameterGatewayFilterFactory 。
args 属性,参数数组。例如,name=AddRequestParameter / args={“_genkey_0”: “foo”, “_genkey_1”: “bar”} ,添加请求参数 foo 为 bar 。
FilterDefinition 提供 text 字符串创建对象,代码如下 :
/** * 根据 text 创建 FilterDefinition * * @param text 格式 ${name}=${args[0]},${args[1]}...${args[n]} * 例如 AddRequestParameter=foo, bar */ public FilterDefinition(String text) { int eqIdx = text.indexOf("="); if (eqIdx <= 0) { setName(text); return; } // name setName(text.substring(0, eqIdx)); // args String[] args = tokenizeToStringArray(text.substring(eqIdx+1), ","); for (int i=0; i < args.length; i++) { this.args.put(NameUtils.generateName(i), args[i]); } }
text 参数,格式为 ${name}=${args[0]},${args[1]}…${args[n]} 。举个例子, “AddRequestParameter=foo, bar” 。创建的 FilterDefinition 如下图 :
五、RouteDefinitionLocator
org.springframework.cloud.gateway.route.RouteDefinitionLocator ,路由定义定位器 接口 ,定义获得路由定义数组的方法。代码如下 :
public interface RouteDefinitionLocator { Flux<RouteDefinition> getRouteDefinitions(); }
对 Reactor Flux 暂时不熟悉的同学,可以阅读完本文 Google 进行学习。随着 Spring 5 对响应式编程的推广,厉害如你一定要去掌握。
在上文中,我们也看到了 RouteDefinitionLocator 的多个实现类,类图如下 :
本文只解析 CompositeRouteDefinitionLocator 的源码实现。其他的实现类会在后面文章详细解析。
六、 CompositeRouteDefinitionLocator
org.springframework.cloud.gateway.route.CompositeRouteDefinitionLocator ,组合 多种 RouteDefinitionLocator 的实现,为 RouteDefinitionRouteLocator 提供 统一 入口。代码如下 :
public class CompositeRouteDefinitionLocator implements RouteDefinitionLocator { /** * RouteDefinitionLocator 数组 */ private final Flux<RouteDefinitionLocator> delegates; public CompositeRouteDefinitionLocator(Flux<RouteDefinitionLocator> delegates) { this.delegates = delegates; } @Override public Flux<RouteDefinition> getRouteDefinitions() { return this.delegates.flatMap(RouteDefinitionLocator::getRouteDefinitions); } }
#getRouteDefinitions() 方法,提供 统一 方法,将组合的 delegates 的路由定义 全部 返回。
Having read this I believed it was rather enlightening.
I appreciate you taking the time and energy to put this content together.
I once again find myself spending a lot of time both reading and commenting.
But so what, it was still worth it!