Spring Cloud Gateway を使用したシンプルな API ゲートウェイの構築-＆＃＆チュートリアル-php.cn

最新のマイクロサービスアーキテクチャでは、API ゲートウェイが不可欠です。複数のサービスに単一のエントリポイントを提供し、ルーティング、セキュリティ、レート制限、負荷分散などを管理できるようにします。この記事では、Spring Cloud Gateway を使用して基本的な API ゲートウェイを設定し、パスに基づいてリクエストをさまざまなエンドポイントに送信する方法を説明します。また、フィルターを使用してパスを動的に操作する方法も示します。

コードを詳しく見てみましょう!

Building a Simple API Gateway with Spring Cloud Gateway — とんでもない!!

前提条件

この手順を進めるには、次のものが必要です:

Java 11 以降
Spring Boot (3.0 以降を推奨)
リアクティブ Spring クラウドゲートウェイ

プロジェクトのセットアップ

新しい Spring Boot プロジェクトを作成し、Spring Cloud Gateway 依存関係を含めます。これを簡単に行うには、Spring Initializr で新しいプロジェクトをセットアップし、依存関係で Spring Boot と Reactive Spring Cloud Gateway を選択します。

pom.xml スニペットは次のとおりです:

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

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>io.projectreactor</groupId>
            <artifactId>reactor-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-contract-stub-runner</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

ログイン後にコピー

APIゲートウェイの構築

3 つの異なるパスのリクエストを処理するようにゲートウェイを構成しましょう:

/get/country/{name} – 国に関する詳細を取得します。
/get/ language/{name} – 言語に基づいて情報を取得します。
/get/subregion/{name} – 特定のサブリージョンのデータを取得します。

「REST Countries API を使用して、アーキテクチャ内の他のマイクロサービスをシミュレートします。」

ルートの設定

アプリケーションのメインファイルの近くに router という名前のフォルダーを作成しました。その中に Routes.java というファイルを作成します。ここでルートを定義し、各パスを構成し、リクエストを動的に送信するためのフィルターを適用します。

package dev.mspilari.api_gateway.router;

import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class Routes {

    @Bean
    public RouteLocator routeLocator(RouteLocatorBuilder builder) {
        return builder.routes()
                .route("country_route", p -> p
                        .path("/get/country/{name}")
                        .filters(f -> f.setPath("/v3.1/name/{name}"))
                        .uri("https://restcountries.com"))

                .route("language_route", p -> p
                        .path("/get/language/{name}")
                        .filters(f -> f.setPath("/v3.1/lang/{name}"))
                        .uri("https://restcountries.com"))

                .route("subregion_route", p -> p
                        .path("/get/subregion/{name}")
                        .filters(f -> f.setPath("/v3.1/subregion/{name}"))
                        .uri("https://restcountries.com"))
                .build();
    }
}

ログイン後にコピー

コードの説明

ルート定義: 識別子 (country_route など) とパスを定義するラムダを受け取る、route メソッドを使用して各ルートを定義します。
パスマッチング: .path("/get/country/{name}") は、受信 URL パターンと一致するために使用されます。 {name} は、「ブラジル」のような国名など、任意の値に動的に置き換えられる変数です。
フィルター: SetPath を使用して送信リクエストのパスを変更します。たとえば、 .setPath("/v3.1/name/{name}") は、/get/country/{name} を REST Countries API で必要なエンドポイントである /v3.1/name/{name} に書き換えます。
URI: URI を https://restcountries.com に設定し、ベース URL として機能します。 Spring Cloud Gateway は、変更されたパスをこの URI に送信します。

ゲートウェイの実行

Spring Boot アプリケーションを起動します。これで、ゲートウェイにリクエストを送信できるようになり、ゲートウェイはリクエストを正しいエンドポイントに転送します。

ターミナルで次のコマンドを実行してルートをテストしてください:

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

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>io.projectreactor</groupId>
            <artifactId>reactor-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-contract-stub-runner</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

ログイン後にコピー

各リクエストは、パスとパラメーターに基づいて、ゲートウェイによってそれぞれの REST 国の API エンドポイントにルーティングされます。

応答の確認

すべてが正しく構成されていれば、REST Countries API を直接呼び出した場合に得られるものと一致する応答が表示されるはずです。

例:

package dev.mspilari.api_gateway.router;

import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class Routes {

    @Bean
    public RouteLocator routeLocator(RouteLocatorBuilder builder) {
        return builder.routes()
                .route("country_route", p -> p
                        .path("/get/country/{name}")
                        .filters(f -> f.setPath("/v3.1/name/{name}"))
                        .uri("https://restcountries.com"))

                .route("language_route", p -> p
                        .path("/get/language/{name}")
                        .filters(f -> f.setPath("/v3.1/lang/{name}"))
                        .uri("https://restcountries.com"))

                .route("subregion_route", p -> p
                        .path("/get/subregion/{name}")
                        .filters(f -> f.setPath("/v3.1/subregion/{name}"))
                        .uri("https://restcountries.com"))
                .build();
    }
}

ログイン後にコピー

Spring Cloud Gateway を使用する利点

単一エントリポイント: すべてのリクエストがゲートウェイを通過し、クライアントの対話と API 管理が簡素化されます。
柔軟なルーティング: ルートはパスパラメーターとフィルターを使用して簡単にカスタマイズできます。
動的パス書き換え: ゲートウェイを使用すると、リクエストパスを動的に調整できるため、クライアント側のコードを変更せずに外部 API と簡単に統合できます。