ویرگول
ورودثبت نام
مصطفی رستگار
مصطفی رستگاربرنامه نویس کامپیوتر و ازین جور مسخره بازی ها!
مصطفی رستگار
مصطفی رستگار
خواندن ۸ دقیقه·۳ ماه پیش

نوشتن crud ساده با nextjs (prisma, zod, route handlers)

یک مثال کامل و روان از CRUD (Create, Read, Update, Delete) برای موجودیت Category در Next.js App Router با Route Handlers آماده کردم. فرض می‌کنیم از Prisma به عنوان ORM استفاده می‌کنیم و اعتبارسنجی با Zod انجام می‌شود.


ساختار فایل‌ها

text

app/ ├── api/ │ └── categories/ │ ├── route.ts // GET (لیست همه) + POST (ساخت جدید) │ └── [id]/ │ └── route.ts // GET (یک مورد) + PUT (بروزرسانی) + DELETE (حذف) ├── lib/ │ ├── prisma.ts // کلاینت Prisma │ └── validations/ │ └── category.ts // اسکیماهای Zod

۱. اسکیماهای اعتبارسنجی (Zod)

lib/validations/category.ts

typescript

import { z } from "zod"; // اسکیما برای ساخت و بروزرسانی export const categorySchema = z.object({ name: z.string().min(2, "نام دسته‌بندی حداقل ۲ کاراکتر باشد"), description: z.string().optional(), slug: z.string().min(2, "اسلاگ حداقل ۲ کاراکتر باشد"), parentId: z.string().uuid("آیدی والد نامعتبر است").optional().nullable(), isActive: z.boolean().default(true), order: z.number().int().min(0).default(0), }); // تایپ استخراج شده از اسکیما (برای TypeScript) export type CategoryInput = z.infer<typeof categorySchema>; // اسکیما برای آپدیت (همه فیلدها آپشنال) export const categoryUpdateSchema = categorySchema.partial();

۲. Route Handler اصلی (همه دسته‌بندی‌ها)

app/api/categories/route.ts

typescript

import { NextRequest, NextResponse } from "next/server"; import { prisma } from "@/lib/prisma"; import { categorySchema, type CategoryInput } from "@/lib/validations/category"; import { z } from "zod"; // ============================================ // GET: دریافت لیست همه دسته‌بندی‌ها (با فیلتر و مرتب‌سازی) // ============================================ export async function GET(request: NextRequest) { try { // دریافت پارامترهای کوئری (مثلاً برای فیلتر یا صفحه‌بندی) const searchParams = request.nextUrl.searchParams; const page = parseInt(searchParams.get("page") || "1"); const limit = parseInt(searchParams.get("limit") || "10"); const isActive = searchParams.get("isActive"); const search = searchParams.get("search"); // ساخت شرط‌های فیلتر const where: any = {}; if (isActive !== null) { where.isActive = isActive === "true"; } if (search) { where.OR = [ { name: { contains: search, mode: "insensitive" } }, { slug: { contains: search, mode: "insensitive" } }, ]; } // دریافت داده‌ها از دیتابیس const [categories, totalCount] = await Promise.all([ prisma.category.findMany({ where, skip: (page - 1) * limit, take: limit, orderBy: { order: "asc" }, include: { parent: { select: { id: true, name: true, slug: true, }, }, children: { select: { id: true, name: true, slug: true, }, take: 5, // فقط ۵ فرزند اول برای جلوگیری از سنگین شدن }, _count: { select: { children: true, products: true }, }, }, }), prisma.category.count({ where }), ]); return NextResponse.json( { data: categories, pagination: { page, limit, totalCount, totalPages: Math.ceil(totalCount / limit), }, }, { status: 200 } ); } catch (error) { console.error("Error in GET /api/categories:", error); return NextResponse.json( { message: "خطا در دریافت دسته‌بندی‌ها" }, { status: 500 } ); } } // ============================================ // POST: ایجاد دسته‌بندی جدید // ============================================ export async function POST(request: NextRequest) { try { // ۱. دریافت و پارس کردن بدنه const body = await request.json(); // ۲. اعتبارسنجی با Zod const result = categorySchema.safeParse(body); if (!result.success) { return NextResponse.json( { message: "داده‌های ارسالی نامعتبر هستند", errors: result.error.issues.map((issue) => ({ field: issue.path.join("."), message: issue.message, })), }, { status: 400 } ); } const data: CategoryInput = result.data; // ۳. بررسی یکتا بودن اسلاگ const existingCategory = await prisma.category.findUnique({ where: { slug: data.slug }, }); if (existingCategory) { return NextResponse.json( { message: "این اسلاگ قبلاً استفاده شده است" }, { status: 409 } // Conflict ); } // ۴. بررسی وجود والد (اگر parentId ارسال شده) if (data.parentId) { const parent = await prisma.category.findUnique({ where: { id: data.parentId }, }); if (!parent) { return NextResponse.json( { message: "دسته‌بندی والد وجود ندارد" }, { status: 404 } ); } } // ۵. ایجاد در دیتابیس const newCategory = await prisma.category.create({ data: { name: data.name, description: data.description || null, slug: data.slug, parentId: data.parentId || null, isActive: data.isActive ?? true, order: data.order ?? 0, }, include: { parent: true, }, }); // ۶. پاسخ موفق return NextResponse.json( { message: "دسته‌بندی با موفقیت ایجاد شد", data: newCategory, }, { status: 201 } ); } catch (error) { console.error("Error in POST /api/categories:", error); return NextResponse.json( { message: "خطای داخلی سرور" }, { status: 500 } ); } }

