网关服务Spring Cloud Gateway（二）

上一篇文章服务网关 Spring Cloud GateWay 初级篇，介绍了 Spring Cloud Gateway 的相关术语、技术原理，以及如何快速使用 Spring Cloud Gateway。这篇文章咱们继续学习 Spring Cloud Gateway 的高级使用方式，好比如何配置服务中心来使用，如何使用熔断、限流等高级功能。

注册中心

上篇主要讲解了网关代理单个服务的使用语法，在实际的工做中，服务的相互调用都是依赖于服务中心提供的入口来使用，服务中心每每注册了不少服务，若是每一个服务都须要单独配置的话，这将是一份很枯燥的工做。Spring Cloud Gateway 提供了一种默认转发的能力，只要将 Spring Cloud Gateway 注册到服务中心，Spring Cloud Gateway 默认就会代理服务中心的全部服务，下面用代码演示。

准备服务和注册中心

在介绍服务网关 zuul 的使用时，提供了 spring-cloud-eureka 、spring-cloud-producer 项目示例，本次演示咱们将两个项目版本升级到 Finchley.SR2 后继续演示使用。

spring-cloud-eureka(Eureka Server) 的 pom 文件更改，其它依赖包不变。

升级前：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-eureka-server</artifactId>
</dependency>

升级后：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>

spring-cloud-producer(Eureka Client)的 pom 文件更改。由于配置中心须要做为服务注册到注册中心，因此须要升级 Eureka Client，其余依赖没有变更。

升级前：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>

升级后：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

两个项目升级完依赖包后依次重启，访问注册中心地址 http://localhost:8000/ 便可看到名为 SPRING-CLOUD-PRODUCER的服务。

服务网关注册到注册中心

复制上一节的示例项目 cloud-gateway 从新命名为 cloud-gateway-eureka，添加 eureka 的客户端依赖包。

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

修改 application.yml 配置文件内容以下

server:
  port: 8888
spring:
  application:
    name: cloud-gateway-eureka
  cloud:
    gateway:
     discovery:
        locator:
         enabled: true
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8000/eureka/
logging:
  level:
    org.springframework.cloud.gateway: debug

配置说明：

• spring.cloud.gateway.discovery.locator.enabled：是否与服务注册于发现组件进行结合，经过 serviceId 转发到具体的服务实例。默认为 false，设为 true 便开启经过服务中心的自动根据 serviceId 建立路由的功能。
• eureka.client.service-url.defaultZone指定注册中心的地址，以便使用服务发现功能
• logging.level.org.springframework.cloud.gateway 调整相 gateway 包的 log 级别，以便排查问题

修改完成后启动 cloud-gateway-eureka 项目，访问注册中心地址 http://localhost:8000/ 便可看到名为 CLOUD-GATEWAY-EUREKA的服务。

测试

将 Spring Cloud Gateway 注册到服务中心以后，网关会自动代理全部的在注册中心的服务，访问这些服务的语法为：

http://网关地址：端口/服务中心注册 serviceId/具体的url

好比咱们的 spring-cloud-producer 项目有一个 /hello 的服务，访问此服务的时候会返回：hello world。

好比访问地址：http://localhost:9000/hello，页面返回：hello world!

按照上面的语法咱们经过网关来访问，浏览器输入：http://localhost:8888/SPRING-CLOUD-PRODUCER/hello 一样返回：hello world!证实服务网关转发成功。

咱们将项目 spring-cloud-producer 复制一份为 spring-cloud-producer-1，将/hello服务的返回值修改成 hello world smile !，修改端口号为 9001 ，修完完成后重启，这时候访问注册中心后台会发现有两个名为 SPRING-CLOUD-PRODUCER的服务。

在浏览器屡次访问地址：http://localhost:8888/SPRING-CLOUD-PRODUCER/hello，页面交替返回如下信息：

hello world!
hello world smile!

说明后端服务自动进行了均衡负载。

基于 Filter(过滤器) 实现的高级功能

在服务网关Zuul高级篇中大概介绍过 Filter 的概念。

Spring Cloud Gateway 的 Filter 的生命周期不像 Zuul 的那么丰富，它只有两个：“pre” 和 “post”。

