Abschnitt 8 · Lektion 5
Routing von Hand
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
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.
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.
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, kostenlosZu 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.