前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >SpringCloud微服务之网关Gateway

SpringCloud微服务之网关Gateway

作者头像
cheese
发布2023-10-25 11:21:33
2620
发布2023-10-25 11:21:33
举报
文章被收录于专栏:Java PorterJava Porter

大纲

概述简介

官网

是什么

Cloud全家桶中有个很重要的组件就是网关,在1.x版本中都是采用的Zuul网关; 但在2.x版本中,zuul的升级一直跳票,SpringCloud最后自己研发了一个网关替代Zuul, 那就是SpringCloud Gateway一句话:gateway是原zuul1.x版的替代

image.png
image.png
  • Gateway的发展
  • Gateway是在Spring生态系统之上构建的API网关服务,基于Spring 5,Spring Boot 2和 Project Reactor等技术。
  • Gateway旨在提供一种简单而有效的方式来对API进行路由,以及提供一些强大的过滤器功能, 例如:熔断、限流、重试等
image.png
image.png
  • SpringCloud Gateway 是 Spring Cloud 的一个全新项目,基于 Spring 5.0+Spring Boot 2.0 和 Project Reactor 等技术开发的网关,它旨在为微服务架构提供一种简单有效的统一的 API 路由管理方式。
  • SpringCloud Gateway 作为 Spring Cloud 生态系统中的网关,目标是替代 Zuul,在Spring Cloud 2.0以上版本中,没有对新版本的Zuul 2.0以上最新高性能版本进行集成,仍然还是使用的Zuul 1.x非Reactor模式的老版本。而为了提升网关的性能,SpringCloud Gateway是基于WebFlux框架实现的,而WebFlux框架底层则使用了高性能的Reactor模式通信框架Netty。
  • Spring Cloud Gateway的目标提供统一的路由方式且基于 Filter 链的方式提供了网关基本的功能,例如:安全,监控/指标,和限流。
  • Gateway远程调用采用Http协议而非RPC
  • 小结
    • SpringCloud Gateway 使用的Webflux中的reactor-netty响应式编程组件,底层使用了Netty通讯框架。
1694999232732.png
1694999232732.png

应用场景

  • 反向代理
  • 鉴权
  • 流量控制
  • 熔断
  • 日志监控
  • etc…

微服务架构中的网关

image.png
image.png

Zuul的局限

选着Gateway的理由
  • neflix不太靠谱,zuul2.0一直跳票,迟迟不发布

一方面因为Zuul1.0已经进入了维护阶段,而且Gateway是SpringCloud团队研发的,是亲儿子产品,值得信赖。 而且很多功能Zuul都没有用起来也非常的简单便捷。 Gateway是基于异步非阻塞模型上进行开发的,性能方面不需要担心。虽然Netflix早就发布了最新的 Zuul 2.x, 但 Spring Cloud 貌似没有整合计划。而且Netflix相关组件都宣布进入维护期;不知前景如何? 多方面综合考虑Gateway是很理想的网关选择

  • SpringCloud Gateway具有如下特性
    • 基于Spring Framework 5, Project Reactor 和 Spring Boot 2.0 进行构建;
    • 动态路由:能够匹配任何请求属性;
    • 可以对路由指定 Predicate(断言)和 Filter(过滤器);
    • 集成Hystrix的断路器功能;
    • 集成 Spring Cloud 服务发现功能;
    • 易于编写的 Predicate(断言)和 Filter(过滤器);
    • 请求限流功能;
    • 支持路径重写。
  • SpringCloud Gateway 与 Zuul的区别

在SpringCloud Finchley 正式版之前,Spring Cloud 推荐的网关是 Netflix 提供的Zuul: 1、Zuul 1.x,是一个基于阻塞 I/ O 的 API Gateway 2、Zuul 1.x 基于Servlet 2. 5使用阻塞架构它不支持任何长连接(如 WebSocket) Zuul 的设计模式和Nginx较像,每次 I/ O 操作都是从工作线程中选择一个执行,请求线程被阻塞到工作线程完成,但是差别是Nginx 用C++ 实现,Zuul 用 Java 实现,而 JVM 本身会有第一次加载较慢的情况,使得Zuul 的性能相对较差。 3、Zuul 2.x理念更先进,想基于Netty非阻塞和支持长连接,但SpringCloud目前还没有整合。 Zuul 2.x的性能较 Zuul 1.x 有较大提升。在性能方面,根据官方提供的基准测试, Spring Cloud Gateway 的 RPS(每秒请求数)是Zuul 的 1. 6 倍。 4、Spring Cloud Gateway 建立 在 Spring Framework 5、 Project Reactor 和 Spring Boot 2 之上, 使用非阻塞 API。 5、Spring Cloud Gateway 还 支持 WebSocket, 并且与Spring紧密集成拥有更好的开发体验

