mitmario.dev

Routing von Hand

Node.js Sandbox 3 Min Lesezeit 3 BeispieleLektion 5 von 8

Schon eine kleine Bücherei hat vier Fälle. Unter /buecher kommt die Liste, über POST /buecher ein neues Buch, unter /buecher/12 ein einzelnes, und alles andere bekommt eine 404. Welche Antwort dran ist, leitet der Server aus Methode und Pfad ab. Das nennt man Routing.

Eine Kette von Bedingungen

Methode und Pfad zusammen
import { createServer } from "node:http";

const server = createServer((req, res) => {
  const pfad = new URL(req.url, "http://localhost").pathname;
  res.setHeader("Content-Type", "text/plain; charset=utf-8");

  if (req.method === "GET" && pfad === "/buecher") {
    res.end("Liste der Bücher");
    return;
  }

  if (req.method === "POST" && pfad === "/buecher") {
    res.statusCode = 201;
    res.end("Buch angelegt");
    return;
  }

  res.statusCode = 404;
  res.end("nicht gefunden");
});

server.listen(3000);

Das ist schon das ganze Verfahren. Für jede Route eine Bedingung, darin die Antwort, danach ein return, damit es nicht weitergeht.

Geprüft wird immer beides, Methode und Pfad. Mit fetch und method: "POST" hast du solche Anfragen im JavaScript-Kurs schon abgeschickt. Hier siehst du die andere Seite davon. Im Reiter Browser steht die Liste, denn der Browser fragt mit GET. curl -si -X POST http://localhost:3000/buecher bekommt im Terminal die 201, /zeitschriften den Standardfall mit 404.

Schon bei zwei Routen fällt auf, wie viel Wiederholung darin steckt. Dieselbe Bedingung mit zwei Vergleichen, dieselben drei Zeilen zum Antworten, dasselbe return. Bei fünf Routen ist die Funktion unübersichtlich, bei fünfzehn sucht man ernsthaft. Das Gefühl ist der Grund für den nächsten Abschnitt.

Der Standardfall ist Pflicht

Ganz unten steht, was passiert, wenn keine Bedingung getroffen hat. Diese Zeilen sehen aus wie Beiwerk, sind aber der wichtigste Teil.

Der vergessene Standardfall
import { createServer } from "node:http";

const server = createServer((req, res) => {
  res.setHeader("Content-Type", "text/plain; charset=utf-8");

  if (req.url === "/buecher") {
    res.end("Liste der Bücher");
    return;
  }
  // Und sonst? Nichts. Kein res.end, kein Standardfall.
});

server.listen(3000);

Ohne sie läuft die Funktion durch, findet nichts und ist fertig. Geantwortet hat niemand. Kein Fehler, kein 404, keine Meldung. Der Aufrufer wartet, bis er aufgibt. Im Reiter Browser steht die Liste unter /buecher, und alles sieht gut aus. Mit /zeitschriften in der Adresszeile lädt die Seite dagegen, bis du eine andere Adresse aufrufst. Mit --max-time 3 gibt curl im Terminal nach drei Sekunden auf.

Das ist derselbe Fehler wie das vergessene res.end() aus Lektion 8.1, nur mit anderem Gesicht. Dort war die eine Antwort nicht abgeschlossen, hier gibt es überhaupt keine. Für den Aufrufer sieht beides gleich aus, und deshalb erkennst du beides am selben Zeichen. Hängt eine Anfrage, statt einen Fehler zu bekommen, ist sie in einen Zweig gelaufen, der nicht antwortet.

Mit einer 404 kann ein Programm, das deinen Server benutzt, etwas anfangen. Mit einer Anfrage, die nie zurückkommt, nicht.

Platzhalter werden unangenehm

Bisher waren alle Pfade fest. Sobald aber /buecher/12 und /buecher/13 dieselbe Route sein sollen, reicht ein Vergleich nicht mehr.

Ein Platzhalter von Hand
import { createServer } from "node:http";

const server = createServer((req, res) => {
  const pfad = new URL(req.url, "http://localhost").pathname;
  const teile = pfad.split("/").filter((teil) => teil !== "");

  res.setHeader("Content-Type", "text/plain; charset=utf-8");

  if (teile[0] === "buecher" && teile.length === 2) {
    res.end(`${pfad} zerfällt in ${JSON.stringify(teile)}\nBuch ${teile[1]}\n`);
    return;
  }

  res.statusCode = 404;
  res.end(`${pfad} zerfällt in ${JSON.stringify(teile)}\nnicht gefunden\n`);
});

server.listen(3000);

split("/") und das filter gegen die leeren Stücke, die am Anfang und am Ende entstehen. "/buecher/12".split("/") ergibt ["", "buecher", "12"]. Das leere Stück vorn kommt vom Schrägstrich am Anfang, und ein Schrägstrich am Ende hängt hinten noch eins an. Danach wird die Länge geprüft, damit /buecher/12/seiten nicht mit durchrutscht, und der Wert an der richtigen Stelle herausgeholt.

Die Zerlegung steht im Beispiel mit in der Antwort, und so kannst du ihr beim Arbeiten zusehen. /buecher, /buecher/13 und /buecher/12/seiten in der Adresszeile zerfallen in eins, zwei und drei Stücke. Nur die zwei Stücke von /buecher/13 ergeben ein Buch.

Für eine Route ist das in Ordnung. Bei zehn Routen mit mal einem und mal zwei Platzhaltern schreibst du dir eine kleine Mustererkennung, und die wird mit jeder neuen Route ein Stück größer. An diesem Punkt hört Abschnitt 8 auf und Abschnitt 9 fängt an.

Zu einer Startseite und einer Liste kommen in der Aufgabe drei Routen dazu.

Zum Mitnehmen

Jede Route fragt Methode und Pfad zugleich ab und endet mit return. Ganz unten fängt ein Standardfall mit 404 alles auf, was keine Route trifft, sonst hängt die Anfrage.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.