SpringCloud组件： GateWay整合Eureka转发服务请求

在上一篇文章Spring Cloud GateWay 路由转发规则介绍中咱们讲解了SpringCloud Gateway内部提供的断言、谓语，让咱们能够组合更精确的业务场景进行请求，既然SpringCloud GateWay担任了网关的角色，在以前Zuul能够经过服务名进行自动转发，SpringCloud Gateway是否能够实现自动转发呢？

初始化Gateway服务

Spring Cloud Gateway能够根据配置的断言、谓语进行知足条件转发，也能够自动同步服务注册中心的服务列表进行指定serviceId前缀进行转发，这里的serviceId是业务服务的spring.application.name配置参数。

SpringCloud 版本控制依赖

把SpringCloud的版本依赖添加到pom.xml内，以下所示：

//...
<properties>
  <java.version>1.8</java.version>
  <spring-cloud.version>Greenwich.SR1</spring-cloud.version>
</properties>
<!--Spring Cloud 版本控制-->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-dependencies</artifactId>
      <version>${spring-cloud.version}</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
//...
复制代码

咱们本章使用Eureka做为服务注册中心来完成服务请求转发讲解，须要把Spring Cloud Gateway网关项目做为一个Client注册到Eureka Server，先来看下添加的依赖，pom.xml以下所示：

//...
<dependencies>
  <!--Spring Cloud Gateway-->
  <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
  </dependency>
  <!--Eureka Client-->
  <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
  </dependency>
</dependencies>
//....
复制代码

接下来咱们须要开启Gateway服务注册中心的发现配置，开启后才能自动同步服务注册中心的服务列表，application.yml配置文件以下所示：

# 服务名称
spring:
 application:
 name: spring-cloud-gateway
  # 开启 Gateway 服务注册中心服务发现
 cloud:
 gateway:
 discovery:
 locator:
 enabled: true
# Eureka Server 配置
eureka:
 client:
 service-url:
 defaultZone: http://localhost:10000/eureka/
# 配置Gateway日志等级，输出转发细节信息
logging:
 level:
    org.springframework.cloud.gateway: debug
复制代码

配置参数解释以下所示：

• spring.application.name：服务名
• spring.cloud.gateway.discovery.locator.enabled：开启SpringCloud Gateway的注册中心发现配置，开启后可自动从服务注册中心拉取服务列表，经过各个服务的spring.application.name做为前缀进行转发，该配置默认为false。
• eureka.client.service-url.defaultZone：配置Eureka Server默认的空间地址
• logging.level.org.springframework.cloud.gateway：设置SpringCloud Gateway日志等级为debug，用于输出转发的细节日志，方便查看细节流程。

注册网关到Eureka

在入口类添加对应的注解，开启服务自动注册，以下所示：

@SpringBootApplication
@EnableDiscoveryClient
public class SpringCloudGatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringCloudGatewayApplication.class, args);
    }
}
复制代码

服务注册中心

对应上面网关配置的Eureka Server的地址，咱们须要添加对应的配置，pom.xml以下所示：

//...
<dependencies>
  <!--Eureka Server-->
  <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
  </dependency>
</dependencies>
//...
复制代码

添加依赖后对Eureka Server进行配置，配置文件application.yml以下所示：

# 服务名
spring:
 application:
 name: sample-eureka-server
# 端口号 
server:
 port: 10000

# Eureka 配置信息
eureka:
 client:
 service-url:
 defaultZone: http://localhost:${server.port}/eureka/
 fetch-registry: false
 register-with-eureka: false
复制代码

这里咱们修改默认的端口号为10000，为了匹配在网关项目的配置信息，至于fetch-registry、register-with-eureka能够去我以前的文章查看，SpringCloud组件：将服务提供者注册到Eureka集群

开启Eureka Server

咱们经过@EnableEurekaServer注解来开启服务，以下所示：

@SpringBootApplication
@EnableEurekaServer
public class EurekaServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(EurekaServerApplication.class, args);
    }
}
复制代码

网关、服务注册中心咱们都已经准备好了，下面咱们能够编写业务逻辑服务，来验证SpringCloud Gateway具体是否能够根据serviceId进行转发请求。

单服务

咱们简单编写一个GET请求地址，输出字符串信息，pom.xml添加依赖以下所示：

<dependencies>
  <!--Web-->
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  <!--Eureka Client-->
  <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
  </dependency>
