本文介紹如何在 SpringCloud 項目中引入 Gateway 網(wǎng)關(guān)并完成網(wǎng)關(guān)服務的調(diào)用。Gateway 網(wǎng)關(guān)是一個在微服務架構(gòu)中起到入口和路由控制的關(guān)鍵組件。它負責處理客戶端請求，進行路由決策，并將請求轉(zhuǎn)發(fā)到相應的微服務。Gateway 網(wǎng)關(guān)還可以實現(xiàn)負載均衡、安全認證、日志記錄等功能，集中管理服務間的通信，提升整體系統(tǒng)的可維護性和安全性。通過 Gateway 網(wǎng)關(guān)，可以實現(xiàn)統(tǒng)一的訪問點，簡化客戶端與后端微服務之間的交互，同時也能夠更靈活地進行流量控制和監(jiān)控。

一、Gateway網(wǎng)關(guān)介紹

Gateway 網(wǎng)關(guān)是一個基于 Spring Cloud 的 API 網(wǎng)關(guān)服務，它提供了路由、過濾、監(jiān)控、日志等功能，用于統(tǒng)一管理和轉(zhuǎn)發(fā)微服務的請求流量。作為微服務架構(gòu)中的入口點，Gateway 網(wǎng)關(guān)可以實現(xiàn)負載均衡、安全認證、請求轉(zhuǎn)發(fā)等功能，提高了系統(tǒng)的安全性、可用性和可維護性。

網(wǎng)關(guān)的作用：

• 對用戶請求做身份認證、權(quán)限校驗
• 將用戶請求路由到微服務，并實現(xiàn)負載均衡
• 對用戶請求做限流

含 Gateway 網(wǎng)關(guān)項目結(jié)構(gòu)示意圖：

二、搭建Gateway網(wǎng)關(guān)

搭建Gateway網(wǎng)關(guān)需要以下步驟：

1、創(chuàng)建Gateway模塊

我們需要的開發(fā)環(huán)境中創(chuàng)建一個新的Spring Boot項目。
不會創(chuàng)建的可以參考我之前的文章：SpringCloud-創(chuàng)建多模塊項目

在SpringCloud項目上我們創(chuàng)建Gateway模塊，我命名為 springcloud-gateway。

2、引入SpringCloud-Gateway依賴

在 springcloud-gateway 項目的 pom.xml 文件中引入 Spring Cloud Gateway 的依賴。

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

3、配置路由規(guī)則

編輯 applicatin.yml，配置 Gateway 網(wǎng)關(guān)的路由規(guī)則，包括定義路由路徑、目標服務等信息。

server:
  port: 8090
