千家信息网

SpringCloud-Gateway的常用路由断言工厂有哪些

发表于:2025-11-07 作者:千家信息网编辑
千家信息网最后更新 2025年11月07日,这篇文章主要介绍"SpringCloud-Gateway的常用路由断言工厂有哪些",在日常操作中,相信很多人在SpringCloud-Gateway的常用路由断言工厂有哪些问题上存在疑惑,小编查阅了各
千家信息网最后更新 2025年11月07日SpringCloud-Gateway的常用路由断言工厂有哪些

这篇文章主要介绍"SpringCloud-Gateway的常用路由断言工厂有哪些",在日常操作中,相信很多人在SpringCloud-Gateway的常用路由断言工厂有哪些问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作方法,希望对大家解答"SpringCloud-Gateway的常用路由断言工厂有哪些"的疑惑有所帮助!接下来,请跟着小编一起来学习吧!

1)Path 路由断言工厂

Path 路由断言工厂接收一个参数,根据 Path 定义好的规则来判断访问的 URI 是否匹配。

spring:  cloud:    gateway:      routes:        - id: host_route    uri: http://minglisoft.cn    predicates:      - Path=/blog/detail/{segment}

如果请求路径为 /blog/detail/xxx,则此路由将匹配。也可以使用正则,例如 /blog/detail/** 来匹配 /blog/detail/ 开头的多级 URI。

我们访问本地的网关:http://localhost:2001/blog/detail/36185 ,可以看到显示的是 http://minglisoft.cn/blog/detail/36185 对应的内容。

2)Query 路由断言工厂

Query 路由断言工厂接收两个参数,一个必需的参数和一个可选的正则表达式。

spring:  cloud:    gateway:      routes:        - id: query_route      uri: http://minglisoft.cn      predicates:        - Query=foo, ba.

如果请求包含一个值与 ba 匹配的 foo 查询参数,则此路由将匹配。bar 和 baz 也会匹配,因为第二个参数是正则表达式。

测试链接:http://localhost:2001/?foo=baz。

3)Method 路由断言工厂

Method 路由断言工厂接收一个参数,即要匹配的 HTTP 方法。

spring:  cloud:    gateway:      routes:        - id: method_route  uri: http://baidu.com  predicates:    - Method=GET
4)Header 路由断言工厂

Header 路由断言工厂接收两个参数,分别是请求头名称和正则表达式。

spring:  cloud:    gateway:      routes:        - id: header_route  uri: http://example.org  predicates:    - Header=X-Request-Id, \d+

如果请求中带有请求头名为 x-request-id,其值与 \d+ 正则表达式匹配(值为一个或多个数字),则此路由匹配。

如果你想学习更多路由断言工厂的用法,可以参考官方文档进行学习。

自定义路由断言工厂

自定义路由断言工厂需要继承 AbstractRoutePredicateFactory 类,重写 apply 方法的逻辑。

在 apply 方法中可以通过 exchange.getRequest() 拿到 ServerHttpRequest 对象,从而可以获取到请求的参数、请求方式、请求头等信息。

apply 方法的参数是自定义的配置类,在使用的时候配置参数,在 apply 方法中直接获取使用。

命名需要以 RoutePredicateFactory 结尾,比如 CheckAuthRoutePredicateFactory,那么在使用的时候 CheckAuth 就是这个路由断言工厂的名称。代码如下所示。

@Componentpublic class CheckAuthRoutePredicateFactory        extends AbstractRoutePredicateFactory {    public CheckAuthRoutePredicateFactory() {        super(Config.class);    }    @Override    public Predicate apply(Config config) {        return exchange -> {            System.err.println("进入了CheckAuthRoutePredicateFactory\t" + config.getName());            if (config.getName().equals("zhangsan")) {                return true;            }            return false;        };    }    public static class Config {        private String name;        public void setName(String name) {            this.name = name;        }        public String getName() {            return name;        }    }}

使用示例如下所示:

spring:  cloud:    gateway:      routes:  - id: customer_route  uri: http://minglisoft.cn  predicates:    - name: CheckAuth  args:    name: zhangsan

到此,关于"SpringCloud-Gateway的常用路由断言工厂有哪些"的学习就结束了,希望能够解决大家的疑惑。理论与实践的搭配能更好的帮助大家学习,快去试试吧!若想继续学习更多相关知识,请继续关注网站,小编会继续努力为大家带来更多实用的文章!

0