Menu
CoddyTech

라우트 핸들러

Coddy React 여정의 Next.js 핵심 (Next.js Essentials) 섹션에 포함된 레슨. 47개 중 37번째.

서버 컴포넌트는 이미 서버에서 실행되므로 대부분의 데이터 요구를 처리합니다. 하지만 때로는 클릭한 뒤나 검색창 입력이 멈춘 뒤처럼 브라우저가 나중에 데이터를 요청해야 할 때가 있으며, 이럴 때는 호출할 엔드포인트가 필요합니다.

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();

기억해야 할 점이 두 가지 있습니다. 폴더에는 page.jsx 또는 route.js 중 하나만 넣을 수 있으며, 둘 다 넣을 수는 없습니다. 두 파일이 같은 URL을 차지하려고 하기 때문입니다. 그리고 route.js는 컴포넌트가 아닙니다. JSX가 아니라 Response를 반환합니다.

브라우저가 필요할 때 데이터를 요청해야 하거나 앱 외부의 무언가가 앱을 호출해야 한다면 라우트 핸들러를 사용하세요. 서버 컴포넌트가 렌더링하는 동안 데이터를 바로 읽을 수 있다면 그렇게 하세요.

challenge icon

챌린지

중급

작은 API를 만들고 브라우저에서 호출하세요.

  1. app/api/dishes/route.js에서 async function GET을 내보내고 dishes를 JSON으로 반환하세요.
  2. components/DishLoader.jsx에서 loadDishes를 완성하세요. /api/dishes를 가져오고 JSON 본문을 읽은 다음, 요리의 이름을 setNames로 저장하세요.

#load-btn을 클릭하면 #dish-list에 네 가지 이름이 모두 표시되어야 합니다.

직접 해보기

import './globals.css';

export const metadata = {
    title: 'My App',
};

export default function RootLayout({ children }) {
    return (
        <html lang="en">
            <body>
                {children}
            </body>
        </html>
    );
}
quiz icon실력 점검

이 레슨에는 짧은 퀴즈가 포함되어 있습니다. 레슨을 시작해 문제를 풀고 진행 상황을 기록하세요.

Next.js 핵심 (Next.js Essentials)의 모든 레슨