Zuul1.x模型
  • Springcloud中所集成的Zuul版本,采用的是Tomcat容器,使用的是传统的Servlet IO处理模型。
  • servlet生命周期
    • Servlet的生命周期?servlet由servlet container进行生命周期管理,container启动时构造servlet对象并调用servlet init()进行初始化;
    • container运行时接受请求,并为每个请求分配一个线程(一般从线程池中获取空闲线程)然后调用service()。
    • container关闭时调用servlet destory()销毁servlet;
servlet_module.png
servlet_module.png
  • 上述模式的缺点:
    • servlet是一个简单的网络IO模型,当请求进入servlet container时,servlet container就会为其绑定一个线程,在并发不高的场景下这种模型是适用的。
    • 但是一旦高并发(比如抽风用jemeter压),线程数量就会上涨,而线程资源代价是昂贵的(上线文切换,内存消耗大)严重影响请求的处理时间。
    • 在一些简单业务场景下,不希望为每个request分配一个线程,只需要1个或几个线程就能应对极大并发的请求,这种业务场景下servlet模型没有优势
    • 所以Zuul 1.X是基于servlet之上的一个阻塞式处理模型,即spring实现了处理所有request请求的一个servlet(DispatcherServlet)并由该servlet阻塞式处理处理。
    • 所以Springcloud Zuul无法摆脱servlet模型的弊端
Gateway模型
image.png
image.png
  • 传统的Web框架,比如说:struts2,springmvc等都是基于Servlet API与Servlet容器基础之上运行的。
  • 但是在Servlet3.1之后有了异步非阻塞的支持。而WebFlux是一个典型非阻塞异步的框架,它的核心是基于Reactor的相关API实现的。相对于传统的web框架来说,它可以运行在诸如Netty,Undertow及支持Servlet3.1的容器上。非阻塞式+函数式编程(Spring5必须让你使用java8)
  • Spring WebFlux 是 Spring 5.0 引入的新的响应式框架,区别于 Spring MVC,它不需要依赖Servlet API,它是完全异步非阻塞的,并且基于 Reactor 来实现响应式流规范。

三大核心概念

Route(路由)

路由是构建网关的基本模块,它由ID,目标URI,一系列的断言和过滤器组成,如果断言为true则匹配该路由

Predicate(断言)

参考的是Java8的java.util.function.Predicate 开发人员可以匹配HTTP请求中的所有内容(例如请求头或请求参数),如果请求与断言相匹配则进行路由

Filter(过滤)

指的是Spring框架中GatewayFilter的实例,使用过滤器,可以在请求被路由前或者之后对请求进行修改。

小结

image.png
image.png
  • web请求,通过一些匹配条件,定位到真正的服务节点。并在这个转发过程的前后,进行一些精细化控制。
  • predicate就是我们的匹配条件;
  • filter,就可以理解为一个无所不能的拦截器。有了这两个元素,再加上目标uri,就可以实现一个具体的路由了

Gateway工作流程

官网说明

image.png
image.png
image.png
image.png

客户端向 Spring Cloud Gateway 发出请求。然后在 Gateway Handler Mapping 中找到与请求相匹配的路由,将其发送到 Gateway Web Handler。 Handler 再通过指定的过滤器链来将请求发送到我们实际的服务执行业务逻辑,然后返回。 过滤器之间用虚线分开是因为过滤器可能会在发送代理请求之前(“pre”)或之后(“post”)执行业务逻辑。 Filter在“pre”类型的过滤器可以做参数校验、权限校验、流量监控、日志输出、协议转换等, 在“post”类型的过滤器中可以做响应内容、响应头的修改,日志的输出,流量监控等有着非常重要的作用。

核心逻辑

  • 路由转发+执行过滤器链

入门配置

环境搭建

  • 新建module,cloud-gateway-gateway9527,作为服务提供者微服务的上层网络映射
  • 引入pom文件
