SpringCloudNetflix-服务网关SpringCloudGateway

盐渍橘皮

于 2023-07-24 08:30:00 发布

阅读量93

点赞数

文章标签： java 开发语言

本文链接：https://blog.csdn.net/m0_61826771/article/details/131887553

版权

服务网关SpringCloudGateway

1.基本概念

1.1.Zuul与Gateway

1.2.Spring Cloud Gataway的特点

1.3.Spring Cloud Gataway的核心概念

1.4.Spring Cloud Gateway的工作方式

2. Spring Cloud Gataway入门

根据path断言-Path Route Predicate Factory(重要)

4.Gateway 的 Filter 过滤器（重要）

4.1. 内置的Gateway filter

4.2.自定义Gateway Filter

4.3.自定义GlobalFilter

5.Gateway跨域配置

6.Gateway超时

服务网关SpringCloudGateway

1.基本概念

1.1.Zuul与Gateway

Zuul是Netflix的开源项目，Spring Cloud将其收纳成为自己的一个子组件。zuul用的是多线程阻塞模型，它本质上就是一个同步 Servlet，这样的模型比较简单，他都问题是多线程之间上下文切换是有开销的，线程越多开销就越大。线程池数量固定意味着能力接受的请求数固定，当后台请求变慢，面对大量的请求，线程池中的线程容易被耗尽，后续的请求会被拒绝。

在Zuul 2.0中它采用了 Netty 实现异步非阻塞编程模型，异步非阻塞模式对线程的消耗比较少，对线程上线文切换的消耗也比较小，并且可以接受更多的请求。它的问题就是线程模型比较复杂，要求深究底层原理需要花一些功夫。

Spring Cloud Gateway是Spring Cloud自己的产物，基于Spring 5 和Spring Boot 2.0 开发，Spring Cloud Gateway的出现是为了代替zuul,在Spring Cloud 高版本中没有对zuul 2.0进行集成，SpringCloud Gateway使用了高性能的Reactor模式通信框架Netty。

Spring Cloud Gateway 的目标，不仅提供统一的路由方式，并且基于 Filter 链的方式提供了网关基本的功能，例如：安全，监控/指标，和限流。

所以说其实Gateway和zuul 2.0差别不是特别大，都是采用Netty高性能通信框架，性能都挺不错。

1.2.Spring Cloud Gataway的特点

在Spring Cloud官方定义了SpringCloud Gateway 的如下特点：

基于 Spring 5，Project Reactor , Spring Boot 2.0
默认集成 Hystrix 断路器
默认集成 Spring Cloud DiscoveryClient (EurekaClient)
Predicates 和 Filters 作用于特定路由，易于编写的 Predicates 和 Filters
支持动态路由、限流、路径重写

1.3.Spring Cloud Gataway的核心概念

Spring Cloud Gataway有几个核心组成：

Filter（过滤器）：

Spring Cloud Gateway的Filter和Zuul的过滤器类似，可以在请求发出前后进行一些业务上的处理 ,这里分为两种类型的Filter，分别是Gateway Filter网关filter和Global Filter全局Filter, 他们的区别在后续会讲到。

Route（路由）：

网关配置的基本组成模块，和Zuul的路由配置模块类似。一个Route模块由一个 ID，一个目标 URI，一组断言和一组过滤器定义。如果断言为真，则路由匹配，目标URI会被访问。说白了就是把url请求路由到对应的资源(服务)，或者说是一个请求过来Gateway应该怎么把这个请求转发给下游的微服务，转发给谁。

Predicate（断言/url判断）：

这是一个 Java 8 的 Predicate，可以使用它来匹配来自 HTTP 请求的任何内容，例如 headers 或参数。断言的输入类型是一个 ServerWebExchange。简单理解就是处理HTTP请求的匹配规则，在什么样的请情况下才能命中资源继续访问。

1.4.Spring Cloud Gateway的工作方式

Spring Cloud Gateway 的工作原理跟 Zuul 的差不多，最大的区别就是 Gateway 的 Filter 只有 pre 和 post 两种，下面是官方的执行流程图：

