mitmario.dev

Router

Node.js Sandbox 3 Min Lesezeit 2 BeispieleLektion 4 von 7

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

Ein Router in einer eigenen Datei
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.

Derselbe Router unter zwei Adressen
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, 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 2 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.