HTTP 메서드 처리

// src/app/api/your-resource/route.ts

import { NextRequest, NextResponse } from 'next/server';

export async function GET(request: NextRequest) {
  // GET 요청 처리 로직
  return NextResponse.json({ message: 'GET request received' });
}

export async function POST(request: NextRequest) {
  // POST 요청 처리 로직
  const data = await request.json();
  return NextResponse.json({ message: 'POST request received', data });
}

export async function PUT(request: NextRequest) {
  // PUT 요청 처리 로직
  const data = await request.json();
  return NextResponse.json({ message: 'PUT request received', data });
}

export async function DELETE(request: NextRequest) {
  // DELETE 요청 처리 로직
  return NextResponse.json({ message: 'DELETE request received' });
}

// 기타 메서드도 동일하게 export 할 수 있습니다.
// export async function PATCH(request: NextRequest) { ... }
// export async function HEAD(request: NextRequest) { ... }
// export async function OPTIONS(request: NextRequest) { ... }

// NextRequest 활용 예시
import { NextRequest, NextResponse } from 'next/server';

export async function GET(request: NextRequest) {
  const url = request.url; // 예: http://localhost:3000/api/data?name=test
  const method = request.method; // 'GET'
  const contentType = request.headers.get('Content-Type'); // 요청 헤더 접근
  const myCookie = request.cookies.get('my_cookie')?.value; // 쿠키 접근
  const nameParam = request.nextUrl.searchParams.get('name'); // 쿼리 파라미터 접근

  return NextResponse.json({
    url,
    method,
    contentType,
    myCookie,
    nameParam,
  });
}

export async function POST(request: NextRequest) {
  const body = await request.json(); // JSON 본문 파싱
  // const textBody = await request.text(); // 텍스트 본문 파싱

  return NextResponse.json({
    message: 'Data received',
    receivedBody: body,
  });
}

// NextResponse 활용 예시
import { NextRequest, NextResponse } from 'next/server';

export async function GET(request: NextRequest) {
  // 200 OK 상태 코드와 JSON 데이터 반환
  return NextResponse.json({ data: '성공적으로 데이터를 가져왔습니다.' }, { status: 200 });
}

export async function POST(request: NextRequest) {
  // 201 Created 상태 코드와 커스텀 헤더 설정
  const newUser = { id: 1, name: '새 사용자' };
  return NextResponse.json(newUser, {
    status: 201,
    headers: {
      'X-Custom-Header': 'Next.js API',
      'Location': `/api/users/${newUser.id}`, // 생성된 리소스의 위치
    },
  });
}

export async function DELETE(request: NextRequest) {
  // 404 Not Found 상태 코드와 오류 메시지
  const id = request.nextUrl.searchParams.get('id');
  if (id === 'invalid') {
    return NextResponse.json({ message: '리소스를 찾을 수 없습니다.' }, { status: 404 });
  }
  // 204 No Content (성공적으로 처리했지만 반환할 내용이 없을 때)
  return new NextResponse(null, { status: 204 });
}

import { NextRequest, NextResponse } from 'next/server';

// 가상의 사용자 데이터 (실제로는 데이터베이스)
// 🚨 중요: 이 예제는 서버가 재시작되면 데이터가 초기화됩니다.
// 실제 애플리케이션에서는 반드시 데이터베이스를 사용해야 합니다.
let users = [
  { id: 1, name: '김철수', email: 'chulsoo@example.com' },
  { id: 2, name: '이영희', email: 'younghee@example.com' },
  { id: 3, name: '박민수', email: 'minsu@example.com' },
];

// 동적 라우트 파라미터 타입을 위한 인터페이스
interface Context {
  params: { id: string };
}

/**
 * GET /api/users/[id] - 특정 사용자 조회
 */
export async function GET(request: NextRequest, context: Context) {
  const id = parseInt(context.params.id); // URL 파라미터 'id'를 정수로 변환

  const user = users.find(u => u.id === id);

  if (!user) {
    // 사용자를 찾지 못한 경우 404 Not Found 응답
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  // 성공적으로 사용자를 찾은 경우 200 OK 응답
  return NextResponse.json(user, { status: 200 });
}

/**
 * PUT /api/users/[id] - 특정 사용자 전체 업데이트
 */
export async function PUT(request: NextRequest, context: Context) {
  const id = parseInt(context.params.id); // URL 파라미터 'id'를 정수로 변환

  const body = await request.json(); // 요청 본문 파싱
  const { name, email } = body;

  // 입력 유효성 검사 (간단한 예시)
  if (!name || !email) {
    return NextResponse.json({ message: '이름과 이메일은 필수입니다.' }, { status: 400 });
  }

  const userIndex = users.findIndex(u => u.id === id);

  if (userIndex === -1) {
    // 사용자를 찾지 못한 경우 404 Not Found 응답
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  // 사용자 정보 업데이트 (불변성을 유지하며 새로운 배열 생성)
  users = users.map(user =>
    user.id === id ? { ...user, name, email } : user
  );

  // 업데이트된 사용자 정보와 함께 200 OK 응답
  return NextResponse.json(users[userIndex], { status: 200 });
}

/**
 * PATCH /api/users/[id] - 특정 사용자 부분 업데이트
 */
export async function PATCH(request: NextRequest, context: Context) {
  const id = parseInt(context.params.id);

  const body = await request.json(); // 요청 본문 파싱 (부분 업데이트 데이터)
  const { name, email } = body; // name 또는 email 중 하나만 있을 수 있음

  const userIndex = users.findIndex(u => u.id === id);

  if (userIndex === -1) {
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  // 기존 사용자 정보를 가져와서 전달된 필드만 업데이트
  const existingUser = users[userIndex];
  const updatedUser = {
    ...existingUser,
    ...(name && { name }), // name이 있으면 업데이트
    ...(email && { email }), // email이 있으면 업데이트
  };

  users[userIndex] = updatedUser; // 배열 직접 수정 또는 새로운 배열 생성 방식 선택

  return NextResponse.json(updatedUser, { status: 200 });
}


/**
 * DELETE /api/users/[id] - 특정 사용자 삭제
 */
export async function DELETE(request: NextRequest, context: Context) {
  const id = parseInt(context.params.id); // URL 파라미터 'id'를 정수로 변환

  const initialLength = users.length;
  // 사용자 삭제 (불변성을 유지하며 새로운 배열 생성)
  users = users.filter(u => u.id !== id);

  if (users.length === initialLength) {
    // 삭제할 사용자를 찾지 못한 경우 404 Not Found 응답
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  // 성공적으로 삭제된 경우 200 OK 또는 204 No Content 응답
  return NextResponse.json({ message: '사용자가 성공적으로 삭제되었습니다.' }, { status: 200 });
  // return new NextResponse(null, { status: 204 }); // 204는 본문이 없음
}