Spring Cloud Gateway 入门示例

没事儿写两篇

已于 2023-01-29 16:48:13 修改

阅读量1k

点赞数 1

分类专栏：人在江湖之Spring Cloud aibaba 文章标签： Gateway 过滤器断言重试入门

于 2023-01-29 11:45:19 首次发布

本文链接：https://blog.csdn.net/forlinkext/article/details/128735486

版权

人在江湖之Spring Cloud aibaba 专栏收录该内容

24 篇文章 3 订阅

订阅专栏

前言

Spring Cloud Gateway 基于 Spring Boot 2.x、Spring WebFlux和Project Reactor，WebFlux默认启动容器是Netty，在学习之前最好是做一些相关的了解。特别是WebFlux。

pom文件配置

<?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">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>myGateway</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <build.name>myGateway</build.name>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>

        <spring.cloud.version>2021.0.4</spring.cloud.version>
        <spring.cloud.alibaba.version>2021.0.4.0</spring.cloud.alibaba.version>
    </properties>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.11</version>
    </parent>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring.cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <!-- 添加网关支持 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway</artifactId>
        </dependency>
    </dependencies>


    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <profileActive>dev</profileActive>
            </properties>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
        </profile>
        <profile>
            <id>test</id>
            <properties>
                <profileActive>test</profileActive>
            </properties>
        </profile>
        <profile>
            <id>pre</id>
            <properties>
                <profileActive>pre</profileActive>
            </properties>
        </profile>
        <profile>
            <id>prod</id>
            <properties>
                <profileActive>prod</profileActive>
            </properties>
        </profile>
    </profiles>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>

        <finalName>${build.name}</finalName>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <filtering>true</filtering>
                <includes>
                    <include>mapper/**/*.xml</include>
                    <include>application.yml</include>
                    <include>application-${profileActive}.yml</include>
                    <include>application.properties</include>
                    <include>application-${profileActive}.properties</include>
                    <include>bootstrap.properties</include>
                    <include>logback-spring.xml</include>
                </includes>
            </resource>
        </resources>
    </build>

</project>

在pom文件中添加spring-cloud-starter-gateway依赖即可。

yml配置

server:
  port: 8080