客户端向Spring Cloud Gateway发出请求。如果网关处理程序映射确定请求与路由匹配，则将其发送到网关Web处理程序。该处理程序通过特定于请求的过滤器链来运行请求。筛选器由虚线分隔的原因是，筛选器可以在发送代理请求之前和之后运行逻辑。所有“前置”过滤器逻辑均被执行。然后发出代理请求。发出代理请求后，将运行“后”过滤器逻辑。

2. Spring Cloud Gataway入门

2.1.创建工程导入依赖

工程名：springcloud-gateway-server-1110 ，导入gataway基础依赖

<!--服务注册与发现-->
 <dependency>
     <groupId>org.springframework.cloud</groupId>
     <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
 </dependency>
<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>

2.2.主配置类

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

2.3.yml配置

#注册到EurekaServer
eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:10010/eureka/
  instance:
    instance-id: server-gateway #实例id
spring:
  application:
    name: server-gateway #服务名
  cloud:
    gateway:
      httpclient:
        connect-timeout: 5000
        response-timeout: 5s
      discovery:
        locator:
          enabled: false #开放服务名访问方式
          lower-case-service-id: true #服务名小写
      routes:
        - id: server-user #指定服务名
          uri: lb://server-user #去注册中心找这个服务名
          predicates: #断言，匹配访问的路径
            - Path=/user/**    #服务访问路径,如果请求路径包含ueser，请求路径就会路由给lb://server-user
          filters:
            - StripPrefix=1    #请求转发的时候会去掉 /user访问路径 http://localhost:10060/user/user/1
        - id: server-order #指定服务名
          uri: lb://server-order #去注册中心找这个服务名
          predicates: #断言，匹配访问的路径
            - Path=/server/order/**    #服务访问路径,如果请求路径包含ueser，请求路径就会路由给lb://server-order
          filters:
            - StripPrefix=2    #请求转发的时候会去掉 /order访问路径 http://localhost:10060/server/order/order/1
      globalcors: #跨域配置
        cors-configurations:
          '[/**]':
            allowedOrigins: "*" #允许的站点
            allowedMethods: #允许的请求方式
              - GET
              - POST
              - DELETE
              - PUT
              - HEAD
              - CONNECT
              - TRACE
              - OPTIONS
            allowedHeaders: "*"

server:
  port: 10060

这里除了要注册到Eureak以外，还需要配置Gataway的路由

spring.cloud.gateway.discovery.locator.enabled=false: 不开放服务名访问方式
spring.cloud.gateway.discovery.locator.lower-case-service-id: true 忽略服务名大小写，大写小写都可以匹配
spring.cloud.gateway.routes.id : 指定了路由的服务名，可以自己定义
spring.cloud.gateway.routes.uri=lb://user-server : 去注册中心找服务，采用负载均衡的方式请求。其实就是找要调用的服务。
spring.cloud.gateway.routes.predicates: 断言，这里使用的Path=/user/**，即匹配访问的路径如果匹配/user/就可以将请求路由(分发)到user-server这个服务上。
spring.cloud.gateway.routes.filters :这里使用StripPrefix=1主要是处理前缀 /user ,访问目标服务的时候会去掉前缀访问。这个需要根据url情况来定义。

2.5.访问测试

启动注册中心，启动用户服务，启动网关访问：http://localhost:1110/user/user/1,请求将会打到用户服务上，并返回用户数据。

3. Predicate断言工厂

3.1.什么是断言工厂

什么是断言工程，在Spring Cloud Gateway官方文档有如下解释：

Spring Cloud Gateway将路由作为Spring WebFlux HandlerMapping基础架构的一部分进行匹配。Spring Cloud Gateway包括许多内置的路由断言工厂。所有这些断言都与HTTP请求的不同属性匹配。您可以将多个路由断言工厂与逻辑and语句结合使用。

这里不难理解，其实断言工厂就是用来判断http请求的匹配方式。比如我们再上面案例中配置的：“Path=/user/**” ，就是使用的是 “Path Route Predicate Factory” 路径匹配工厂，意思是http请求的资源地址必须是 /user 才会被匹配到对应的路由，然后继续执行对应的服务获取资源。

在Spring Cloud Gateway中，针对不同的场景内置的路由断言工厂，比如

Query Route Predicate Factory：根据查询参数来做路由匹配
RemoteAddr Route Predicate Factory：根据ip来做路由匹配
Header Route Predicate Factory：根据请求头中的参数来路由匹配
Host Route Predicate Factory：根据主机名来进行路由匹配
Method Route Predicate Factory ：根据方法来路由匹配
Cookie Route Predicate Factory：根据cookie中的属性值来匹配
Before Route Predicate Factory：指定时间之间才能匹配
After Route Predicate Factory：指定时间之前才能匹配
Weight Route Predicate Factory：根据权重把流量分发到不同的主机

根据path断言-Path Route Predicate Factory(重要)

spring:
  cloud:
    gateway:
      routes:
        - id: server-user #指定服务名
          uri: lb://server-user #去注册中心找这个服务名
          predicates: #断言，匹配访问的路径
            - Path=/user/**    #服务访问路径,如果请求路径包含ueser，请求路径就会路由给lb://server-user
          filters:
            - StripPrefix=1    #请求转发的时候会去掉 /user访问路径 http://localhost:10060/user/user/1
        - id: server-order #指定服务名
          uri: lb://server-order #去注册中心找这个服务名
          predicates: #断言，匹配访问的路径
            - Path=/server/order/**    #服务访问路径,如果请求路径包含ueser，请求路径就会路由给lb://server-order
          filters:
            - StripPrefix=2    #请求转发的时候会去掉 /order访问路径 http://localhost:10060/server/order/order/1

4.Gateway 的 Filter 过滤器（重要）

Gateway的Filter的zuul的Filter有相似之处，与zuul不同的是，Gateway的filter从生命周期上可以为“pre”和“post”类型。根据作用范围可分为针对于单个路由的gateway filter，和针对于所有路由的Global Filer。

4.1. 内置的Gateway filter

针对单个路由的Filter, 它允许以某种方式修改HTTP请求或HTTP响应。过滤器可以作用在某些特定的请求路径上。Gateway内置了很多的GatewayFilter工厂。如果要使用这些Filter只需要在配置文件配置GatewayFilter Factory的名称。下面拿一个内置的Gateway Filter举例：

AddRequestHeader GatewayFilter Factory 该Filter是Gateway内置的，它的作用是在请求头加上指定的属性。配置如下：

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

在spring.cloud.gateway.routes.filters配置项配置了一个AddRequestHeader ,他是“AddRequestHeader GatewayFilter Factory”的名称，意思是在请求头中添加一个“X-Request-red”的属性，值为blue 。

其他的Filter可以去看 AbstractGatewayFilterFactory 的实现类。

更多的内置的Filter，见官网文档

4.2.自定义Gateway Filter

在Spring Cloud Gateway自定义过滤器，过滤器需要实现GatewayFilter和Ordered这两个接口。我们下面来演示自定义filter计算请求的耗时。

public class RequestTimeFilter implements GatewayFilter, Ordered {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        ServerHttpRequest request = exchange.getRequest();
        //创建时间:开始时间
        long startTime = new Date().getTime();

        return chain.filter(exchange).then(
                Mono.fromRunnable(()->{
                    //代码执行到这，代表已经返回结果
                    //创建时间:结束时间
                    long endTime = new Date().getTime();
                    //耗时
                    long spendTime = endTime - startTime;
                    System.out.println("请求url："+exchange.getRequest().getURI()+",耗时："+spendTime);
                })
        );

    }

    @Override
    public int getOrder() {
        //该filter的排序值越小，执行越靠前
        return 0;
    }
}

提示： getOrder返回filter的优先级，越大的值优先级越低，在filterI方法中计算了请求的开始时间和结束时间

最后我们还需要把该Filter配置在对应的路由上，配置如下：

@Configuration
public class FilterConfig {

    //配置Filter作用于那个访问规则上
    @Bean
    public RouteLocator customerRouteLocator(RouteLocatorBuilder builder) {

        return builder.routes().route(r -> r.path("/server/user/**")
                //去掉2个前缀
                        .filters(f -> f.stripPrefix(2)
                        .filter(new RequestTimeFilter())
                        .addResponseHeader("X-Response-test", "test"))
                        .uri("lb://server-user")
                        .order(0)
                        .id("test-RequestTimeFilter")
                ).build();
    }
}

提示：这里将 RequestTimeFilter 添加到 “/user/**”这里路由上，当请求包含/user就会触发Filter的执行。

4.3.自定义GlobalFilter

GlobalFilter:全局过滤器，不需要在配置文件中配置，作用在所有的路由上，最终通过GatewayFilterAdapter包装成GatewayFilterChain可识别的过滤器，它为请求业务以及路由的URI转换为真实业务服务的请求地址的核心过滤器，不需要配置，系统初始化时加载，并作用在每个路由上。这里我们模拟了一个登陆检查的Filter.

@Component
public class CheckLoginGlobalFilter implements GlobalFilter, Ordered {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        //拿到请求对象
        ServerHttpRequest request = exchange.getRequest();
        //响应请求对象
        ServerHttpResponse response = exchange.getResponse();
        //拿到请求头中的token
        List<String> tokens = request.getHeaders().get("token");
        if (null==tokens||tokens.size()==0){
            //没有token就返回异常
            DataBuffer buffer = null;
            try {
                byte[] bytes = "请去登录".getBytes("utf-8");
                buffer = response.bufferFactory().wrap(bytes);

                //设置完成相应，不会继续执行后面的filter
                //response.setComplete();
                response.setStatusCode(HttpStatus.UNAUTHORIZED);
                response.getHeaders().add("Content-Type","application/json;charset=UTF-8");
            } catch (UnsupportedEncodingException e) {
                e.printStackTrace();
            }

            //把结果写给客户端
            return response.writeWith(Mono.just(buffer));
        }
        //有就放行
        return chain.filter(exchange);
    }

    @Override
    public int getOrder() {
        return 0;
    }
}

如果请求头中没有 token ，就返回咩有权限的状态吗。

使用 buffer = response.bufferFactory().wrap(bytes) 构建响应内容，通过response.writeWith(Mono.just(buffer)); 把内容写给客户端。

5.Gateway跨域配置

所谓的跨域是因为浏览器的同源(同一个域)策略限制，其实就是同源策略会阻止一个域的javascript脚本和另外一个域的内容进行交互，在前后端分离的项目架构中就会出现跨域问题，因为Gateway 网关是微服务的访问入口，所以我们只需要在Gateway配置跨域即可：官方文档

spring:
  cloud:
    globalcors: #跨域配置
            cors-configurations:
              '[/**]':
                allowedOrigins: "https://docs.spring.io" #允许的站点
                allowedMethods:	#允许的请求方式
                  - GET
                  - POST
                  - DELETE
                  - PUT
                  - HEAD
                  - CONNECT
                  - TRACE
                  - OPTIONS
                allowHeaders:	#允许的请求头
                  - Content-Type

提示：运行跨域访问的站点：Spring | Home ，同时把常见的请求方式都开放。

6.Gateway超时

超时配置在微服务调用和数据读取的时候显得尤为重要，下面演示Gateway中的全局超时设置：

spring:
  cloud:
    gateway:
      httpclient:
        connect-timeout: 1000
        response-timeout: 5s

指定路由超时配置：

spring:
  cloud:
    gateway:
      routes:
      - id: per_route_timeouts
        uri: https://example.org
        predicates:
          - name: Path
            args:
              pattern: /delay/{timeout}
        metadata:
          response-timeout: 200
          connect-timeout: 200

盐渍橘皮

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
SpringCloudNetflix-服务网关SpringCloudGateway

什么是断言工程，在Spring Cloud Gateway官方文档有如下解释：Spring Cloud Gateway将路由作为Spring WebFlux HandlerMapping基础架构的一部分进行匹配。Spring Cloud Gateway包括许多内置的路由断言工厂。所有这些断言都与HTTP请求的不同属性匹配。您可以将多个路由断言工厂与逻辑and语句结合使用。这里不难理解，其实断言工厂就是用来判断http请求的匹配方式。比如我们再上面案例中配置的：“” ，就是使用的是 “
复制链接

扫一扫