Abschnitt 8 · Lektion 7
Synthese: der handgeschriebene Server
Einzeln sind Statuscode, Routing und Inhaltstyp schnell erklärt. Schwierig wird es, wenn ein Server
alles davon auf einmal braucht. Eine Seite für Menschen, eine API für Programme und eine ehrliche
404 für jede falsche Adresse. Dann kommt es auf die Reihenfolge an, und jeder Weg durch die Funktion
muss bei einem res.end() ankommen. Fremden Code braucht es dafür nicht.
Der Ablauf, jedes Mal derselbe
- Server starten mit
createServerundlisten. - Anfrage zerlegen in Methode und Pfad.
- Route finden, also die passende Bedingung treffen.
- Status und Kopfzeilen setzen, bevor der Rumpf losgeht.
- Rumpf senden.
- Abschließen mit
res.end(), und zwar auf jedem Weg durch die Funktion.
import { createServer } from "node:http";
const notizen = [
{ text: "Milch kaufen", erledigt: false },
{ text: "Brot holen", erledigt: true },
];
const server = createServer((req, res) => {
const pfad = new URL(req.url, "http://localhost").pathname;
if (req.method === "GET" && pfad === "/") {
res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
res.end("<!doctype html><h1>Notizen</h1>");
return;
}
if (req.method === "GET" && pfad === "/api/notizen") {
res.writeHead(200, { "Content-Type": "application/json" });
res.end(JSON.stringify({ anzahl: notizen.length, notizen }));
return;
}
res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
res.end("nicht gefunden");
});
server.listen(3000); Das sind zwei Routen und ein Standardfall, und jede Zeile darin kennst du schon. Der ganze Abschnitt in knapp dreißig Zeilen.
Im Reiter Browser steht diesmal eine echte Seite, also eine Überschrift statt der Zeichen, aus denen
sie besteht. text/html und application/json stehen hier zum ersten Mal im selben Server, und den
Unterschied siehst du direkt. Mit /api/notizen in der Adresszeile steht dort das JSON, aus
derselben Datei und nur mit einer anderen Kopfzeile. Im Terminal zeigt
curl -si http://localhost:3000/gibtsnicht den Standardfall mit seiner 404.
Wo es unangenehm wird
Der Server oben funktioniert. An drei Stellen merkst du beim Schreiben aber, dass du Arbeit machst, die eigentlich niemand machen sollte.
Die erste sind Platzhalter im Pfad. Einen davon hast du in Lektion 8.5 schon zerlegt, mit split
oder slice. Für eine Route geht das. Für zehn Routen mit unterschiedlich vielen Platzhaltern
schreibst du dir eine Mustererkennung.
Die zweite sind Inhaltstypen für Dateien.
import { extname } from "node:path";
// Die Tabelle, die dir spaeter jemand abnimmt.
const typen = {
".html": "text/html; charset=utf-8",
".css": "text/css; charset=utf-8",
".js": "text/javascript; charset=utf-8",
".png": "image/png",
".svg": "image/svg+xml",
};
for (const datei of ["seite.html", "stil.css", "logo.png", "daten.csv"]) {
const endung = extname(datei);
console.log(`${datei} -> ${typen[endung] ?? "application/octet-stream"}`);
} Soll dein Server nicht nur eine Seite, sondern auch Stylesheets, Bilder und Schriften ausliefern, brauchst du diese Zuordnung für jede Endung, die vorkommt. Die Tabelle, die Express mitbringt, kennt über tausend Endungen. Niemand tippt die ab, und niemand sollte.
Die dritte sind die immer gleichen drei Zeilen. Status setzen, Inhaltstyp setzen, umwandeln und senden, in jeder einzelnen Route.
import { createServer } from "node:http";
// Statt in jeder Route dieselben drei Zeilen: ein Helfer.
const sendeJson = (res, status, daten) => {
res.writeHead(status, { "Content-Type": "application/json" });
res.end(JSON.stringify(daten));
};
const server = createServer((req, res) => {
const pfad = new URL(req.url, "http://localhost").pathname;
if (pfad === "/api/zeit") {
sendeJson(res, 200, { stunde: 12 });
return;
}
if (pfad === "/api/notizen") {
sendeJson(res, 200, { anzahl: 2 });
return;
}
sendeJson(res, 404, { fehler: "nicht gefunden" });
});
server.listen(3000); Alle Routen rufen jetzt den Helfer auf, und der Aufbau der Antwort steht nur noch an einer Stelle.
Auch der Standardfall geht durch denselben Helfer, das siehst du mit /nix in der Adresszeile.
Ein eigener Helfer ist der naheliegende Ausweg, und er ist auch gut. Er spart sofort Zeilen und
Flüchtigkeitsfehler. Denkt man das weiter, kommt als Nächstes einer für HTML, dann einer für
Weiterleitungen, dann eine Funktion, die Pfade mit Platzhaltern vergleicht, und schließlich eine
Liste von Routen statt einer if-Kette. Dann hast du irgendwann Express gebaut, nur schlechter
getestet.
Was Abschnitt 9 abnimmt
Um diese drei Stellen geht es in Abschnitt 9. Express bringt Routing mit Platzhaltern mit, setzt Inhaltstypen von selbst, schickt JSON in einem Aufruf und liefert statische Dateien samt passendem Typ aus einem Ordner.
Ab jetzt weißt du bei jeder dieser Erleichterungen, was sie ersetzt.
app.get("/api/kurse/:slug", ...) ist für dich eine Bedingung, ein split und eine Längenprüfung,
die jemand anderes schon geschrieben hat. In Lektion 9.6 steht der Server aus der Aufgabe noch
einmal da, und daneben derselbe mit Express.
Die Aufgabe ist ein Server mit Seite und API, und das Routing dazwischen schreibst du.
Zum Mitnehmen
Ein Server von Hand braucht sechs Schritte, von createServer bis zu einem res.end() auf jedem Weg. Platzhalter, Inhaltstypen und die immer gleichen Zeilen je Route sind die Stellen, die Express abnimmt.
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.