صفحه طراحی دیتابیس و کلاس
نویسنده: علی محمدی (کارشناس دیجیتال مارکتینگ)
آخرین بروزرسانی: ۲۱ شهریور ۱۴۰۵
در این صفحه می‌توانید ساختار دیتابیس و کلاس‌های پروژه خودتان را بدون نیاز به کدنویسی مستقیم بسازید و مدیریت کنید. معمولاً یک پروژه بزرگ از چند بخش یا ماژول مستقل تشکیل می‌شود (مثلاً بخش کاربران، بخش محصولات و…) که هرکدام مدل‌ها و کلاس‌های مخصوص به خودشان را دارند؛ این صفحه به شما کمک می‌کند این ساختار را به‌صورت منظم و بدون کدنویسی طراحی کنید. کار با این صفحه از چند قدم ساده تشکیل شده که در ادامه یکی‌یکی توضیح داده شده‌اند.
۱. ساخت دایرکتوری (پوشه)
اولین کاری که باید انجام دهید، ساختن یک دایرکتوری (پوشه) است. برای این کار:
- روی دکمه «+ افزودن دایرکتوری» در بالای نوار سمت راست صفحه کلیک کنید.
- یک نام برای دایرکتوری وارد کنید.
- بعد از تایید، دایرکتوری شما به‌صورت یک پوشه در لیست پایین همان نوار اضافه می‌شود.
۲. ساخت فایل داخل دایرکتوری
بعد از ساخت دایرکتوری، نوبت به ساخت فایل داخل آن می‌رسد:
- کنار نام هر دایرکتوری، یک آیکون «+» وجود دارد؛ با کلیک روی آن می‌توانید یک فایل جدید داخل همان دایرکتوری بسازید.
- برای هر فایل باید یک نام و یک نوع مشخص کنید. انواع فایل عبارت‌اند از: مدل، انتیتی، اسکیما، کلاس، کنترلر، کلاس سرویس، میدلور، ریزالور، ریپازیتوری، سریالایزر، ولیدیتور و دی‌تی‌او.
- پیشنهاد می‌شود در قدم اول یک فایل از نوع «مدل» بسازید و بقیه انواع فایل را در ادامه، بر اساس نیاز پروژه، اضافه کنید.
نمونه‌ای از یک دایرکتوری و چند فایل داخل آن در لیست
۳. فیلتر کردن فایل‌ها
در بالای لیست فایل‌ها، چهار برچسب کوچک رنگی دیده می‌شود که برای دسته‌بندی و فیلتر کردن فایل‌ها استفاده می‌شوند:
- M → مدل‌ها: همان جدول‌های دیتابیس و ساختار داده‌های پروژه
- C → کلاس‌ها: منطق برنامه و پردازش‌هایی که روی داده‌ها انجام می‌شود
- A → ای‌پی‌آی‌ها (API): وب‌سرویس‌ها و Endpointهایی که با متدهایی مثل GET و POST فراخوانی می‌شوند
- S → سریالایزرها: بخشی که داده‌های ورودی و خروجی API را اعتبارسنجی و فرمت‌دهی می‌کند
با کلیک روی هرکدام از این برچسب‌ها، فقط فایل‌های همان دسته در لیست نمایش داده می‌شوند. اگر بخواهید همه فایل‌ها را با هم ببینید، کافی است گزینه «همه» را انتخاب کنید. همچنین می‌توانید از نوار جست‌وجوی بالای لیست هم برای پیدا کردن سریع یک فایل با نام آن استفاده کنید.
۴. افزودن فیلد به مدل
بعد از ساخت یک فایل از نوع «مدل»، می‌توانید فیلدهای موردنیاز آن را اضافه کنید:
- روی دکمه «+ افزودن فیلد» کنار همان مدل کلیک کنید.
- در پنجره‌ای که باز می‌شود، یک نام برای فیلد وارد کنید.
- سپس نوع فیلد را از لیست انتخاب کنید. انواع فیلد عبارت‌اند از: String، Text، Integer، Float، Boolean، DateTime، Date، Time، JSON، ForeignKey، Enum، FileField، Dict، List، email و BigInteger.
- در پایان روی دکمه «تایید» کلیک کنید تا فیلد ساخته شود.
۵. ادامه مسیر کار
بعد از ساخت مدل و فیلدهای آن، مسیر طبیعی ادامه کار به این شکل است:
- یک فایل از نوع کلاس بسازید تا منطق و پردازش‌های مربوط به همان مدل را داخل آن بنویسید.
- در صورت نیاز، یک سریالایزر اضافه کنید تا داده‌های ورودی و خروجی اعتبارسنجی و فرمت‌دهی شوند.
- در پایان، فایل‌های نوع API را بسازید تا سرویس‌ها و Endpointهای قابل فراخوانی (مثل GET و POST) تعریف شوند.
سایر انواع فایل مثل کنترلر، ریپازیتوری و ولیدیتور را هم می‌توانید همین‌طور و بر اساس نیاز پروژه، در همین مسیر اضافه کنید.