spring:
  application:
    name: springcloud-gateway
  cloud:
    nacos:
      server-addr: localhost:8848
    gateway:
      discovery:
          locator:
              enabled: true # 開啟自動路由
      routes: # 網(wǎng)關(guān)路由配置
        - id: gateway-service # 路由id，自定義，唯一
          uri: lb://target # 路由的目標地址，lb表示負載均衡
          predicates: # 路由斷言，判斷請求是否符合路由規(guī)則
            - Path=/gateway/** # 要求請求路徑以/user/開頭，否則404
          filters:
            - StripPrefix=1 # 轉(zhuǎn)發(fā)請求時uri過濾掉/gateway

我們添加了動態(tài)路由，這里的動態(tài)路由屬性可以自動讓網(wǎng)關(guān)的轉(zhuǎn)發(fā)請求負載均衡。

這里我們用到了一個 Path 斷言，要求請求路徑以 /user/ 開頭，否則請求會返回404 (未找到服務) 。這里我們還用到了一個過濾器，讓網(wǎng)關(guān)轉(zhuǎn)發(fā)請求時，去掉前綴 /gateway。斷言工廠和過濾器的概念我們在下文進行詳細講解。

4、添加斷言

在Spring Cloud Gateway中，斷言（Predicate）用于定義請求匹配的條件，從而決定是否應用某個過濾器鏈。以下是一些常見的Gateway斷言種類和相應的示例：

下面來舉個例子：

server:
  port: 8090
spring:
  application:
    name: springcloud-gateway
  cloud:
    nacos:
      server-addr: localhost:8848
    gateway:
      discovery:
          locator:
              enabled: true # 開啟自動路由
      routes:
        - id: gateway-service
          uri: lb://target
          predicates:
            - Header=Authorization, Bearer 831B175-D251501-31A3F301-711636-9CAE

這里用到的最常用的 Header 斷言中的鑒權(quán)斷言，要求訪問網(wǎng)關(guān)的請求必須在請求頭里帶有 <Authorization, Bearer 831B175-D251501-31A3F301-711636-9CAE> 的鑒權(quán)碼，如果沒有鑒權(quán)碼或者鑒權(quán)碼不匹配，則返回 404。

5、添加過濾器

Spring Cloud Gateway提供了豐富的過濾器種類，這些過濾器用于在請求進入網(wǎng)關(guān)或響應離開網(wǎng)關(guān)時執(zhí)行各種操作。以下是一些常見的Gateway過濾器種類：

這些過濾器可以按照需求進行組合和配置，使得開發(fā)者可以在Gateway中實現(xiàn)各種復雜的請求和響應處理邏輯。通過合理配置過濾器，可以實現(xiàn)日志記錄、認證授權(quán)、請求重試、熔斷器等功能，提高網(wǎng)關(guān)的靈活性和可擴展性。

下面我們來舉個例子：

server:
  port: 8090
spring:
  application:
    name: springcloud-gateway
  cloud:
    nacos:
      server-addr: localhost:8848
    gateway:
      discovery:
          locator:
              enabled: true # 開啟自動路由
      routes:
        - id: gateway-service
          uri: lb://target
          predicates:
            - Path=/gateway/**
          filters:
            - StripPrefix=1
            - AddRequestHeader=test_header, damon0806

這里可以看到，我們在 routes（網(wǎng)關(guān)路由）下配置了 filters（過濾器）。

• StripPrefix=1：表示從請求的URI中去除前綴的數(shù)量。在這里，1 表示去除兩級路徑的前綴。例如，如果原始請求是 /path1/rest-of-the-uri，使用此配置后，轉(zhuǎn)發(fā)到后端的請求 URI 將是 /rest-of-the-uri。
• AddRequestHeader=test_header, damon0806：表示在請求頭中添加一個自定義的頭部。具體來說，它添加了一個名為 test_header 的頭部，其值為 damon0806。這可以用于在請求發(fā)送到后端服務時傳遞額外的信息或標識。

6、啟動網(wǎng)關(guān)服務

編寫 springcloud-gateway 的啟動類，啟動 Gateway 網(wǎng)關(guān)服務，使其開始監(jiān)聽和轉(zhuǎn)發(fā)請求。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class SpringcloudGatewayApplication {
	public static void main(String[] args) {
		SpringApplication.run(SpringcloudGatewayApplication.class, args);
	}
}

7、測試路由

可以使用 Postman 等接口測試工具發(fā)送請求，測試 Gateway 網(wǎng)關(guān)是否能夠正確轉(zhuǎn)發(fā)請求到相應的微服務，以及斷言工廠或者過濾器是否實現(xiàn)。

三、Gatway網(wǎng)關(guān)的作用

Gateway 網(wǎng)關(guān)作為微服務架構(gòu)中的入口點，扮演著關(guān)鍵的角色。

其作用主要體現(xiàn)在以下幾個方面：

Gateway網(wǎng)關(guān)在微服務架構(gòu)中承擔了集中處理、管理和保護服務的責任，通過提供統(tǒng)一的入口和處理機制，使得微服務系統(tǒng)更加穩(wěn)定、靈活和易于維護。

四、Gateway網(wǎng)關(guān)服務的調(diào)用

下面是前端 Ajax 調(diào)用網(wǎng)關(guān)服務的實例：

前端 JavaScript 代碼：

$.ajax({
    type: "POST",
    url: "http://localhost:8090/gateway/getUserList",
    data: {},
    dataType: 'json'
});

網(wǎng)關(guān)配置如下：

server:
  port: 8090
spring:
  application:
    name: springcloud-gateway
  cloud:
    nacos:
      server-addr: localhost:8848
    gateway:
      discovery:
          locator:
              enabled: true # 開啟自動路由
      routes:
        - id: gateway-service
          uri: lb://target
          predicates:
            - Path=/gateway/**
          filters:
            - StripPrefix=1
            - AddRequestHeader=test_header, damon0806

當我們執(zhí)行上述 Ajax 請求時，請求會被網(wǎng)關(guān)轉(zhuǎn)發(fā)到 lb://target/getUserList 上。

五、Gateway網(wǎng)關(guān)總結(jié)

Gateway網(wǎng)關(guān)作為微服務架構(gòu)中的關(guān)鍵組件，承擔著諸多重要任務，為整個系統(tǒng)提供了一種高效、可靠的服務入口。以下是對Gateway網(wǎng)關(guān)的總結(jié)：

綜上所述，Gateway網(wǎng)關(guān)在微服務架構(gòu)中扮演了不可或缺的角色，通過集中化管理、智能路由和強大的過濾器機制，為構(gòu)建高效、可擴展的微服務系統(tǒng)提供了有力支持。其優(yōu)勢在于簡化了開發(fā)、提高了系統(tǒng)的可維護性，并在面對復雜的微服務架構(gòu)時提供了一種優(yōu)雅的解決方案。

到此這篇關(guān)于SpringCloud-Gateway網(wǎng)關(guān)的使用的文章就介紹到這了,更多相關(guān)SpringCloud Gateway網(wǎng)關(guān)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！