gataway断言源码剖析

gataway断言源码剖析

Gateway断言源码剖析

Spring Cloud Gateway的断言（Predicate）机制是其路由功能的核心组成部分，用于根据请求特征（如路径、Header、Cookie等）决定请求是否匹配特定路由。以下从源码层面剖析断言的实现机制，并结合Cookie断言和自定义Token断言案例进行说明。

核心类：CookieRoutePredicateFactory功能：检查请求中是否包含指定名称的Cookie，且值匹配正则表达式。

shortcutFieldOrder()定义配置参数的顺序，确保name和regexp按顺序绑定到Config对象。

apply(Config config)核心断言逻辑：从请求中获取Cookie并匹配正则。

流程：

通过ServerWebExchange获取请求的Cookies。

检查是否存在指定名称的Cookie。

遍历Cookie值，用正则表达式匹配。

需求：检查请求是否包含指定Header（如Authorization）。

命名规则：类名必须为[Name]RoutePredicateFactory（如TokenRoutePredicateFactory），断言名称为Token。

参数绑定：通过shortcutFieldOrder()指定YAML参数映射到Config.headerName。

断言逻辑：检查请求Header是否存在且非空。

抽象基类：AbstractRoutePredicateFactory

提供统一的配置解析和断言创建流程。

子类需实现apply()定义具体匹配逻辑。

配置绑定

通过Config内部类接收YAML参数。

shortcutFieldOrder()定义参数顺序或名称映射。

执行流程

自定义扩展

继承AbstractRoutePredicateFactory。

实现apply()和配置绑定逻辑。

添加@Component注解注册到Spring容器。

断言不生效

检查类名是否符合[Name]RoutePredicateFactory格式。

确认YAML配置参数与shortcutFieldOrder()一致。

日志调试在apply()方法中添加日志，观察断言输入参数：

性能优化

避免在断言中执行耗时操作（如数据库查询）。

使用exchange.getRequest().getHeaders()等缓存对象。

函数式接口断言返回Predicate<ServerWebExchange>，支持Lambda表达式，简化逻辑编写。

配置解耦通过Config类分离断言逻辑与配置参数，提升可维护性。

扩展性统一的抽象基类降低自定义断言的学习成本。

通过深入理解断言源码，可以更灵活地实现复杂路由规则，满足个性化需求。