Spring Cloud Gateway 服务网关

最新推荐文章于 2022-11-25 12:01:55 发布

程序员35

最新推荐文章于 2022-11-25 12:01:55 发布

阅读量284

点赞数

分类专栏： Spring Cloud 教程合集文章标签： Spring Cloud gateway

本文链接：https://blog.csdn.net/cxy35/article/details/105927830

版权

Spring Cloud 教程合集专栏收录该内容

17 篇文章 2 订阅

订阅专栏

文章目录

学习在 Spring Cloud 中使用 Gateway 实现服务网关，包括基本使用、自动代理、 Predicate 、 Filter 等功能。

1 概述

Gateway 的主要功能如下：

限流
路径重写
动态路由
集成 Spring Cloud DiscoveryClient
集成 Hystrix 断路器

和 Zuul 相比，有如下区别：

Zuul 是 Netﬂix 公司的开源产品， Spring Cloud Gateway 是 Spring 家族中的产品，可以和 Spring 家族中的其他组件更好的融合。
Zuul 不支持长连接（版本一），例如 Websocket 。
Spring Cloud Gateway 支持限流。
Spring Cloud Gateway 基于 Netty 来开发，实现了异步和非阻塞，占用资源更小，性能强于 Zuul 。

2 准备工作

2.1 服务注册

创建 Spring Boot 项目 gateway-client-provider ，作为我们的服务提供者，添加 Web/Eureka Client 依赖，如下：

最终的依赖如下：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
        <exclusions>
            <exclusion>
                <groupId>org.junit.vintage</groupId>
                <artifactId>junit-vintage-engine</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

项目创建成功后，修改 application.properties 配置文件，将 gateway-client-provider 注册到 Eureka Server 上（服务注册中心使用 Eureka Server ），如下：

# 当前服务的名称
spring.application.name=gateway-client-provider
# 当前服务的端口
server.port=7000

# 服务注册中心地址
eureka.client.service-url.defaultZone=http://127.0.0.1:1111/eureka

接下来，启动 Eureka Server ，待服务注册中心启动成功后，再启动 gateway-client-provider ，两者都启动成功后，访问 http://127.0.0.1:1111 可以看到 gateway-client-provider 的注册信息。

当然 gateway-client-provider 也可以集群化部署，下面对 gateway-client-provider 进行打包，之后我们在命令行启动两个 provider 实例：

java -jar gateway-client-provider-0.0.1-SNAPSHOT.jar --server.port=7000
java -jar gateway-client-provider-0.0.1-SNAPSHOT.jar --server.port=7001

最后在 gateway-client-provider 提供 hello 和 hello2 接口，用于后续服务消费者 gateway-client-consumer 来消费，如下：

@RestController
public class ProviderController {
    @Value("${server.port}")
    Integer port; // 支持启动多个实例，做负载均衡，用端口区分

    @GetMapping("/hello")
    public String hello() {
        return "hello cxy35: " + port;
    }

    @GetMapping("/hello2")
    public String hello2(String name) {
        return "hello " + name;
    }
}

2.2 服务消费

创建 Spring Boot 项目 gateway-client-consumer ，作为我们的服务消费者，添加 Eureka Client/Gateway 依赖，如下：

最终的依赖如下：

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
        <exclusions>
            <exclusion>
                <groupId>org.junit.vintage</groupId>
                <artifactId>junit-vintage-engine</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

项目创建成功后，新建 application.yml 配置文件，将 gateway-client-consumer 注册到 Eureka Server 上（服务注册中心使用 Eureka Server ），如下：

# 当前服务的名称
spring:
  application:
    name: gateway-client-consumer
# 当前服务的端口
server:
  port: 7002

# 服务注册中心地址
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:1111/eureka

接下来，启动 gateway-client-consumer ，访问 http://127.0.0.1:1111 可以看到 gateway-client-consumer 的注册信息。

3 基本使用

Spring Cloud Gateway 支持两种不同的配置方法：编码配置、 YML 配置。

编码配置

在 gateway-client-consumer 项目启动类上配置一个 RouteLocator 类型的 Bean，就可以实现请求转发，如下：

@SpringBootApplication
public class GatewayClientConsumerApplication {

    public static void main(String[] args) {
        SpringApplication.run(GatewayClientConsumerApplication.class, args);
    }

    @Bean
    RouteLocator routeLocator(RouteLocatorBuilder builder) {
        return builder.routes()
                .route("cxy35_route", r ->
                        r.path("/get").uri("http://httpbin.org")) // 这是一个测试的地址
                .build();
    }
}

配置完成后，重启项目，访问 http://127.0.0.1:7002/get 完成测试。

