Next.js에서 route.ts는 API 라우트 핸들러 역할을 합니다. 이 파일은 서버리스 함수처럼 동작하며, 특정 경로(URL)에 대한 API 엔드포인트를 정의하고 처리합니다. page.tsx가 클라이언트 측 렌더링을 담당하는 것과 달리, route.ts는 서버 측에서 데이터를 처리하고 응답을 반환하는 데 사용됩니다.
주요 역할 및 특징
- API 엔드포인트 정의: app 라우터에서 /api/users와 같은 경로를 만들고 그 안에 route.ts 파일을 배치하면, 해당 경로로 들어오는 요청을 처리할 수 있는 API 엔드포인트가 생성됩니다.
- HTTP 메소드 핸들링: 파일 내부에서 GET, POST, PUT, DELETE 등 다양한 HTTP 메소드에 대한 요청을 처리하는 함수를 직접 정의합니다. 예를 들어 export async function GET(request: Request)와 같이 함수를 작성하면 됩니다.
- 서버 측 로직 실행: 데이터베이스 조회, 외부 API 호출, 파일 시스템 접근 등 민감한 서버 측 로직을 안전하게 실행할 수 있습니다.
- 응답 반환: NextResponse 객체를 사용하여 JSON, 텍스트, 리다이렉션 등 다양한 형식의 응답을 클라이언트에 보낼 수 있습니다.
'개발 공부 > Next' 카테고리의 다른 글
| [Next] Zod (0) | 2025.08.24 |
|---|---|
| [Next] useFormStatus,useFormState (0) | 2025.08.23 |
| [Next] Redirect, Rewrites (0) | 2025.07.13 |
| [Next] styled-jsx (0) | 2025.07.01 |
| [Next] css Modules (0) | 2025.06.21 |