代码语言:javascript
复制
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <parent>
    <artifactId>cloud2023</artifactId>
    <groupId>top.ljzstudy.springcloud</groupId>
    <version>1.0-SNAPSHOT</version>
  </parent>
  <modelVersion>4.0.0</modelVersion>

  <artifactId>cloud-gateway-gateway9527</artifactId>

  <dependencies>
    <!--gateway-->
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>
    <!--eureka-client-->
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>
    <!-- 引入自己定义的api通用包,可以使用Payment支付Entity -->
    <dependency>
      <groupId>top.ljzstudy.springcloud</groupId>
      <artifactId>cloud-api-commons</artifactId>
      <version>1.0-SNAPSHOT</version>
    </dependency>
    <!--一般基础配置类-->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-devtools</artifactId>
      <scope>runtime</scope>
      <optional>true</optional>
    </dependency>
    <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <optional>true</optional>
    </dependency>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>
  • 坑点
    • 在Gateway中集成了Spring5的webflux,无需引入以下模块
代码语言:javascript
复制
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
代码语言:javascript
复制
  - web依赖异常
1694106970421.png
1694106970421.png
1694106793301.png
1694106793301.png
  • 9527网关如何做路由映射?
    • cloud-provider-payment8001看看controller的访问地址(get/lb)
    • 我们目前不想暴露8001端口,希望在8001外面套一层9527
  • 编写appliaction.yml文件,新增配置项
代码语言:javascript
复制
.....
spring:
  cloud:
    gateway:
      routes:
        - id: payment_routh #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
          uri: http://localhost:8001          #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/get/**         # 断言,路径相匹配的进行路由

        - id: payment_routh2 #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
          uri: http://localhost:8001          #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/lb/**         # 断言,路径相匹配的进行路由
.....

编写业务类与配置启动类

  • 作为网关服务,无需编写业务模块
  • 配置主启动类
代码语言:javascript
复制
package top.ljzstudy.springcloud;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;

@SpringBootApplication
@EnableEurekaClient
public class GateWayMain9527 {
    public static void main(String[] args) {
        SpringApplication.run(GateWayMain9527.class, args);
    }
}

测试

  • 依次启动Eureka7001,Payment8001,MainApp80
image.png
image.png
代码语言:javascript
复制
GET http://localhost:9527/payment/get/1

HTTP/1.1 200 OK
transfer-encoding: chunked
Content-Type: application/json
Date: Thu, 07 Sep 2023 17:47:48 GMT

{
  "code": 200,
  "message": "successful query data to id =1 from port number : 8001",
  "data": {
    "id": 1,
    "serial": "ljzTest01"
  }
}

Response code: 200 (OK); Time: 829ms; Content length: 116 bytes
  • YML文件映射
image.png
image.png
  • 小结
    • 添加网关之前只能使用8001端口,添加网关之后可以通过9527端口进行访问

Gateway网关路由配置类配置

理论基础
  • 代码中注入RouteLocator的Bean
  • 官网Demo
image.png
image.png
案例实现==>配置跳转自定义网址
  • 编写配置类
代码语言:javascript
复制
package top.ljzstudy.springcloud.config;

import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class GatewayConfig {
    /**
     * 配置了一个id为route-name的路由规则,
     * 当访问地址 http://localhost:9527/ljz66254时会自动转发到地址:https://blog.csdn.net/ljz66254
     * @param routeLocatorBuilder
     * @return
     */
    @Bean
    public RouteLocator customRouteLocator(RouteLocatorBuilder routeLocatorBuilder) {
        RouteLocatorBuilder.Builder routes = routeLocatorBuilder.routes();
        return routes.route("path_route_ljzstudy",//当前的工程路径
                r -> r.path("/ljz66254") //指定跳转的路径
                        .uri("https://blog.csdn.net/ljz66254")).build();
    }
}
1695022703959.png
1695022703959.png

通过微服务名实现动态路由

默认情况下Gateway会根据注册中心注册的服务列表, 以注册中心上微服务名为路径创建动态路由进行转发,从而实现动态路由的功能

环境构建与配置

  • pom文件
代码语言:javascript
复制
<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
  • 修改application.yaml文件
