ホームページ >ウェブフロントエンド >jsチュートリアル >API とミドルウェア: 違いを理解する

API とミドルウェア: 違いを理解する

DDDオリジナル: 2025-01-14 08:09:44632ブラウズ

バックエンド開発に取り組むとき、API と ミドルウェア という 2 つの用語が必ず出てきます。

どちらもアプリケーションアーキテクチャにおいて重要な役割を果たしますが、目的は大きく異なります。

机をひっくり返したくなるほどの方法で、それらを分解して役割を比較し、違いを明確にしてみましょう。

APIとは何ですか?

API は アプリケーションプログラミングインターフェイス の略です。これは本質的に、さまざまなソフトウェアコンポーネントが相互に通信できるようにする契約です。

レストランのウェイターと考えてください。注文 (リクエスト) を受け取り、それをキッチン (サーバー) に届け、食べ物を持ち帰る (応答)。

API の主な特徴

データまたはサービスと対話できるようにエンドポイントを公開します。
HTTP/HTTPS 経由で動作します (Web API で最も一般的)。
REST、GraphQL、gRPC などのプロトコルに従うことができます。

現実世界のアナロジー

Uber を注文したり、ツイートを投稿したりするたびに API を使用することになります。アプリのバックエンドは、フロントエンドがデータを取得または送信するための API を提供します。

コード例 Express.js アプリでの単純な API エンドポイントは次のようになります。

  const express = require('express');
  const app = express();

  app.get('/users', (req, res) => {
    res.json([
      { id: 1, name: 'John Doe' },
      { id: 2, name: 'Jane Smith' },
    ]);
  });

  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });

API は、アプリが外部の世界に公開する内容の機能を定義します。

API vs Middleware: Understanding the Difference

ミドルウェアとは何ですか?

ミドルウェアはキッチンの裏方スタッフに似ており、直接サービスを提供するわけではありませんが、すべてがスムーズに進むようにします。

技術用語では、ミドルウェアとは、アプリケーションパイプラインのリクエストとレスポンスの間に位置する関数または関数のセットです。

ミドルウェアの主な特徴

リクエストが最終ハンドラー (API など) に到達する前に処理します。
リクエストまたはレスポンスを変更できます。
認証、ロギング、検証、エラー処理などのタスクによく使用されます。

現実世界のアナロジー

ミドルウェアは建物の警備員のようなものだと考えてください。

許可された個人 (有効なリクエスト) のみがオフィス (API) に到達することを保証します。

コード例 Express.js の単純なログ記録ミドルウェアの例を次に示します。

  const express = require('express');
  const app = express();

  const loggingMiddleware = (req, res, next) => {
    console.log(`Request made to: ${req.url}`);
    next(); // Pass control to the next middleware or handler
  };

  app.use(loggingMiddleware);

  app.get('/users', (req, res) => {
    res.json([
      { id: 1, name: 'John Doe' },
      { id: 2, name: 'Jane Smith' },
    ]);
  });

  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });

ミドルウェアは、リクエストがエンドポイントに到達する前にどのように処理されるかを処理します。

API vs Middleware: Understanding the Difference

API とミドルウェアの主な違い

Aspect	API	Middleware
Purpose	Defines endpoints for interaction.	Processes requests/responses.
Visibility	Exposed to external systems.	Works internally within the app.
Examples	/users, /products, /login	Authentication, logging, error handling
Interaction	Invoked by external clients.	Invoked automatically in the request pipeline.
Code Placement	Found in controllers.	Found in the middleware functions.

API とミドルウェアを使用する場合

API
- 外部アプリケーションまたはサービスがシステムと対話する方法を提供する場合は、API を使用します。
- 例: /users/:id 経由でユーザーの詳細を取得するモバイルアプリ。
ミドルウェア
- 複数のルートまたは API に適用される横断的な懸念事項にはミドルウェアを使用します。
- 例: すべての保護されたルートの JWT トークンを検証し、ブラウザーに Cookie を設定します。

API vs Middleware: Understanding the Difference