SpringCloud Gateway网关、Gateway断言Predicate介绍

基于从前的项目：https://www.cnblogs.com/xsj1989/p/18338930
参考文章：https://blog.csdn.net/hong161688/article/details/140812734
https://blog.csdn.net/qq_34417433/article/details/135144279
Gateway断言介绍：https://blog.csdn.net/qq_36551991/article/details/135285220
官网文档：https://cloud.spring.io/spring-cloud-gateway/reference/html/

SpringCloud Gateway说明：API网关作为微服务架构中的关键组件，主要负责请求的路由、过滤、安全认证、限流熔断等功能，实现了服务间的解耦和请求的统一管理。
Spring Cloud Gateway的核心组件主要包括路由（Route）、断言（Predicate）、过滤器（Filter）和负载均衡器（LoadBalancer）。
路由（Route）：路由是网关的基本构建块，它定义了请求如何被转发到微服务。一个路由包含一个ID、一个目标URI（通常指向微服务）、一系列的断言和过滤器。当请求满足某个路由的断言条件时，该请求将被转发到对应的目标URI，并经过配置的过滤器链进行处理。
断言（Predicate）：断言用于判断请求是否满足某个条件，如请求路径是否匹配某个正则表达式、请求头是否包含特定值等。断言是路由决策的重要依据，只有满足断言条件的请求才会被转发到目标服务。
过滤器（Filter）：过滤器用于在请求被转发之前或之后对请求进行处理，如添加、修改请求头、响应头等。过滤器分为局部过滤器和全局过滤器，局部过滤器只作用于特定的路由，而全局过滤器则作用于所有路由。
负载均衡器（LoadBalancer）：Spring Cloud Gateway集成了Spring Cloud LoadBalancer，可以在多个服务实例之间分配请求，以实现高可用和高性能。负载均衡器支持多种负载均衡策略，如轮询、随机、最少活跃调用等。

新建一个Module，cloud-gateway-center
pom引入包 版本号4.1.5 在父级pom管理，子Module可不写。

        <!--SpringCloud服务网关-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway</artifactId>
        </dependency>

main改一下

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

bootstrap.yaml配置文件

server:
  port: 8004
spring:
  application:
    # Nacos添加配置，格式：${prefix}-${spring.profiles.active}.${file-extension}
    name: cloud-gateway-center
  profiles:
    active: dev # 配置环境变量，Nacos配置DataId的一部分。自定义例如：dev test pro
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848 # Nacos作为服务中心地址
      config:
        server-addr: localhost:8848 # Nacos作为配置中心地址
        file-extension: yaml # Nacos配置后缀
        group: DEFAULT_GROUP # Nacos配置分组
        namespace: 8e23ce60-9f28-4fa7-875a-5e0d61b533d5 # Nacos配置命名空间的id，默认public
      username: nacos # Nacos登录账户
      password: 123456 # Nacos登录密码
    gateway:
      enabled: true # 启用gateway
      routes:
        - id: cloud-order-service
          uri: http://localhost:8001
          predicates:
            - Path=/api/**
          filters:
            - StripPrefix=1

启动后，发送请求 http://localhost:8004/api/test/getHobbies?userId=1 被转发为 http://localhost:8001/test/getHobbies?userId=1
路由说明：
id：编号，路由的唯一标识。
uri：路由指向的目标 URI，即请求最终被转发的目的地。
predicate：谓语，断言，作为路由的匹配条件。Gateway 内置了多种 Predicate 的实现，提供了多种请求的匹配条件，比如说基于请求的 Path、Method 等等。
filters：过滤器，对请求进行拦截，实现自定义的功能。Gateway 内置了多种 Filter 的实现，提供了多种请求的处理逻辑，比如说限流、熔断等等。

断言说明
1.请求参数匹配 Query Route Predicate 支持传入两个参数，一个是属性名一个为属性值，属性值可以是正则表达式。
1.1只要请求中包含 myparameter属性的参数即可匹配路由。

spring:
  cloud:
    gateway:
      routes:
      - id: my_route
        uri: https://example.org
        predicates:
        - Query=myparameter

1.2对参数值也进行配置 - Query=myparameter,parametervalue 这样配置， myparameter属性的值为parametervalue才会匹配
1.3还可以使用正则表达式来表示 - Query=myparameter,my. 这样只要当请求中包含 myparameter属性并且参数值是以 my 开头的长度为三位的字符串才会进行匹配和路由。
2.请求路径匹配Path Route Predicate 接收一个匹配路径的参数来判断是否走路由。- Path=/user/**
这样设置，则/user开头的任一路径都会匹配路由。
在路径配置中，我们可以使用{segment}来进行占位，表示一个请求路径中的特定段。具体来说，{segment}可以用于匹配请求路径中的任意段。例如，如果有一个路由路径定义为/api/{segment}/users，那么当请求路径为/api/profile/users时，{segment}将会被替换为profile，从而匹配该路由路径。但是{segment}不支持匹配子路径，如果想匹配子路径需要使用/**
3.Header 属性匹配 Header Route Predicate 接受两个参数：一个 header 中属性名称和一个正则表达式，这个属性值和正则表达式匹配则执行。
- Header=X-Request-Id, \d+ 这样配置，则只有header请求头中有X-Request-Id属性，并且属性值为数值的时候才匹配路由。
4.Cookie 匹配 Cookie Route Predicate 可以接收两个参数，一个是 Cookie name ,一个是正则表达式，路由规则会通过获取对应的 Cookie name 值和正则表达式去匹配，如果匹配上就会执行路由，如果没有匹配上则不执行。- Cookie=chocolate, ch.p
5.请求方式匹配 可以通过是 POST、GET、PUT、DELETE 等不同的请求方式来进行路由，支持一个或多个参数。- Method=GET,POST
6.请求 ip 地址匹配，在 CIDR 表示法中，IP 地址后面跟着斜杠和一个数字，斜杠后的数字表示子网掩码位数。
192.168.1.1/24 表示一个 CIDR 格式的 IP 地址范围，其中 /24 表示子网掩码。这个范围包括从 192.168.1.1 到 192.168.1.254 的所有 IP 地址。例如，如果请求的远端地址为192.168.1.10，则此路由匹配。如果你只想匹配单个ip地址，那么可以使用ip/32来表示，ip/32表示只有该 IP 地址本身才会匹配，其他任何 IP 地址都不会与之匹配。
7.时间匹配，我们可以指定某个时间前后的请求匹配路由。After ：匹配在指定日期时间之后发生的请求。某个日期之前，使用Before。
- After=2017-01-20T17:42:47.789-07:00[America/Denver]
8.组合匹配 多个 Predicates 可以同时存在于同一个路由，请求必须同时满足所有的条件才被这个路由匹配。