代码语言:javascript
复制
....
spring:
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true #开启从注册中心动态创建路由的功能,利用微服务名进行路由
      routes:
        - id: payment_routh #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
          # uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri: lb://cloud-payment-service #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/get/**         # 断言,路径相匹配的进行路由

        - id: payment_routh2 #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
          # uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri: lb://cloud-payment-service #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/lb/**         # 断言,路径相匹配的进行路由
....
  • 需要注意的是uri的协议为lb,表示启用Gateway的负载均衡功能。
  • lb://serviceName是spring cloud gateway在微服务中自动为我们创建的负载均衡uri
  • 测试
image.png
image.png
  • 8001/8002两个端口切换

断言Predicate的使用

简介

  • predicate是什么?
  • 在gateway9527启动时会看到以下信息
image.png
image.png
  • Route Predicate Factories是什么?
image.png
image.png

Spring Cloud Gateway将路由匹配作为Spring WebFlux HandlerMapping基础架构的一部分。 Spring Cloud Gateway包括许多内置的Route Predicate工厂。所有这些Predicate都与HTTP请求的不同属性匹配。多个Route Predicate工厂可以进行组合 Spring Cloud Gateway 创建 Route 对象时, 使用 RoutePredicateFactory 创建 Predicate 对象,Predicate 对象可以赋值给 Route。 Spring Cloud Gateway 包含许多内置的Route Predicate Factories。 所有这些谓词都匹配HTTP请求的不同属性。多种谓词工厂可以组合,并通过逻辑and。

常用的Route Predicate

image.png
image.png
  • After Route Predicate

在设定的断言时间之后访问有效,否则404

image.png
image.png
  • 编写测试类获取当前时区时间
代码语言:javascript
复制
package top.ljzstudy.springcloud.test;

import org.junit.jupiter.api.Test;

import java.time.ZonedDateTime;


public class T1 {
    @Test
    public void getZoneTime(){
        ZonedDateTime time = ZonedDateTime.now();
        System.out.println("time = " + time);
    }
}
image.png
image.png
  • YML