</dependencies>
复制代码

配置文件application.yml以下所示：

# 服务名
spring:
 application:
 name: user-service
# 注册到Eureka
eureka:
 client:
 service-url:
 defaultZone: http://localhost:10000/eureka/
# 服务端口号
server:
 port: 9090

复制代码

配置该服务的服务名称为user-service，这里对应SpringCloud Gateway的serviceId。

注册服务到Eureka

@SpringBootApplication
@EnableDiscoveryClient
@RestController
public class UserServiceApplication {
    /** * logger instance */
    static Logger logger = LoggerFactory.getLogger(UserServiceApplication.class);

    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
        logger.info("「「「「「用户服务启动完成.」」」」」");
    }

    @GetMapping(value = "/index")
    public String index() {
        return "this is user index";
    }
}
复制代码

user-service提供了/index的请求地址，当访问时，会对应输出this is user index。

测试服务请求转发

接下来咱们进行验证，测试顺序以下所示：

第一步：启动Eureka Server

第二步：启动SpringCloud Gateway

启动成功后控制台会打印响应的注册到Eureka的日志信息，以下所示：

DiscoveryClient_SPRING-CLOUD-GATEWAY/192.168.1.56:spring-cloud-gateway: registering service...
Netty started on port(s): 8080
复制代码

SpringCloud Gateway内部经过Netty完成WebServer的请求转发。

第三步：启动user-service服务

启动成功后控制台打印相应注册日志，以下所示：

DiscoveryClient_USER-SERVICE/192.168.1.56:user-service:9090: registering service...
Tomcat started on port(s): 9090 (http) with context path ''
复制代码

第四步：测试访问

SpringCloud Gateway会每间隔30秒进行从新拉取服务列表后路由重定义操做，日志信息以下所示：

# Spring Cloud Gateway
RouteDefinition CompositeDiscoveryClient_SPRING-CLOUD-GATEWAY applying {pattern=/SPRING-CLOUD-GATEWAY/**} to Path
RouteDefinition CompositeDiscoveryClient_SPRING-CLOUD-GATEWAY applying filter {regexp=/SPRING-CLOUD-GATEWAY/(?<remaining>.*), replacement=/${remaining}} to RewritePath
RouteDefinition matched: CompositeDiscoveryClient_SPRING-CLOUD-GATEWAY
# User Service
RouteDefinition CompositeDiscoveryClient_USER-SERVICE applying {pattern=/USER-SERVICE/**} to Path
RouteDefinition CompositeDiscoveryClient_USER-SERVICE applying filter {regexp=/USER-SERVICE/(?<remaining>.*), replacement=/${remaining}} to RewritePath
RouteDefinition matched: CompositeDiscoveryClient_USER-SERVICE
复制代码

经过上面的日志信息咱们已经能够推断出SpringCloud Gateway映射spring.application.name的值做为服务路径前缀，不过是大写的，预计咱们能够经过http://localhost:8080/USER-SERVICE/index访问到对应的信息。

访问测试以下：

~ curl http://localhost:8080/USER-SERVICE/index
this is user index
复制代码

经过网关访问具体服务的格式：http://网关IP:网关端口号/serviceId/**

多服务的负载均衡

若是Eureka Server上有两个相同serviceId的服务时，SpringCloud Gateway会自动完成负载均衡。

复制一个user-service服务实例，修改服务端口号，以下所示：

# 服务名称
spring:
 application:
 name: user-service
# Eureka Server
eureka:
 client:
 service-url:
 defaultZone: http://localhost:10000/eureka/
# 服务端口号
server:
 port: 9091
复制代码

在复制的项目内使用相同的spring.application.name保持serviceId一致，只作端口号的修改，为了区分GateWay完成了负载均衡，咱们修改/index请求的返回内容以下所示：

@GetMapping(value = "/index")
public String index() {
  return "this is user lb index";
}
复制代码

访问http://localhost:8080/USER-SERVICE/index，输出内容以下所示：

this is user lb index
this is user index
this is user lb index
this is user index
...
复制代码

总结

经过本章的讲解，咱们已经对SpringCloud Gateway的转发有一个简单的理解，经过从服务注册中心拉取服务列表后，自动根据serviceId映射路径前缀，同名服务多实例时会自动实现负载均衡。

源码位置

Gitee：gitee.com/hengboy/spr…

ApiBoot：gitee.com/hengboy/api…、github.com/hengboy/api…