API vs. Middleware: Den Unterschied verstehen

Bei der Arbeit an der Backend-Entwicklung stoßen Sie zwangsläufig auf zwei Begriffe: API und Middleware.

Während beide eine entscheidende Rolle in der Anwendungsarchitektur spielen, dienen sie sehr unterschiedlichen Zwecken.

Lassen Sie uns sie aufschlüsseln, ihre Rollen vergleichen und ihre Unterschiede auf eine Weise verdeutlichen, die Sie nicht dazu bringt, den Schreibtisch umzudrehen.

Was ist eine API?

API steht für Application Programming Interface. Es handelt sich im Wesentlichen um einen Vertrag, der es verschiedenen Softwarekomponenten ermöglicht, miteinander zu kommunizieren.

Stellen Sie sich das wie den Kellner in einem Restaurant vor: Er nimmt Ihre Bestellung entgegen (Anfragen), liefert sie an die Küche (Server) und bringt Ihr Essen zurück (Antwort).

Hauptmerkmale von APIs

• Stellt Endpunkte für die Interaktion mit Daten oder Diensten bereit.
• Wird über HTTP/HTTPS ausgeführt (am häufigsten für Web-APIs).
• Kann Protokollen wie REST, GraphQL oder gRPC folgen.

Analogie zur realen Welt

Sie verwenden jedes Mal eine API, wenn Sie einen Uber bestellen oder einen Tweet posten. Das Backend der App stellt eine API für das Frontend zum Abrufen oder Senden von Daten bereit.

• Codebeispiel So könnte ein einfacher API-Endpunkt in einer Express.js-App aussehen:

  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');
  });

• APIs definieren welche Funktionalität Ihre App der Außenwelt zugänglich macht.

Was ist Middleware?

Middleware ist eher wie das Personal hinter den Kulissen in der Küche – es ist nicht dasjenige, das Sie direkt bedient, aber es sorgt dafür, dass alles reibungslos läuft.

Technisch gesehen ist Middleware eine Funktion oder ein Funktionssatz, der zwischen der Anfrage und der Antwort in Ihrer Anwendungspipeline liegt.

Hauptmerkmale von Middleware

• Verarbeitet Anfragen, bevor sie den endgültigen Handler (z. B. eine API) erreichen.
• Kann Anfragen oder Antworten ändern.
• Wird häufig für Aufgaben wie Authentifizierung, Protokollierung, Validierung oder Fehlerbehandlung verwendet.

Analogie zur realen Welt

Stellen Sie sich Middleware als den Sicherheitsbeamten in einem Gebäude vor.

Es stellt sicher, dass nur autorisierte Personen (gültige Anfragen) zu den Büros (APIs) gelangen.

• Codebeispiel Hier ist ein Beispiel für eine einfache Protokollierungs-Middleware in 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');
  });

• Middleware verwaltet wie Anfragen verarbeitet werden, bevor sie den Endpunkt erreichen.

Hauptunterschiede zwischen API und Middleware

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.

Wann sollten APIs vs. Middleware verwendet werden?

• APIs

  • Verwenden Sie APIs, wenn Sie externen Anwendungen oder Diensten die Möglichkeit bieten möchten, mit Ihrem System zu interagieren.
  • Beispiel: Eine mobile App, die Benutzerdetails über /users/:id abruft.

• Middleware

  • Verwenden Sie Middleware für übergreifende Anliegen, die für mehrere Routen oder APIs gelten.
  • Beispiel: JWT-Tokens für alle geschützten Routen überprüfen, Cookies im Browser setzen.

Es zusammenbringen

Stellen Sie sich vor, Sie entwickeln eine Mitfahr-App. Die APIs könnten Folgendes umfassen:

• /drivers: Um verfügbare Treiber abzurufen.
• /trips: Zum Buchen oder Verwalten von Reisen.

Hinter den Kulissen sorgt Middleware für Folgendes:

• Nur ​​authentifizierte Benutzer können auf /trips zugreifen.
• Für jede Anfrage werden Protokolle geführt.
• Eine Ratenbegrenzung wird durchgesetzt, um Missbrauch zu verhindern.

Sowohl APIs als auch Middleware sind für die Erstellung einer robusten Anwendung unverzichtbar – die eine stellt die Funktionalität bereit und die andere stellt sicher, dass sie reibungslos und sicher funktioniert.

Apropos APIs:

Ich habe an einem äußerst praktischen Tool namens LiveAPI gearbeitet.

Es wurde entwickelt, um die API-Dokumentation für Entwickler mühelos zu gestalten.

Mit LiveAPI können Sie schnell eine interaktive API-Dokumentation erstellen, die es Benutzern ermöglicht, APIs direkt über den Browser auszuführen.

Wenn Sie es leid sind, Dokumente manuell zu erstellen, oder keine Zeit mit der Integration von Swagger für Ihre APIs verbringen möchten, könnte dieses Tool Ihnen das Leben erleichtern. Probieren Sie LiveAPI jetzt aus!

Das obige ist der detaillierte Inhalt vonAPI vs. Middleware: Den Unterschied verstehen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!