摘要：原文摘要本篇文章主要介紹了什么是，并基于的版本編寫一個的入門案例，即基本代理的路由轉發配置。作為生態系中的網關，目標是替代，其不僅提供統一的路由方式，并且基于鏈的方式提供了網關基本的功能，例如安全，監控埋點，和限流等。

原文:http://xujin.org/sc/gw/gw-01/

摘要:本篇文章主要介紹了什么是Spring Cloud Gateway，并基于Spring Cloud Gateway的Finchley.M8版本編寫一個Spring Cloud Gateway的入門案例，即基本代理的路由轉發配置。

Spring Cloud Gateway是Spring官方基于Spring 5.0，Spring Boot 2.0和Project Reactor等技術開發的網關，Spring Cloud Gateway旨在為微服務架構提供一種簡單而有效的統一的API路由管理方式。Spring Cloud Gateway作為Spring Cloud生態系中的網關，目標是替代Netflix ZUUL，其不僅提供統一的路由方式，并且基于Filter鏈的方式提供了網關基本的功能，例如：安全，監控/埋點，和限流等。

配置Spring Cloud Gateway的相關Maven依賴

    
        ch18-1
        cn.springcloud.book
        1.0-SNAPSHOT
    

    4.0.0

    ch18-1-gateway
    jar

    ch18-1-gateway
    http://springcloud.cn

    
        Finchley.M8
    

    
        
            
                org.springframework.cloud
                spring-cloud-dependencies
                ${spring-cloud.version}
                pom
                import
            
        
    

    
        
            org.springframework.boot
            spring-boot-starter-actuator
        
        
            org.springframework.cloud
            spring-cloud-starter-gateway
        
    
    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

    
        
            spring-snapshots
            Spring Snapshots
            https://repo.spring.io/snapshot
            
                true
            
        
        
            spring-milestones
            Spring Milestones
            https://repo.spring.io/milestone
            
                false
            
        
    

    
        
            spring-snapshots
            Spring Snapshots
            https://repo.spring.io/snapshot
            
                true
            
        
        
            spring-milestones
            Spring Milestones
            https://repo.spring.io/milestone
            
                false
            
        
    

SpringCloudGatewayApplication.java，代碼如下所示:

package cn.springcloud.book.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
public class SpringCloudGatewayApplication {


    @Bean
    public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
        return builder.routes()
                //basic proxy
                .route(r -> r.path("/baidu")
                        .uri("http://baidu.com:80/")
                ).build();
    }

    public static void main(String[] args) {
        SpringApplication.run(SpringCloudGatewayApplication.class, args);
    }
}

server:
  port: 8080
spring:
  application:
    name: spring-cloud-gateway

spring:
  cloud:
    gateway:
      routes:
      - id: xujin_route
        uri: http://www.xujin.org:80/
        predicates:
        - Path=/xujin

logging:
  level:
    org.springframework.cloud.gateway: TRACE
    org.springframework.http.server.reactive: DEBUG
    org.springframework.web.reactive: DEBUG
    reactor.ipc.netty: DEBUG

Spring Cloud Gateway提供了兩種配置路由規則的方法

第一:通過@Bean自定義RouteLocator

@Bean
public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
    return builder.routes()
            //basic proxy
            .route(r -> r.path("/baidu")
            .uri("http://baidu.com:80/")
            ).build();
}

第二:通過屬于文件或者yml文件配置

spring:
  cloud:
    gateway:
      routes:
      - id: xujin_route
        uri: http://www.xujin.org:80/
        predicates:
        - Path=/xujin

PS,以上兩種方式等同。

@Bean
public RouteLocator routingConfig() {
    return Routes.locator()
      .route("xujin_route")
      .uri("http://xujin.org")
      .predicate(host("**.xujin.org"))
      .build();
}

溫馨提示，上面這種寫法是基于Spring Cloud Gateway FM4的版本，相關代碼已廢棄，目前Spring Cloud Gateway將會在FM9之后Realese。

訪問http://localhost:8080/baidu,路由轉發到http://www.baidu.com

訪問http://localhost:8080/xujin,路由轉發到[http://xujin.orgyml

](http://xujin.org)

@Bean
    public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
        return builder.routes()
                //basic proxy
                .route(r -> r.path("/baidu")
                        .uri("http://baidu.com:80/")
                ).build();
    }

spring:
  cloud:
    gateway:
      routes:
      - id: xujin_route
        uri: http://www.xujin.org:80/
        predicates:
        - Path=/xujin