SpringCloudGateway网关原理与配置

 一、概述

    二、基本术语与工作原理

    三、网关的配置与使用

    四、路由谓语和过滤器的配置方式

    五、附录

        1. 示例代码

分布式系统中,微服务网关是很重要的组件,面向入口流量的 API 网关可以实现路由管理、权限验证、熔断限流等功能。

一、概述

Spring Cloud Gateway 是 SpringCloud 官方提供的网关组件,只需通过简单的配置就可以实现强大的路由管理功能。

二、基本术语与工作原理

Spring Cloud Gateway 包含三个重要的部分:

  • 路由(Route):网关的基础部分,路由包含 ID、URI、一组谓语和一组过滤器,通过谓语返回 true 来匹配路由。

  • 谓语(Predicate):通过 Java 8 的 Predicate<T> 接口实现,可以通过任何方式匹配路由,例如请求头、参数等。

  • 过滤器(Filter):通常以过滤器链的形式存在,可以访问和修改请求和响应,业务逻辑一般在过滤器中实现。

当客户端请求 Spring Cloud Gateway,首先通过网关的 Handler Mapping 匹配路由,匹配通过后该请求会发送到网关的 Web Handler,这个 Handler 会运行一组特定的过滤器链。

过滤器会在代理请求之前(pre 阶段)或响应之后(post 阶段)运行代码逻辑。

三、网关的配置与使用

在 Spring 项目中集成 Spring Cloud Gateway 需要配置下面依赖:

<!--在父项目或者当前项目中指定SpringCloud版本依赖-->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>${spring-cloud-dependencies.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<!--在当前项目中添加Spring Cloud Gateway依赖-->
<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>
</dependencies>

可以使用 spring.cloud.gateway.enabled=false 配置禁用网关功能。

Spring Cloud Gateway 是基于 Spring WebFlux 实现的,不是传统的 Servlet 容器框架。

三、路由谓语和过滤器的配置方式

Spring Cloud Gateway 配置谓语和过滤器提供了两种方式。

快捷配置

快捷方式使用 = 连接谓语或过滤器名称和参数,参数按顺序使用 , 分隔。

spring.cloud.gateway.routes:
  - id: shortcut
    uri: https://example.org
    predicates:
      - Path=/red/**
    filters:
      - RewritePath=/red(?<segment>/?.*), $\{segment}

参数展开配置

参数展开方式使用 name 属性来指定谓语或过滤器名称,使用 args 属性来指定参数。

spring.cloud.gateway.routes:
  - id: full
    uri: https://example.org
    predicates:
      - name: Path
        args:
          patterns: /red/**
    filters:
      - name: RewritePath
        args:
          regexp: /red(?<segment>/?.*)
          replacement: $\{segment}

两种方式实现功能一致,按个人爱好选择配置。

谓语和过滤器都是有序的,也能说是有优先级的,优先级高的 pre 部分先执行,post 部分后执行。

四、附录

1. 示例代码

Gitee 仓库:

https://gitee.com/code_artist/springcloud

Github 仓库:

https://github.com/AiJiangnan/springcloud

 

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值