统一服务入口-Gateway（二）

GatewayFilter同Predicate类似，都是在配置文件application.yml中配置，每个过滤器的逻辑都是固定的.比如AddRequestParameterGatewayFilter Factory只需要在配置文件中写AddRequestParameter,就可以为所有的请求添加一个参数

快速上手

1.在application.yml中添加filter

bash 复制代码

server:
  port: 10030
spring:
  application:
    name: gateway
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
        namespace: b460e95c-d4b9-42a3-810f-cdf0051ce008
    gateway:
      metrics:
        enabled: true
      routes:
        - id: product-service   #路由规则id, 随便起, 不重复即可
          uri: lb://product-service/ #目标服务地址
          predicates:   #路由条件
            - Path=/product/**
            - After=2024-01-01T00:00:00.000+08:00[Asia/Shanghai]
          filters:
            - AddRequestParameter=userName, romised
        - id: order-service   #路由规则id, 随便起, 不重复即可
          uri: lb://order-service/ #目标服务地址
          predicates: #路由条件
            - Path=/order/**,/feign/**

该filter只添加在了product-service路由下，因此只对product-service路由生效

2.接收参数并打印

在product-service服务中接收请求的参数，并打印出来

java 复制代码

 @RequestMapping("/product")
 @RestController
 public class ProductController {
     @Autowired
     private ProductService productService;

     @RequestMapping("/{productId}")
    public ProductInfo getProductById(@PathVariable("productId") Integer 
productId, String userName){
         System.out.println("收到请求,Id:"+productId);
         System.out.println("userName:"+userName);
         return productService.selectProductById(productId);
     }
 }

3.测试

重启服务，访问请求，观察日志

http://127.0.0.1:10030/product/1001

控制台打印日志：

GatewayFilter说明

Spring Cloud Gateway提供的Filter特别多，下面列出一些常见的过滤器说明

详细可参考官方文档：GatewayFilter Factories :: Spring Cloud Gateway

Default Filters

前面的filter添加在指定路由下，所以只对当前路由生效，若需要对全部路由生效，可以使用：spring.cloud.gateway.default-filters

配置举例：

bash 复制代码

spring:
 cloud: 
  gateway:
   default-filters:
    - AddResponseHeader=X-Response-Default-Red, Default-Blue
    - PrefixPath=/httpbin

1.2GlobalFilter

GlobalFilter是Spring Cloud Gateway中的全局过滤器，它和GatewayFilter的作用是相同的.

GlobalFilter会应用到所有的路由请求上，全局过滤器通常用于实现与安全性，性能监控和日志记录等相关的全局功能.

Spring Cloud Gateway内置的全局过滤器也有很多，比如：

Gateway Metrics Filter:网关指标，提供监控指标
Forward Routing Filter:用于本地forword,请求不转发到下游服务器
LoadBalancer Client Filter:针对下游服务，实现负载均衡.
...

更多过滤器参考：Global Filters :: Spring Cloud Gateway

快速上手

1.添加依赖

XML 复制代码

 <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-actuator</artifactId>
 </dependency>

2.添加配置

bash 复制代码

spring:
 cloud:
  gateway:
   metrics:
    enabled: true
management:
 endpoints:
  web:
   exposure:
    include: "*"
 endpoint:
  health:
   show-details: always
  shutdown:
   enabled: true

3.测试

访问http://127.0.0.1:10030/actuator 显示所有监控的信息链接

2.过滤器执行顺序

一个项目中，既有GatewayFilter,又有GlobalFilter时，执行的先后顺序是什么呢?

请求路由后，网关会把当前项目中的GatewayFilter和GlobalFilter合并到一个过滤器链(集合)中，并进行排序，依次执行过滤器.

每一个过滤器都必须指定一个int类型的order值，默认值为0,表示该过滤的优先级.order值越小，优先级越高，执行顺序越靠前。

Filter通过实现Order接口或者添加@Order注解来指定order值.
SpringCloud Gateway提供的Filter由Spring指定.用户也可以自定义Filter,由用户指定.
当过滤器的order值一样时，会按照defaultFilter>GatewayFilter>GlobalFilter的顺序执行.

3.自定义GatewayFilter

自定义GatewayFilter,需要去实现对应的接口GatewayFilterFactory,Spring Boot默认帮我们实现的抽象类是AbstractGatewayFilterFactory ,我们可以直接使用.

3.1定义GatewayFilter

java 复制代码

@Slf4j
@Component
public class CustomGatewayFilterFactory extends AbstractGatewayFilterFactory<CustomConfig> implements Ordered {
    public CustomGatewayFilterFactory() {
        super(CustomConfig.class);
    }

    @Override
    public GatewayFilter apply(CustomConfig config) {
        return new GatewayFilter() {
            /**
             * ServerWebExchange: HTTP 请求-响应交互契约, 提供了对HTTP请求和响应的访问
             * GatewayFilterChain: 过滤器链
             * Mono: Reactor的核心类, 数据流发布者,Mono最多只能触发一个事件.可以把Mono用在异步完成任务时,发出通知
             * chain.filter(exchange)  执行请求
             * Mono.fromRunnable()  创建一个包含Runnable元素的数据流
             */
            @Override
            public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
                //Pre类型   执行请求   Post类型
                log.info("Pre Filter, config:{} ",config);  //Pre类型过滤器代码逻辑
                return chain.filter(exchange).then(Mono.fromRunnable(()->{
                    log.info("Post Filter....");  //Post类型过滤器代码逻辑
                }));
            }
        };
    }

    @Override
    public int getOrder() {
        return Ordered.LOWEST_PRECEDENCE;//配置优先级, order越⼤, 优先级越低
    }
}