۳. Route Handler برای یک دسته‌بندی خاص (با آیدی)

app/api/categories/[id]/route.ts

typescript

import { NextRequest, NextResponse } from "next/server"; import { prisma } from "@/lib/prisma"; import { categoryUpdateSchema } from "@/lib/validations/category"; // ============================================ // GET: دریافت یک دسته‌بندی با آیدی // ============================================ export async function GET( request: NextRequest, { params }: { params: { id: string } } ) { try { const { id } = params; // بررسی وجود دسته‌بندی const category = await prisma.category.findUnique({ where: { id }, include: { parent: { select: { id: true, name: true, slug: true, }, }, children: { select: { id: true, name: true, slug: true, isActive: true, }, orderBy: { order: "asc" }, }, _count: { select: { products: true }, }, }, }); if (!category) { return NextResponse.json( { message: "دسته‌بندی مورد نظر یافت نشد" }, { status: 404 } ); } return NextResponse.json({ data: category }, { status: 200 }); } catch (error) { console.error("Error in GET /api/categories/[id]:", error); return NextResponse.json( { message: "خطا در دریافت دسته‌بندی" }, { status: 500 } ); } } // ============================================ // PUT: بروزرسانی کامل یا جزئی دسته‌بندی // ============================================ export async function PUT( request: NextRequest, { params }: { params: { id: string } } ) { try { const { id } = params; // ۱. بررسی وجود دسته‌بندی const existingCategory = await prisma.category.findUnique({ where: { id }, }); if (!existingCategory) { return NextResponse.json( { message: "دسته‌بندی مورد نظر یافت نشد" }, { status: 404 } ); } // ۲. دریافت و اعتبارسنجی داده‌ها const body = await request.json(); const result = categoryUpdateSchema.safeParse(body); if (!result.success) { return NextResponse.json( { message: "داده‌های ارسالی نامعتبر هستند", errors: result.error.issues.map((issue) => ({ field: issue.path.join("."), message: issue.message, })), }, { status: 400 } ); } const data = result.data; // ۳. بررسی یکتا بودن اسلاگ (اگر تغییر کرده) if (data.slug && data.slug !== existingCategory.slug) { const slugExists = await prisma.category.findUnique({ where: { slug: data.slug }, }); if (slugExists) { return NextResponse.json( { message: "این اسلاگ قبلاً استفاده شده است" }, { status: 409 } ); } } // ۴. جلوگیری از اینکه خودش والد خودش شود! if (data.parentId && data.parentId === id) { return NextResponse.json( { message: "یک دسته‌بندی نمی‌تواند والد خودش باشد" }, { status: 400 } ); } // ۵. بررسی وجود والد جدید (اگر تغییر کرده) if (data.parentId && data.parentId !== existingCategory.parentId) { const parent = await prisma.category.findUnique({ where: { id: data.parentId }, }); if (!parent) { return NextResponse.json( { message: "دسته‌بندی والد وجود ندارد" }, { status: 404 } ); } } // ۶. بروزرسانی در دیتابیس const updatedCategory = await prisma.category.update({ where: { id }, data: { name: data.name, description: data.description, slug: data.slug, parentId: data.parentId, isActive: data.isActive, order: data.order, }, include: { parent: true, children: { select: { id: true, name: true, slug: true, }, }, }, }); return NextResponse.json( { message: "دسته‌بندی با موفقیت بروزرسانی شد", data: updatedCategory, }, { status: 200 } ); } catch (error) { console.error("Error in PUT /api/categories/[id]:", error); return NextResponse.json( { message: "خطای داخلی سرور" }, { status: 500 } ); } } // ============================================ // DELETE: حذف دسته‌بندی (با بررسی وابستگی‌ها) // ============================================ export async function DELETE( request: NextRequest, { params }: { params: { id: string } } ) { try { const { id } = params; // ۱. بررسی وجود دسته‌بندی const category = await prisma.category.findUnique({ where: { id }, include: { _count: { select: { children: true, products: true, }, }, }, }); if (!category) { return NextResponse.json( { message: "دسته‌بندی مورد نظر یافت نشد" }, { status: 404 } ); } // ۲. بررسی وابستگی‌ها (اگر فرزند یا محصول دارد) if (category._count.children > 0) { return NextResponse.json( { message: "این دسته‌بندی دارای زیردسته است. ابتدا زیردسته‌ها را حذف کنید", childrenCount: category._count.children, }, { status: 409 } // Conflict ); } if (category._count.products > 0) { return NextResponse.json( { message: "این دسته‌بندی دارای محصول است. ابتدا محصولات را جابجا یا حذف کنید", productsCount: category._count.products, }, { status: 409 } ); } // ۳. حذف از دیتابیس await prisma.category.delete({ where: { id }, }); return NextResponse.json( { message: "دسته‌بندی با موفقیت حذف شد", deletedId: id, }, { status: 200 } ); } catch (error) { console.error("Error in DELETE /api/categories/[id]:", error); return NextResponse.json( { message: "خطای داخلی سرور" }, { status: 500 } ); } }