YML 配置

注释掉上述 Java 代码，再修改 gateway-client-consumer 中的 application.yml 配置文件：

# 当前服务的名称
spring:
  application:
    name: gateway-client-consumer
  cloud:
    gateway:
      routes:
        - id: cxy35_route
          uri: http://httpbin.org # 这是一个测试的地址
          predicates:
            - Path=/get
# 当前服务的端口
server:
  port: 7002

# 服务注册中心地址
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:1111/eureka

配置完成后，重启项目，访问 http://127.0.0.1:7002/get 完成测试。

4 结合微服务使用

修改 gateway-client-consumer 中的 application.yml 配置文件：

# 当前服务的名称
spring:
  application:
    name: gateway-client-consumer
  cloud:
    gateway:
      routes:
        - id: cxy35_route
          uri: http://httpbin.org # 这是一个测试的地址
          predicates:
            - Path=/get
      discovery:
        locator:
          enabled: true # 开启自动代理
# 当前服务的端口
server:
  port: 7002

# 服务注册中心地址
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:1111/eureka

logging:
  level:
    org.springframework.cloud.gateway: debug

接下来，就可以通过 Gateway 访问到其他注册在 Eureka 上的服务了，如 http://127.0.0.1:7002/GATEWAY-CLIENT-PROVIDER/hello ，注意大小写问题。

5 Predicate

路由配置 Route 中的 Predicate 支持多种配置方式：

通过时间匹配： After （表示在某个时间点之前进行请求转发）/ Before （表示在某个时间点之前进行请求转发）/ Between （表示在两个时间点之间，两个时间点用 , 隔开）。

spring:
  cloud:
    gateway:
      routes:
        - id: cxy35_route2
          uri: http://httpbin.org
          predicates:
            - After=2021-01-01T01:01:01+08:00[Asia/Shanghai]

通过请求方法匹配： Method 。

spring:
  cloud:
    gateway:
      routes:
        - id: cxy35_route2
          uri: http://httpbin.org
          predicates:
            - Method=GET

通过请求路径匹配： Path 。

spring:
  cloud:
    gateway:
      routes:
        - id: cxy35_route2
          uri: http://httpbin.org
          predicates:
            - Path=/2020/01/{segment}

上述配置表示路径满足 /2020/01/ 这个规则，都会被进行转发。

通过请求参数名或值匹配： Query 。

spring:
  cloud:
    gateway:
      routes:
        - id: cxy35_route2
          uri: http://httpbin.org
          predicates:
            - Query=name

上述配置表示请求中一定要有 name 参数才会进行转发，否则不会进行转发。

也可以同时指定参数名和参数值，例如参数的 key 为 name ， value 必须要以 java 开始：

spring:
  cloud:
    gateway:
      routes:
        - id: cxy35_route2
          uri: http://httpbin.org
          predicates:
            - Query=name,java.*

多种匹配方式组合使用。

spring:
  cloud:
    gateway:
      routes:
        - id: cxy35_route2
          uri: http://httpbin.org
          predicates:
            - After=2021-01-01T01:01:01+08:00[Asia/Shanghai]
            - Method=GET
            - Query=name,java.*

6 Filter

Spring Cloud Gateway 中的过滤器分为两大类： GatewayFilter / GlobalFilter 。

比如 AddRequestParameter 过滤器会在请求转发路由的时候，自动额外添加参数，如：

spring:
  cloud:
    gateway:
      routes:
        - id: cxy35_route3
          uri: lb://gateway-client-provider
          filters:
            - AddRequestParameter=name,cxy35
          predicates:
            - Method=GET

配置完成后，重启项目，访问 http://127.0.0.1:7002/hello2 完成测试。

Spring Cloud 教程合集（微信左下方阅读全文可直达）。
Spring Cloud 教程合集示例代码：https://github.com/cxy35/spring-cloud-samples
本文示例代码：https://github.com/cxy35/spring-cloud-samples/tree/master/spring-cloud-gateway

扫码关注微信公众号 程序员35 ，获取最新技术干货，畅聊 #程序员的35，35的程序员# 。独立站点：https://cxy35.com

程序员35

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
Spring Cloud Gateway 服务网关

学习在 Spring Cloud 中使用 Gateway 实现服务网关，包括基本使用、自动代理、 Predicate 、 Filter 等功能。1 概述Gateway 的主要功能如下：限流路径重写动态路由集成 Spring Cloud DiscoveryClient集成 Hystrix 断路器和 Zuul 相比，有如下区别：Zuul 是 Netﬂix 公司的开源产品， S...
复制链接

扫一扫