ルートハンドラー
CoddyのReactジャーニー「Next.js の基本」セクションの一部。レッスン 37/47。
サーバーコンポーネントは、すでにサーバー上で実行されるため、ほとんどのデータ取得のニーズに対応できます。しかし、クリック後や検索ボックスの入力が落ち着いた後など、ブラウザーがデータを後から要求しなければならないこともあります。その場合は、呼び出すエンドポイントが必要です。
route.jsが入っているフォルダーは、そのままの名前になります。ページと同じルーティング規則ですが、特別なファイルが異なります。
app/
api/
dishes/
route.js -> /api/dishes内部では、HTTPメソッドにちなんだ名前の関数をエクスポートします。
import { dishes } from '../../../lib/dishes.js';
export async function GET() {
return Response.json(dishes);
}Response.json(...)は返信全体を表し、値をシリアライズしてJSONのコンテンツタイプを設定します。同じファイルからPOST、PUT、DELETEもエクスポートできます。
次に、クライアント側は通常のブラウザーコードです。
const res = await fetch('/api/dishes');
const data = await res.json();覚えておくべきことが2つあります。フォルダーには page.jsx または route.js のどちらか一方だけを置けます。両方を置くことはできません。どちらも同じURLを担当することになるためです。また、route.js はコンポーネントではありません。JSXではなく、Response を返します。
ブラウザーが必要に応じてデータを必要とするときや、アプリの外部から呼び出す必要があるときは、ルートハンドラーを使いましょう。サーバーコンポーネントがレンダリング中にデータを読み取るだけで済むなら、そうさせましょう。
チャレンジ
中級小さなAPIを作成し、ブラウザーから呼び出しましょう。
app/api/dishes/route.jsで、dishesをJSONとして返すasync function GETをエクスポートします。components/DishLoader.jsxで、loadDishesを完成させます。/api/dishesを取得し、JSON本文を読み込み、料理の名前をsetNamesで保存します。
#load-btnをクリックすると、#dish-listに4つすべての名前が表示される必要があります。
自分で試してみよう
import './globals.css';
export const metadata = {
title: 'My App',
};
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
{children}
</body>
</html>
);
}このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。