۴. مثال Prisma Schema (برای مرجع)

prisma/schema.prisma

prisma

model Category { id String @id @default(cuid()) name String description String? slug String @unique isActive Boolean @default(true) order Int @default(0) parentId String? createdAt DateTime @default(now()) updatedAt DateTime @updatedAt parent Category? @relation("CategoryParent", fields: [parentId], references: [id]) children Category[] @relation("CategoryParent") products Product[] @@index([parentId]) @@index([slug]) @@index([isActive]) }

نکات مهم برای مصاحبه (برای درخشیدن بیشتر)

  1. مدیریت خطاهای معنادار: به جای try-catch کلی، خطاهای خاص مثل 409 Conflict برای تکراری بودن یا وابستگی‌ها برگردانده می‌شود.

  2. اعتبارسنجی دو مرحله‌ای: اول Zod برای ساختار داده، سپس چک‌های Business Logic مثل یکتا بودن اسلاگ یا وجود والد.

  3. بهینه‌سازی کوئری‌ها: استفاده از include برای روابط و select برای فیلدهای خاص (کم کردن حجم پاسخ).

  4. صفحه‌بندی و فیلتر: در GET همه دسته‌بندی‌ها، قابلیت جستجو، فیلتر و صفحه‌بندی پیاده‌سازی شده.

  5. جلوگیری از خطاهای منطقی: مثل جلوگیری از اینکه یک دسته‌بندی، والد خودش شود.

  6. حذف ایمن: قبل از حذف، وابستگی‌ها (فرزندان و محصولات) چک می‌شوند تا از خطای دیتابیس جلوگیری شود.

  7. استفاده از Promise.all: برای کوئری‌های موازی (مثل دریافت لیست و تعداد کل) برای بهبود performance.


خلاصه برای گفتن در مصاحبه

"برای پیاده‌سازی CRUD دسته‌بندی، از Route Handlerهای Next.js استفاده کردم. در مسیر api/categories، متد GET لیست با صفحه‌بندی و فیلتر و متد POST برای ایجاد جدید. در مسیر api/categories/[id]، متد GET برای دریافت یک مورد، PUT برای بروزرسانی (با اعتبارسنجی جزئی با partial()) و DELETE با چک وابستگی‌ها. همه ورودی‌ها با Zod اعتبارسنجی می‌شوند و خطاهای واضح به کلاینت برمی‌گردد. همچنین از Prisma برای ارتباط با دیتابیس و مدیریت روابط (والد-فرزند) استفاده کردم."


nextjs
۰
۰
مصطفی رستگار
مصطفی رستگار
برنامه نویس کامپیوتر و ازین جور مسخره بازی ها!
شاید از این پست‌ها خوشتان بیاید