#第一种：ws(websocket)方式: uri: ws://localhost:8888
#第二种：http方式: uri: http://localhost:8888/
#第三种：lb(注册中心中服务名字)方式: uri: lb://consumer
spring:
  cloud:
    gateway:
      routes:
         # 路由id,没有固定规则，建议配合服务名
        - id: consumer
          # 匹配后提供服务的路由地址
          # 需要注意的是uri的协议为lb，表示启用Gateway的负载均衡功能。lb://serviceName是spring cloud gateway在微服务中自动为我们创建的负载均衡uri。
          uri: lb://consumer
          predicates:
          # 断言：路径相匹配的进行路由
            - Path=/**

2.bean进行配置

@Configuration
public class GatewayConfig {
    @Bean
    public RouteLocator customerRouteLocator(RouteLocatorBuilder routeLocatorBuilder) {
        RouteLocatorBuilder.Builder routes = routeLocatorBuilder.routes();
        // 第一个参数是路由的唯一id
        routes.route("consumer",
                r -> r.path("/hello")
                        .uri("http://localhost:8888/hello")).build();
        return routes.build();
    }
}

3.动态路由

可以通过服务名进行转发，无需配置routes也可以转发

spring:
  application:
    name: gateway
  cloud:
    gateway:
      discovery:
        locator:
          #开启根据微服务名称自动转发
          enabled: true
          #小写
          lower-case-service-id: true

动态路由

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

形式：

lb://service-name

lb：uri 的协议，表示开启 Spring Cloud Gateway 的负载均衡功能。

service-name：服务名，Spring Cloud Gateway 会根据它获取到具体的微服务地址。

Predicate(断言)

Predicate 断言来实现 Route 路由的匹配规则。Predicate 是路由转发的判断条件，请求只有满足了 Predicate 的条件，才会被转发到指定的服务上进行处理；

特点

1.路由与断言的关系为：一对多，一个路由可以包含多个不同断言

2.一个请求想转发到指定的路由上，就必须同时匹配路由上的所有断言

3.当一个请求同时满足多个路由的断言条件时，请求只会被首个成功匹配的路由转发

常见断言

示例

配置文件 application.yml中添加配置内容

server:
  port: 9527  #端口号
spring:
  application:
    name: microServiceCloudGateway
  cloud:
    gateway: #网关路由配置
      routes:
        #将 micro-service-cloud-provider-dept-8001 提供的服务隐藏起来，不暴露给客户端，只给客户端暴露 API 网关的地址 9527
        - id: provider_dept_list_routh   #路由 id,没有固定规则，但唯一，建议与服务名对应
          uri: http://localhost:8001          #匹配后提供服务的路由地址
          predicates:
            #以下是断言条件，必选全部符合条件
            - Path=/dept/list/**               #断言，路径匹配 注意：Path 中 P 为大写
            - Method=GET #只能时 GET 请求时，才能访问

配置中在 spring.cloud.gateway.routes 下使用 predicates 属性，定义了以下两个断言条件：

- Path=/dept/list/*

-Method=GET

HTTP 请求同时满足以上所有的断言时，该请求才会被转发到指定的服务端中

Filter(过滤器)

出于安全方面的考虑，服务端提供的服务往往都会有一定的校验逻辑，例如用户登陆状态校验、签名校验等；微服务架构中，系统由多个微服务组成，所有这些服务都需要这些校验逻辑，此时我们就可以将这些校验逻辑写到Gateway的 Filter 过滤器中。

filter分类

Gateway 提供了以下两种类型的过滤器，可以对请求和响应进行精细化控制：

Pre 类型

这种过滤器在请求被转发到微服务之前可以对请求进行拦截和修改，例如参数校验、权限校验、流量监控、日志输出以及协议转换等操作。

Post 类型

这种过滤器在微服务对请求做出响应后可以对响应进行拦截和再处理，例如修改响应内容或响应头、日志输出、流量监控等。

网关过滤器

GatewayFilter 是 Gateway 网关中提供的一种应用在单个或一组路由上的过滤器。它可以对单个路由或者一组路由上传入的请求和传出响应进行拦截，并实现一些与业务无关的功能，比如登陆状态校验、签名校验、权限校验、日志输出、流量监控等

格式

    spring:
      cloud:
        gateway: 
          routes:
            - id: xxxx
              uri: xxxx
              predicates:
                - Path=xxxx
              filters:
                - AddRequestParameter=X-Request-Id,1024 #过滤器工厂会在匹配的请求头加上一对请求头，名称为 X-Request-Id 值为 1024
                - PrefixPath=/dept #在请求路径前面加上 /dept
                ……

Gateway 内置了多达 31 种 GatewayFilter，下表中列举了几种常用的网关过滤器及其使用示例：

示例

application.yml 中在添加一个动态路由：

- id: provider_dept_get_routh

        uri: lb://MICROSERVICECLOUDPROVIDERDEPT #使用服务名代替上面的具体带端口         predicates:

                - Path=/get/**

        filters:

                - PrefixPath=/dept #在请求路径上增加一个前缀 /dept

全局过滤器

GlobalFilter 是一种作用于所有的路由上的全局过滤器，通过它，我们可以实现一些统一化的业务功能，例如权限认证、IP 访问限制等。当某个请求被路由匹配时，那么所有的 GlobalFilter 会和该路由自身配置的 GatewayFilter 组合成一个过滤器链；

示例

1.新建一个名为 MyGlobalFilter 全局过滤器配置类

/**
* 自定义全局网关过滤器（GlobalFilter）
*/
@Component
@Slf4j
public class MyGlobalFilter implements GlobalFilter, Ordered {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        log.info("进入自定义的全局过滤器 MyGlobalFilter" + new Date());
        String uname = exchange.getRequest().getQueryParams().getFirst("uname");
        if (uname == null) {
            log.info("参数 uname 不能为 null！");
            exchange.getResponse().setStatusCode(HttpStatus.NOT_ACCEPTABLE);
            return exchange.getResponse().setComplete();
        }
        return chain.filter(exchange);
    }
    @Override
    public int getOrder() {
        //过滤器的顺序，0 表示第一个
        return 0;
    }
}

2.使用浏览器访问“http://eureka7001.com:9527/dept/list”，我们会发现访问报 406 错误