Route-Handler
Teil des Abschnitts Next.js Essentials der React-Journey von Coddy. Lektion 37 von 47.
Serverkomponenten decken die meisten Datenanforderungen ab, da sie ohnehin bereits auf dem Server ausgeführt werden. Manchmal muss der Browser jedoch später Daten anfordern, etwa nach einem Klick oder nachdem sich ein Suchfeld beruhigt hat. Dafür brauchst du einen Endpunkt, den du aufrufen kannst.
Ein Ordner, der eine route.js enthält, wird genau zu dieser Route. Dieselbe Routing-Regel wie bei Seiten, aber eine andere spezielle Datei:
app/
api/
dishes/
route.js -> /api/dishesDarin exportierst du eine Funktion, die nach der HTTP-Methode benannt ist:
import { dishes } from '../../../lib/dishes.js';
export async function GET() {
return Response.json(dishes);
}Response.json(...) ist die gesamte Antwort: Es serialisiert den Wert und legt den JSON-Inhaltstyp fest. Du kannst auch POST, PUT und DELETE aus derselben Datei exportieren.
Dann besteht die Client-Seite aus gewöhnlichem Browser-Code:
const res = await fetch('/api/dishes');
const data = await res.json();Zwei Dinge musst du auseinanderhalten. Ein Ordner kann eine page.jsx oder eine route.js enthalten, niemals beides: Beide würden dieselbe URL beanspruchen. Und route.js ist keine Komponente: Sie gibt eine Response zurück, kein JSX.
Greif auf einen Route-Handler zurück, wenn der Browser Daten bei Bedarf benötigt oder etwas außerhalb deiner App eine Anfrage senden muss. Wenn eine Server-Komponente die Daten einfach während des Renderns lesen kann, lass sie das tun.
Aufgabe
MittelErstelle eine kleine API und rufe sie im Browser auf.
- Exportiere in
app/api/dishes/route.jseineasync function GET, diedishesals JSON zurückgibt. - Vervollständige in
components/DishLoader.jsxloadDishes: Rufe/api/dishesab, lies den JSON-Body und speichere die Gerichtsnamen mitsetNames.
Beim Klicken auf #load-btn müssen alle vier Namen in #dish-list angezeigt werden.
Probier es selbst
import './globals.css';
export const metadata = {
title: 'My App',
};
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
{children}
</body>
</html>
);
}Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.
Alle Lektionen in Next.js Essentials
4Server & Client
Zwei Arten von KomponentenDie Fehlermeldung lesenDie „use client“-ZeileClient-Komponenten klein haltenServer im ClientZusammenfassung: Server & Client7Client-Navigation
Der aktive LinkProgrammgesteuertes RoutingFiltern mit der URLRoute-HandlerRückblick: Navigation