REST と GraphQL: 主な違い、利点、プロジェクトにどちらを選択するか-jsチュートリアル-php.cn

ジュニア開発者とシニア開発者の大きな違いの 1 つは、コードを書く能力だけではありません。コードは誰でも学ぶことができるためです。それは、情報に基づいて戦略的な決定を下す能力にあります。これらの決定には、多くの場合、トレードオフの評価と、当面のタスクに最適なツールの選択が含まれます。開発者として、さまざまな問題解決アプローチを理解し、最も効果的なソリューションを選択することが重要です。システム設計は、優れた開発者を目指す人にとっての基本です。システム設計における一般的な決定は、GraphQL と REST のどちらを選択するかです。それぞれをいつ使用する必要がありますか?それぞれの利点は何ですか?この記事では、これらの質問について詳しく説明し、次のプロジェクトに最適なオプションを選択するためのガイドを示します。

REST と GraphQL のアーキテクチャを理解する: 主な違いについて説明

REST アーキテクチャ

REST (Representational State Transfer) は、ネットワークアプリケーション、特に Web サービスを設計するためのアーキテクチャスタイルです。スケーラブルでステートレスでわかりやすい Web API を構築するために広く使用されています。

REST は、標準の HTTP メソッドを活用して、一意の URL によって識別されるエンティティであるリソースと対話します。 RESTful API では、GET、POST、PUT、DELETE などの HTTP メソッドを使用してリソースが定義および操作されます。

REST API アーキテクチャを支える 3 つの主要な機能:

1) リソース構造
2) HTTP メソッド
3) エンドポイント設計

ソーシャルメディアアプリケーションを設計していて、投稿、コメント、返信などのリソースがあるとします。

リソース構造:

投稿: ソーシャルメディアの投稿を表します。
コメント: 投稿に対するコメント。
返信: コメントへの返信。

REST vs. GraphQL: Key Differences, Benefits, and Which One to Choose for Your Project

HTTP メソッドとエンドポイント:

POST /posts: 新しい投稿を作成します。
GET /posts: 投稿のリストを取得します。
GET /posts/{id}: 特定の投稿を取得します。
POST /posts/{id}/comments:投稿にコメントを追加します。
GET /posts/{id}/comments: 特定の投稿のすべてのコメントを取得します。
POST /comments/{id}/replies: コメントに返信を追加します。
GET /comments/{id}/replies: 特定のコメントに対するすべての返信を取得します。

REST API とデータベースのやり取りをより明確に理解するには、以下の図を参照してください。

REST vs. GraphQL: Key Differences, Benefits, and Which One to Choose for Your Project

GraphQl アーキテクチャ

GraphQL は、複数のエンドポイントでさまざまな HTTP メソッドを介してリソースにアクセスするという原則に基づいて動作する REST アーキテクチャとは異なるアプローチを提供します。対照的に、GraphQL は、ユーザーが特定のニーズに応じてあらゆる種類のデータをリクエストできるようにするクエリ言語として機能します。 GraphQL の背後にある基本的な考え方は、クライアントが必要なデータの詳細を記述したクエリを作成し、それを HTTP POST リクエストを使用して API に送信するというものです。 REST とは異なり、すべての GraphQL クエリは POST メソッドを介して単一のエンドポイントに送信されます。
GraphQL を支える 2 つの主な機能:

スキーマ: これは、投稿、コメント、返信などのさまざまなデータ型を定義します。
クエリとミューテーション: ほとんどの GraphQL スキーマには、API に許可されるクエリの種類を指定するクエリセクションが組み込まれています。 GraphQL は、リソースの作成、編集、削除に HTTP メソッドに依存するのではなく、データの取得 (投稿、コメント、返信など) にはクエリを利用し、データの変更 (投稿の作成やコメントと返信の追加など) にはミューテーションを利用します。この構造により、従来の RESTful サービスと比較して、より効率的かつ柔軟なデータ対話が可能になります。

graphql API とデータベースの対話をより明確に理解するには、以下の図を参照してください。

REST vs. GraphQL: Key Differences, Benefits, and Which One to Choose for Your Project

概要から見ると、主な違いは次のとおりです

アスペクト	GraphQL	休憩
定義	クライアントが必要なデータを正確にリクエストできるようにする API のクエリ言語とランタイム。	クライアントが複数の HTTP エンドポイントを通じてデータをリクエストする API のアーキテクチャスタイル。
データリクエスト	すべての操作 (POST) を処理する単一のエンドポイント。サーバーがネストされたデータまたは関連データを取得すると、複数のリクエストが発生する可能性があります。	さまざまなリソースに対する複数のエンドポイント (GET、POST、PUT、DELETE)。
効率	ネストされたクエリを許可することで、ネットワークのラウンドトリップ数を削減します。	関連データを取得するには複数のリクエストが必要になることが多く、ネットワークのオーバーヘッドが増加します。
クエリ言語	複雑でネストされたクエリを記述できる、単一の柔軟なクエリ言語を使用します。	標準の HTTP メソッドとルートに従い、ネストされたデータに対して個別のリクエストが必要です。
応答サイズ	必要なフィールドのみを効率的に取得するため、応答が小さくなります。	関連データのオーバーフェッチまたはアンダーフェッチによる応答の増加。
スケーラビリティ	複雑な入れ子構造で効率的。サーバーの負荷を軽減します。	多くの個別のリクエストが必要な場合、スケーラビリティが低下する可能性があります。
クライアントリクエスト	1 つのクライアントリクエストは、1 回の呼び出しで複数の関連リソースを取得できます。	関連リソースに複数の HTTP リクエストが必要であり、遅延が増加することがよくあります。
構造	すべての操作を処理する単一のエンドポイント (通常は POST)。	リソースタイプに基づく複数のエンドポイント (GET、POST、PUT、DELETE)。
データの取得	必要な正確なフィールドのみをフェッチできるため、データサイズとオーバーヘッドが削減されます。	オーバーフェッチまたはアンダーフェッチが発生し、不要なネットワークトラフィックが発生する可能性があります。
コードの複雑さ	ネストされたクエリと正確なフィールド選択を可能にすることで、クライアント側の操作を簡素化します。	ネストされたデータまたは関連データに対して複数のリクエストが必要となり、クライアントコードがより複雑になります。
パフォーマンス	リクエストの数が減るため、複雑なクエリとネストされたデータが高速になります。	関連データのリクエストが複数あると遅くなり、レイテンシが増加する可能性があります。
メンテナンス	クエリ言語の柔軟性と単一のエンドポイントにより、保守が容易になります。	さまざまなリソースに対して複数のエンドポイントを使用すると、より多くのメンテナンスが必要になる可能性があります。
エラー処理	単一のクエリ内でエラーをより具体的に処理できます。	エラーはエンドポイントごとに個別に処理する必要があります。
バージョン管理	クライアントの操作を中断せずにスキーマを更新できるため、バージョン管理は必要ありません。	エンドポイントとデータ構造の変更により、バージョン管理が必要になる場合があります。
クライアントの柔軟性	クライアントが必要なデータを正確に指定できるようにするための柔軟性が向上しました。	クライアントの柔軟性は、事前定義されたエンドポイントと応答構造によって制限されます。