spring:
  cloud:
    gateway:
      routes:
        - id: myCloud_route
          uri: http://127.0.0.1:8701/myCloud
          predicates:
            - Path=/myCloud/**

我们的路由开发端口为8080，上下文为/

这里我们配置了一个路径断言（Predicate），所有/myCloud上下文的请求，都路由到http://127.0.0.1:8701/myCloud。路由到的地址是我们前文中的Provider 8701。

启动类

package com.yyoo.cloud.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication(scanBasePackages = {"com.yyoo"})
public class Application {

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

}

我们的启动类没有任何的区别。

访问验证

访问 http://127.0.0.1:8080/myCloud/conf/getCommonConf ，返回结果如下：

CommonConf(name=没事儿写两篇, age=12, desc=Spring Cloud 学习)8701

我们通过Gateway网关的接口访问到了我们的Provider 8701的接口。

网关的关键组件

路由（route）：路由是网关的基础构件，其内部包括id（路由的名称）、uri（目标url）、predicates（断言集合）、filters（过滤器集合）
断言（predicate）：对请求进行断言，如果断言为真，则匹配该路由，访问该路由配置的uri。
过滤器（filter）：通过过滤器可以在发送下游请求之前或之后修改请求和响应。

路由断言工厂

注：以下均为官网示例

断言指定时间之后

spring:
  cloud:
    gateway:
      routes:
      - id: after_route
        uri: https://example.org
        predicates:
        - After=2017-01-20T17:42:47.789-07:00[America/Denver]

该路由匹配 2017 年 1 月 20 日 17:42 之后提出的任何请求。(注意时区)，此配置是ZonedDateTime对象

断言指定时间之前

spring:
  cloud:
    gateway:
      routes:
      - id: before_route
        uri: https://example.org
        predicates:
        - Before=2017-01-20T17:42:47.789-07:00[America/Denver]

断言在指定时间之间

spring:
  cloud:
    gateway:
      routes:
      - id: between_route
        uri: https://example.org
        predicates:
        - Between=2017-01-20T17:42:47.789-07:00[America/Denver], 2017-01-21T17:42:47.789-07:00[America/Denver]

Cookie断言

spring:
  cloud:
    gateway:
      routes:
      - id: cookie_route
        uri: https://example.org
        predicates:
        - Cookie=chocolate, ch.p

此路由匹配具有名为 chocolate的cookie，并且其值与 ch.p 正则表达式相匹配的 cookie 的请求。

请求头断言

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

意为请求头为X-Request-Id，其值满足正则表达式\d+，多个请求头添加多个predicate即可。

路径断言

spring:
  cloud:
    gateway:
      routes:
      - id: path_route
        uri: https://example.org
        predicates:
        - Path=/red/{segment},/blue/{segment}

{segment}为占位符，断言工厂会将对应的值通过ServerWebExchange.setAttributes()放在ServerWebExchange，其key值为ServerWebExchangeUtils.URI_TEMPLATE_VARIABLES_ATTRIBUTE。之后可以在GatewayFilter中使用

Map<String, String> uriVariables = ServerWebExchangeUtils.getPathPredicateVariables(exchange);
String segment = uriVariables.get("segment");

其他断言工厂

其他断言工厂请查看官网网关路由断言工厂

网关过滤器工厂

添加请求头

spring:
  cloud:
    gateway:
      routes:
      - id: add_request_header_route
        uri: https://example.org
        filters:
        - AddRequestHeader=X-Request-red, blue

使用URI扩展变量

spring:
  cloud:
    gateway:
      routes:
      - id: add_request_header_route
        uri: https://example.org
        predicates:
        - Path=/red/{segment}
        filters:
        - AddRequestHeader=X-Request-Red, Blue-{segment}

与之对应的还有，添加请求参数，添加响应头，删除请求参数、请求头，响应头等网关过滤器。

路径重写过滤器

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

对于请求路径/red/blue，会将路径设置为/blue发出下游请求之前的路径。

由于 YAML 规范，$ 被替换为。$\

此操作相当于把当前的请求uri中的/red给去掉了，这在要访问的uri上下文和我们网关访问的uri的上下午不一致时非常有用。

重试过滤器

spring:
  cloud:
    gateway:
      httpclient:
        connect-timeout: 1000 # 连接超时
        response-timeout: 5s # 响应超时（响应超时请合理设置，太短会造成多次重试）
      routes:
        - id: myCloud_route
          uri: http://127.0.0.1:8701/myCloud
          predicates:
            - Path=/myCloud/**
          filters:
            - AddRequestHeader=X-token, blue
            - name: Retry
              args:
                retries: 3
                statuses: BAD_GATEWAY
                methods: GET,POST
                backoff:
                  firstBackoff: 10ms
                  maxBackoff: 50ms
                  factor: 2
                  basedOnPreviousValue: false

示例设置了连接超时和响应超时的时间设置

注：特别是响应超时的时候，其实请求是实际发送了的，只是服务端响应时间太长，导致响应超时，这就要确保我们请求的接口幂等性，否则会有重复数据出现。

重试参数说明

retries：应尝试的重试次数。
statuses：应该重试的HTTP状态码，org.springframework.http.HttpStatus。
methods：应该重试的 HTTP 方法，org.springframework.http.HttpMethod。
series：要重试的一系列状态码，org.springframework.http.HttpStatus.Series。
exceptions：应重试的抛出异常列表。
backoff：重试退避指数。在退避间隔 firstBackoff * (factor ^ n) 后执行重试，其中n是迭代。如果已配置 maxBackoff，则最大退避限制为 maxBackoff. 如果basedOnPreviousValue为真，则使用 prevBackoff * factor 计算退避。

重试参数默认值

retries: 3
series：5XX
methods: GET
exceptions:IOException和TimeoutException
backoff：null 禁用

其他过滤器工厂

其他过滤器工厂请查看官网网关路由过滤器工厂

没事儿写两篇

关注

1
点赞
踩
2

收藏

觉得还不错? 一键收藏
0
评论
Spring Cloud Gateway 入门示例

Spring Cloud Gateway 基于 Spring Boot 2.x、Spring WebFlux和Project Reactor，WebFlux默认启动容器是Netty，在学习之前最好是做一些相关的了解。特别是WebFlux。
复制链接

扫一扫