代码语言:javascript
复制
spring:
    cloud:
        gateway:
          routes:
              predicates:
                - Path=/payment/get/**         # 断言,路径相匹配的进行路由
                - After=2023-09-19T00:51:20.081+08:00[GMT+08:00]
image.png
image.png
image.png
image.png
  • Before Route Predicate

在设置的断言时间之前访问有效,否则404

image.png
image.png
  • YML
代码语言:javascript
复制
spring:
    cloud:
        gateway:
          routes:
              predicates:
                - Path=/payment/get/**         # 断言,路径相匹配的进行路由
                - Before=2023-09-19T00:51:20.081+08:00[GMT+08:00]

在设置断言的时间段之间访问有效,否则404

  • YAML
代码语言:javascript
复制
spring:
    cloud:
        gateway:
          routes:
              predicates:
                - Path=/payment/get/**         # 断言,路径相匹配的进行路由
                - Between=2023-09-19T00:51:20.081+08:00[GMT+08:00],2023-09-19T01:51:20.081+08:00[GMT+08:00]

按照断言要求,判断是否携带cookie,满足断言通过,否则404

image.png
image.png

  • Cookie Route Predicate需要两个参数,一个是 Cookie name ,一个是正则表达式。
  • 路由规则会通过获取对应的 Cookie name 值和正则表达式去匹配,如果匹配上就会执行路由,如果没有匹配上则不执行
  • YML
代码语言:javascript
复制
spring:
  cloud:
    gateway:
      routes:
        - id: payment_routh #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
#          uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri : lb://cloud-payment-service #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/get/**         # 断言,路径相匹配的进行路由
            - After=2023-09-19T00:51:20.081+08:00[GMT+08:00]
#            - Before=2023-09-19T00:51:20.081+08:00[GMT+08:00]
#            - Between=2023-09-19T00:51:20.081+08:00[GMT+08:00],2023-09-19T01:51:20.081+08:00[GMT+08:00]
            - Cookie=username,LJZ         #Cookie键值对
  • curl的使用
    • 不带cookies访问curl [http://localhost:9527/payment/get/1](http://localhost:9527/payment/get/1)
image.png
image.png
  • 带上cookies访问
    • curl [http://localhost:9527/payment/get/1](http://localhost:9527/payment/get/1) --cookie "username=LJZ"
image.png
image.png
  • Header Route Predicate

请求头断言设置

image.png
image.png
  • 两个参数:一个是属性名称和一个正则表达式,这个属性值和正则表达式匹配则执行。
  • YAML
代码语言:javascript
复制
spring:
  cloud:
    gateway:
      routes:
        - id: payment_routh #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
#          uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri : lb://cloud-payment-service #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/get/**         # 断言,路径相匹配的进行路由
            - After=2023-09-19T00:51:20.081+08:00[GMT+08:00]
            - Header=X-Request-Id, \d+ # 请求头要有X-Request-Id属性并且值为整数的正则表达式
  • 测试
1695058877262.png
1695058877262.png
  • Host Route Predicate
image.png
image.png

Host Route Predicate 接收一组参数,一组匹配的域名列表,这个模板是一个 ant 分隔的模板,用.号作为分隔符。 它通过参数中的主机地址作为匹配规则。

  • YAML
代码语言:javascript
复制
spring:
  cloud:
    gateway:
      routes:
        - id: payment_routh #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
#          uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri : lb://cloud-payment-service #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/get/**         # 断言,路径相匹配的进行路由
            - After=2023-09-19T00:51:20.081+08:00[GMT+08:00]
            - Host=**.blog.csdn.net
  • 测试
1695086800199.png
1695086800199.png
  • Method Route Predicate

指定请求方法的断言

image.png
image.png
  • YAML
代码语言:javascript
复制
spring:
  cloud:
    gateway:
      routes:
        - id: payment_routh #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
#          uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri : lb://cloud-payment-service #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/get/**         # 断言,路径相匹配的进行路由
            - After=2023-09-19T00:51:20.081+08:00[GMT+08:00]
            - Method=GET  #指定请求方式必须是GET
  • Path Route Predicate

路径断言匹配

image.png
image.png
    • Path=uri
  • Query Route Predicate

参数正则匹配

image.png
image.png
  • 支持传入两个参数,一个是属性名,一个为属性值,属性值可以是正则表达式。
代码语言:javascript
复制
spring:
  cloud:
    gateway:
      routes:
        - id: payment_routh #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
#          uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri : lb://cloud-payment-service #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/get/**         # 断言,路径相匹配的进行路由
            - After=2023-09-19T00:51:20.081+08:00[GMT+08:00]
            - Method=GET  #指定请求方式必须是GET
            - Query=username, \d+  # 要有参数名username并且值还要是整数才能路由
  • 测试
image.png
image.png

小总结

代码语言:javascript
复制
server:
  port: 9527

spring:
  application:
    name: cloud-gateway
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true #开启从注册中心动态创建路由的功能 , 利用微服务名进行路由
      routes:
        - id: payment_routh #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
#          uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri : lb://cloud-payment-service #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/get/**         # 断言,路径相匹配的进行路由
            - After=2023-09-19T00:51:20.081+08:00[GMT+08:00]
#            - Before=2023-09-19T00:51:20.081+08:00[GMT+08:00]
#            - Between=2023-09-19T00:51:20.081+08:00[GMT+08:00],2023-09-19T01:51:20.081+08:00[GMT+08:00]
#            - Cookie=username,LJZ         #Cookie键值对
#            - Header=X-Request-Id, \d+ # 请求头要有X-Request-Id属性并且值为整数的正则表达式
#            - Host=**.ljzstudy.top
#            - Method=GET
            - Query=username, \d+  # 要有参数名username并且值还要是整数才能路由
        - id: payment_routh2 #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
#          uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri : lb://cloud-payment-service #匹配后提供服务的路由地址
          predicates:
            - Path=/payment/lb/**         # 断言,路径相匹配的进行路由

eureka:
  instance:
    hostname: cloud-gateway-service
  client: #服务提供者provider注册进eureka服务列表内
    service-url:
      register-with-eureka: true
      fetch-registry: true
      defaultZone: http://eureka7001.com:7001/eureka
#id:我们自定义的路由 ID,保持唯一
 ##uri:目标服务地址
 ##predicates:路由条件,Predicate接受一个输入参数返回一个布尔值。
 ##            该属性包含多种默认方法来将Predicate组合成其他复杂的逻辑(比如:与,或,非)

说白了,Predicate就是为了实现一组匹配规则, 让请求过来找到对应的Route进行处理。

过滤器Filter的使用

Filter是什么?

image.png
image.png
  • 路由过滤器可用于修改进入的HTTP请求和返回的HTTP响应,路由过滤器只能指定路由进行使用。
  • Spring Cloud Gateway 内置了多种路由过滤器,他们都由GatewayFilter的工厂类来产生

Spring Cloud Gateway的Filter

生命周期(life cycle)
  • pre
  • post
种类(category)
image.png
image.png
  • 31种之多…
  • GlobalFilter
image.png
image.png
  • 10种
  • 众多过滤器中比较常见的一个过滤器为AddRequestParament
    • YAML文件
代码语言:javascript
复制
spring:
  cloud:
    gateway:
      routes:
        - id: payment_routh #payment_route    #路由的ID,没有固定规则但要求唯一,建议配合服务名
#          uri: http://localhost:8001          #匹配后提供服务的路由地址
          uri : lb://cloud-payment-service #匹配后提供服务的路由地址
          filters:
            - AddRequestParameter=X-Request-Id,1024 #过滤器工厂会在匹配的请求头加上一对请求头,名称为X-Request-Id值为1024

自定义过滤器(全局过滤器)(开发者最为常见的做法)

  • 自定义全局过滤器
实现两个重要接口
  • GlobalFilter
  • Ordered
作用
  • 全局日志记录
  • 统一网关鉴权
  • etc。。。。。。
编写配置类
代码语言:javascript
复制
package top.ljzstudy.springcloud.filter;

import org.springframework.cloud.gateway.filter.GatewayFilterChain;
import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.core.annotation.Order;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Component;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;

import java.util.Date;

@Component
@Order(0)
public class MyLogGlobalFilter implements GlobalFilter/*, Ordered*/ {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        System.out.println("time:" + new Date() + "\t 执行了自定义的全局过滤器: " + "MyLogGateWayFilter" + "hello");

