Spring Cloud Gateway 是一個(gè)基于 Spring Boot 2.x 的可擴(kuò)展的微服務(wù)網(wǎng)關(guān)，它提供了一種簡單且靈活的方式來構(gòu)建微服務(wù)架構(gòu)中的 API 網(wǎng)關(guān)。Spring Cloud Gateway 專注于提供 API 網(wǎng)關(guān)所需的核心功能，如路由、斷路器、限流等，同時(shí)支持自定義擴(kuò)展點(diǎn)，以便用戶能夠根據(jù)自身需求進(jìn)行定制。

下面我們將通過一個(gè)簡單的示例來詳細(xì)介紹 Spring Cloud Gateway 的使用。

添加依賴

首先，在我們的項(xiàng)目中添加 Spring Cloud Gateway 的依賴。在 pom.xml 文件中添加如下依賴：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
    <version>3.1.3</version>
</dependency>

這里我們使用的是 Spring Cloud Gateway 的 3.1.3 版本。

配置路由規(guī)則

在 src/main/resources 目錄下創(chuàng)建一個(gè) application.yml 文件，用于配置路由規(guī)則。例如，我們定義兩個(gè)服務(wù) service-a 和 service-b，并設(shè)置相應(yīng)的路由規(guī)則：

spring:
  cloud:
    gateway:
      routes:
        - id: route_a
          uri: http://service-a/api
          predicates:
            - Path=/api/a/**
        - id: route_b
          uri: http://service-b/api
          predicates:
            - Path=/api/b/**

在這個(gè)例子中，我們定義了兩個(gè)路由規(guī)則。route_a 規(guī)則將 /api/a/** 路徑的請(qǐng)求轉(zhuǎn)發(fā)到 http://service-a/api，route_b 規(guī)則將 /api/b/** 路徑的請(qǐng)求轉(zhuǎn)發(fā)到 http://service-b/api。

自定義擴(kuò)展點(diǎn)

Spring Cloud Gateway 提供了許多內(nèi)置的擴(kuò)展點(diǎn)，允許用戶根據(jù)需要進(jìn)行定制。例如，我們可以實(shí)現(xiàn)org.springframework.cloud.gateway.handler.predicate.PredicateFactory 接口來定義新的路由規(guī)則條件。

這里我們創(chuàng)建一個(gè)自定義的路由規(guī)則條件 MyCustomPredicate，用于判斷請(qǐng)求是否滿足某些特定的條件：

package com.example.myservice.gateway;

import org.springframework.cloud.gateway.handler.predicate.PredicateFactory;
import org.springframework.cloud.gateway.handler.predicate.RoutePredicate;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.cloud.gateway.route.builder.routes.RouteLocator;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.server.reactive.ServerHttpRequest;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;

@Configuration
public class MyGatewayConfig {
    @Bean
    public RoutePredicate myCustomPredicate(PredicateFactory predicateFactory) {
        return predicateFactory.fromState(ServerWebExchange::getRequest, ServerHttpRequest::getURI)
                ::equals(ServerHttpRequest::getURI) // 這里簡單判斷請(qǐng)求的 URI 是否與目標(biāo) URI 相等
                .then(Mono::just); // 如果相等，返回 Mono<Boolean> 類型的 true
    }
}

在這個(gè)例子中，我們定義了一個(gè) MyCustomPredicate 類，實(shí)現(xiàn)了 RoutePredicate 接口。在 myCustomPredicate 方法中，我們通過ServerWebExchange::getRequest 和 ServerHttpRequest::getURI 方法獲取請(qǐng)求的信息，并進(jìn)行簡單的判斷。如果請(qǐng)求的 URI 與目標(biāo) URI 相等，返回 Mono<Boolean> 類型的 true。這樣，我們就可以將這個(gè)條件應(yīng)用于路由規(guī)則中。

啟動(dòng)網(wǎng)關(guān)

在完成上述配置后，我們可以啟動(dòng) Spring Cloud Gateway 網(wǎng)關(guān)。啟動(dòng)方法與普通的 Spring Boot 應(yīng)用類似，只需運(yùn)行 mvn spring-boot:run 命令即可。

Spring Cloud Gateway 啟動(dòng)后，會(huì)監(jiān)聽默認(rèn)的端口 8080。如果需要修改端口號(hào)，可以在 application.yml 文件中設(shè)置 server.port 屬性。

路由測(cè)試

我們可以通過發(fā)送 HTTP 請(qǐng)求來測(cè)試路由規(guī)則是否生效。例如，可以借助 Postman 或curl命令來進(jìn)行測(cè)試。

對(duì)于上述示例中的路由規(guī)則，我們可以分別發(fā)送以下請(qǐng)求：

• 請(qǐng)求 route_a 路由規(guī)則：

curl -X GET http://localhost:8080/api/a/hello

• 請(qǐng)求 route_b 路由規(guī)則：

curl -X GET http://localhost:8080/api/b/hello

如果一切正常，你應(yīng)該能夠分別獲得來自 service-a 和 service-b 的響應(yīng)結(jié)果。

自定義擴(kuò)展點(diǎn)使用

在上述示例中，我們創(chuàng)建了一個(gè)自定義的路由規(guī)則條件 MyCustomPredicate。要使用這個(gè)條件，我們需要在 application.yml 文件中添加以下配置：

spring:
  cloud:
    gateway:
      routes:
        - id: route_with_custom_predicate
          uri: http://service-a/api
          predicates:
            - MyCustomPredicate=true

在這個(gè)例子中，我們創(chuàng)建了一個(gè)新的路由規(guī)則route_with_custom_predicate，并添加了 MyCustomPredicate=true 條件。這意味著只有當(dāng)請(qǐng)求滿足 MyCustomPredicate 條件時(shí)，才會(huì)轉(zhuǎn)發(fā)請(qǐng)求到目標(biāo)服務(wù)。

日志與監(jiān)控

Spring Cloud Gateway 還提供了豐富的日志和監(jiān)控功能。你可以通過配置 logging.level.* 和 management.endpoint.* 等屬性來啟用并定制日志和監(jiān)控行為。例如，在 application.yml 文件中添加以下配置：

logging:
  level:
    root: INFO
management:
  endpoint:
    health:
      show-details: always

這樣，你就能在日志中看到更詳細(xì)的路由、斷路器、限流等信息，并可以通過 /health 接口查看網(wǎng)關(guān)的健康狀態(tài)。