라우트 핸들러
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를 반환합니다.
브라우저가 필요할 때 데이터를 요청해야 하거나 앱 외부의 무언가가 앱을 호출해야 한다면 라우트 핸들러를 사용하세요. 서버 컴포넌트가 렌더링하는 동안 데이터를 바로 읽을 수 있다면 그렇게 하세요.
챌린지
중급작은 API를 만들고 브라우저에서 호출하세요.
app/api/dishes/route.js에서async function GET을 내보내고dishes를 JSON으로 반환하세요.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>
);
}이 레슨에는 짧은 퀴즈가 포함되어 있습니다. 레슨을 시작해 문제를 풀고 진행 상황을 기록하세요.