        String uname = exchange.getRequest().getQueryParams().getFirst("uname");
        if (uname == null) {
            System.out.println("****用户名为null,无法登录");
            exchange.getResponse().setStatusCode(HttpStatus.NOT_ACCEPTABLE);
            return exchange.getResponse().setComplete();
        }
        return chain.filter(exchange);
    }

    //    @Override
    //    public int getOrder() {
    //        return 0;
    //    }
}
测试
image.png
image.png
  • 错误访问
image.png
image.png
image.png
image.png
  • 控制台日志信息
image.png
image.png
  • 结论 : 没有uname参数gateway无法进行正常转发
本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2023-09-19,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 大纲
  • 概述简介
    • 官网
      • 是什么
        • 应用场景
          • 微服务架构中的网关
            • Zuul的局限
              • 选着Gateway的理由
              • Zuul1.x模型
              • Gateway模型
          • 三大核心概念
            • Route(路由)
              • Predicate(断言)
                • Filter(过滤)
                  • 小结
                  • Gateway工作流程
                    • 官网说明
                      • 核心逻辑
                      • 入门配置
                        • 环境搭建
                          • 编写业务类与配置启动类
                            • 测试
                              • Gateway网关路由配置类配置
                                • 理论基础
                                • 案例实现==>配置跳转自定义网址
                            • 通过微服务名实现动态路由
                              • 环境构建与配置
                              • 断言Predicate的使用
                                • 简介
                                  • 常用的Route Predicate
                                    • 小总结
                                    • 过滤器Filter的使用
                                      • Filter是什么?
                                        • Spring Cloud Gateway的Filter
                                          • 生命周期(life cycle)
                                          • 种类(category)
                                        • 自定义过滤器(全局过滤器)(开发者最为常见的做法)
                                          • 实现两个重要接口
                                          • 作用
                                          • 编写配置类
                                          • 测试
                                      相关产品与服务
                                      微服务引擎 TSE
                                      微服务引擎(Tencent Cloud Service Engine)提供开箱即用的云上全场景微服务解决方案。支持开源增强的云原生注册配置中心(Zookeeper、Nacos 和 Apollo),北极星网格(腾讯自研并开源的 PolarisMesh)、云原生 API 网关(Kong)以及微服务应用托管的弹性微服务平台。微服务引擎完全兼容开源版本的使用方式,在功能、可用性和可运维性等多个方面进行增强。
                                      领券
                                      问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档