针对这个Filter的配置，使用CustomConfig定义

java 复制代码

 @Data
 public static class CustomConfig {
     private String name;
 }

代码说明：

类名统一以GatewayFilterFactory结尾，因为默认情况下，过滤器的name会采用该定义类的前缀.这里的name=Custom(yml配置中使用)
apply方法中，同时包含Pre和Post过滤，then方法中是请求执行结束之后处理的
CustomConfig是一个配置类，该类只有一个属性name,和yml的配置对应
该类需要交给Spring管理，所以需要加@Component注解
getOrder表示该过滤器的优先级，值越大，优先级越低.

3.2配置过滤器

bash 复制代码

spring:
  application:
    name: gateway
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
        namespace: b460e95c-d4b9-42a3-810f-cdf0051ce008
    gateway:
      metrics:
        enabled: true
      routes:
        - id: product-service   #路由规则id, 随便起, 不重复即可
          uri: lb://product-service/ #目标服务地址
          predicates:   #路由条件
            - Path=/product/**
            - After=2024-01-01T00:00:00.000+08:00[Asia/Shanghai]
          filters:
            - AddRequestParameter=userName, romised
            - name: Custom    #过滤器名称
              args:
                name: test_custom

3.3测试

重启服务访问接口，观察日志：http://127.0.0.1:10030/product/1001

4.自定义GlobalFilter

GlobalFilter的实现比较简单，它不需要额外的配置，只需要实现GlobalFilter接口，自动会过滤所有的Filter

4.1定义GlobalFilter

java 复制代码

@Slf4j
@Component
public class CustomGlobalFilter implements GlobalFilter, Ordered {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        log.info("Pre Global Filter");
        return chain.filter(exchange).then(Mono.fromRunnable(()->{
            log.info("Post Global Filter...");
        }));
    }

    @Override
    public int getOrder() {
        return Ordered.LOWEST_PRECEDENCE;
    }
}

4.2测试

重启服务，访问接口，观察日志：http://127.0.0.1:10030/product/1001

从日志中,也可以看出来, 当GatewayFilter 和GlobalFilter 过滤器order⼀样时, 会先执行GatewayFilter