• PRE： 这种过滤器在请求被路由以前调用。咱们可利用这种过滤器实现身份验证、在集群中选择请求的微服务、记录调试信息等。
• POST：这种过滤器在路由到微服务之后执行。这种过滤器可用来为响应添加标准的 HTTP Header、收集统计信息和指标、将响应从微服务发送给客户端等。

Spring Cloud Gateway 的 Filter 分为两种：GatewayFilter 与 GlobalFilter。GlobalFilter 会应用到全部的路由上，而 GatewayFilter 将应用到单个路由或者一个分组的路由上。

Spring Cloud Gateway 内置了9种 GlobalFilter，好比 Netty Routing Filter、LoadBalancerClient Filter、Websocket Routing Filter 等，根据名字便可猜想出这些 Filter 的做者，具体你们能够参考官网内容：Global Filters

利用 GatewayFilter 能够修改请求的 Http 的请求或者响应，或者根据请求或者响应作一些特殊的限制。 更多时候咱们会利用 GatewayFilter 作一些具体的路由配置，下面咱们作一些简单的介绍。

快速上手 Filter 使用

咱们以 AddRequestParameter GatewayFilter 来演示一下，如何在项目中使用 GatewayFilter，AddRequestParameter GatewayFilter 能够在请求中添加指定参数。

application.yml配置示例

spring:
  cloud:
    gateway:
      routes:
      - id: add_request_parameter_route
        uri: http://example.org
        filters:
        - AddRequestParameter=foo, bar

这样就会给匹配的每一个请求添加上foo=bar的参数和值。

咱们将以上配置融入到 cloud-gateway-eureka 项目中，完整的 application.yml 文件配置信息以下：

server:
  port: 8888
spring:
  application:
    name: cloud-gateway-eureka
  cloud:
    gateway:
     discovery:
        locator:
         enabled: true
     routes:
     - id: add_request_parameter_route
       uri: http://localhost:9000
       filters:
       - AddRequestParameter=foo, bar
       predicates:
         - Method=GET
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8000/eureka/
logging:
  level:
    org.springframework.cloud.gateway: debug

这里的 routes 手动指定了服务的转发地址，设置全部的 GET 方法都会自动添加foo=bar，http://localhost:9000 是 spring-cloud-producer 项目，咱们在此项目中添加一个 foo() 方法，用来接收转发中添加的参数 foo。

@RequestMapping("/foo")
public String foo(String foo) {
    return "hello "+foo+"!";
}

修改完成后重启 cloud-gateway-eureka、spring-cloud-producer 项目。访问地址http://localhost:9000/foo页面返回：hello null!，说明并无接受到参数 foo；经过网关来调用此服务，浏览器访问地址http://localhost:8888/foo页面返回：hello bar!，说明成功接收到参数 foo 参数的值 bar ,证实网关在转发的过程当中已经经过 filter 添加了设置的参数和值。

服务化路由转发

上面咱们使用 uri 指定了一个服务转发地址，单个服务这样使用问题不大，可是咱们在注册中心每每会使用多个服务来共同支撑整个服务的使用，这个时候咱们就指望能够将 Filter 做用到每一个应用的实例上，spring cloud gateway 工了这样的功能，只须要简单配置便可。

为了测试两个服务提供者是否都被调用，咱们在 spring-cloud-producer-1 项目中也一样添加 foo() 方法。

@RequestMapping("/foo")
public String foo(String foo) {
    return "hello "+foo+"!!";
}

为了和 spring-cloud-producer 中 foo() 方法有所区别，这里使用了两个感叹号。同时将 cloud-gateway-eureka 项目配置文件中的 uri 内容修改以下：

#格式为：lb://应用注册服务名
uri: lb://spring-cloud-producer

修改完以后，从新启动项目 cloud-gateway-eureka、spring-cloud-producer-1，浏览器访问地址:http://localhost:8888/foo页面交替出现：

hello bar!
hello bar!!

证实请求依据均匀转发到后端服务，而且后端服务均接收到了 filter 增长的参数 foo 值。

这里其实默认使用了全局过滤器 LoadBalancerClient ，当路由配置中 uri 所用的协议为 lb 时（以uri: lb://spring-cloud-producer为例），gateway 将使用 LoadBalancerClient 把 spring-cloud-producer 经过 eureka 解析为实际的主机和端口，并进行负载均衡。