Abschnitt 10 · Lektion 4
Router
Eine Anwendung mit Büchern, Autoren, Nutzern und Einstellungen hat schnell fünfzig Routen. Stehen
alle in einer Datei, suchst du die Route für ein Buch zwischen allen anderen. Und vor jedem
Bücher-Pfad steht noch einmal derselbe Anfang /buecher.
Eine kleine Anwendung für sich
import express from "express";
const buecher = [
{ id: 1, titel: "Node in der Praxis", jahr: 2020 },
{ id: 2, titel: "JavaScript von vorn", jahr: 2019 },
];
// Ein Router ist eine kleine Anwendung fuer sich: eigene Routen, eigene
// Middleware. Der Pfad, unter dem er haengt, kommt hier nicht vor.
const router = express.Router();
router.get("/", (req, res) => res.json({ anzahl: buecher.length }));
router.get("/:id", (req, res) => {
const buch = buecher.find((eintrag) => eintrag.id === Number(req.params.id));
if (buch === undefined) return res.status(404).json({ fehler: "Buch nicht gefunden" });
res.json(buch);
});
export default router; import express from "express";
import buecherRouter from "./buecher.js";
const app = express();
// Hier und nur hier steht, unter welcher Adresse der Router haengt.
app.use("/buecher", buecherRouter);
app.listen(3000); express.Router() gibt ein Objekt zurück, das sich fast genau wie app verhält. Es kennt get,
post, use und alles andere. Eine Middleware, die mit router.use angemeldet ist, gilt nur für
seine eigenen Routen. Nur horchen kann es nicht, es hat kein listen. Dafür lässt es sich mit
app.use(pfad, router) an einer Stelle einhängen.
Die Route, die in buecher.js unter "/" angemeldet ist, antwortet auf /buecher. Tippst du
/buecher/2 und /buecher/99 in die Adresszeile, siehst du die zweite Route und ihren Fehlerfall.
In buecher.js stehen die Pfade "/" und "/:id", nicht "/buecher" und "/buecher/:id". Der
gemeinsame Anfang fehlt, weil er beim Einhängen dazukommt. Das funktioniert genauso wie bei
app.use("/api", ...) aus Lektion 10.2, und deshalb steht in req.url innerhalb eines Routers auch
nur der Teil des Pfads, der hinter dem Einhängepunkt kommt.
Ein Router weiß nicht, wo er hängt
Der offensichtliche Gewinn ist, dass die Datei kürzer wird und die Bücher-Routen dort stehen, wo Bücher draufsteht. Der weniger offensichtliche ist wichtiger.
import express from "express";
const buecher = [
{ id: 1, titel: "Node in der Praxis", jahr: 2020 },
{ id: 2, titel: "JavaScript von vorn", jahr: 2019 },
];
const router = express.Router();
router.get("/", (req, res) => res.json({ anzahl: buecher.length }));
router.get("/:id", (req, res) => {
const buch = buecher.find((eintrag) => eintrag.id === Number(req.params.id));
if (buch === undefined) return res.status(404).json({ fehler: "Buch nicht gefunden" });
res.json(buch);
});
export default router; import express from "express";
import buecherRouter from "./buecher.js";
const app = express();
// Derselbe Router, zweimal eingehaengt. In buecher.js steht kein einziges
// Mal das Wort buecher oder archiv.
app.use("/buecher", buecherRouter);
app.use("/archiv", buecherRouter);
app.listen(3000); Ob du /buecher/1 oder /archiv/1 in die Adresszeile tippst, die Antwort ist dieselbe und kommt
aus derselben Datei.
In buecher.js steht das Wort buecher nicht ein einziges Mal in einem Pfad. Die Datei weiß nicht,
wo sie hängt, und deshalb kann sie zweimal hängen. Soll morgen alles unter /api liegen, ändert
sich eine Zeile in server.js und keine einzige in den Router-Dateien.
Wer einmal fünfzig Pfade von Hand umgeschrieben hat, weiß das zu schätzen.
Die Aufteilung, die sich bewährt hat
Eine Datei je Sache. buecher.js für alles unter /buecher, autoren.js für alles unter
/autoren, nutzer.js für alles unter /nutzer. Dazu eine server.js, die sie einhängt und sonst
wenig tut.
Ein Router ist genau das, was in Abschnitt 2 ein Modul exportieren sollte. Ein Ding mit einem Zweck,
das nach außen nur zeigt, was andere brauchen, und den Rest für sich behält. Dort ging es um kleine
Module wie mathe.js. Hier zahlt sich derselbe Gedanke sofort aus.
Womit du rechnen musst
Der Router muss exportiert und importiert werden, mit export default router am Ende der Datei und
einem passenden Import in server.js. Fehlt der Export, bricht der Start schon beim Import ab, mit
SyntaxError: The requested module './buecher.js' does not provide an export named 'default'.
Übersetzt heißt das, ./buecher.js hat keinen Export, der default heißt. Die Meldung zeigt auf
die Importzeile in server.js und sagt wörtlich, was fehlt.
Und die Reihenfolge gilt weiterhin. Ein Router ist ein Eintrag in derselben Liste wie alles andere,
nur hängt an dieser einen Stelle ein ganzes Bündel Routen. Steht der Standardfall über
app.use("/buecher", ...), kommen die Bücher nie dran.
Zwei Router hängen schon in server.js, und der zweite bekommt im Reiter Praxis seine Routen.
Zum Mitnehmen
Ein Router bündelt die Routen einer Sache in einer eigenen Datei und kennt seinen eigenen Pfad nicht. Wo er hängt, steht nur beim Einhängen in server.js, und dort gilt auch für ihn die Reihenfolge.
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 2 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.