زبان پرسوجو از API که کلاینت دقیقاً همان دادهای را میگیرد که میخواهد؛ نه بیشتر نه کمتر. اگر تازه با این موضوع آشنا شدهاید، این صفحه دقیقاً برای شما نوشته شده است؛ بدون فرضِ دانش قبلی. برای اپهایی با صفحات متفاوت (موبایل/وب)، یک اندپوینت گرافکیوال از ده اندپوینت سفارشی بهتر جواب میدهد.
چرا مبتدیها گیج میشوند؟
چون بیشتر راهنماها برای کسانی نوشته شده که از قبل نیمی از مسیر را رفتهاند. ما در این صفحه از همان نقطهٔ صفر شروع میکنیم: زبان پرسوجو از API که کلاینت دقیقاً همان دادهای را میگیرد که میخواهد؛ نه بیشتر نه کمتر.
پنج قدم اولِ شما
- مسئله را در یک جمله برای خودتان تعریف کنید
- از سادهترین منبع شروع کنید: Apollo
- از توابع resolver کوچک شروع کنید
- برای فیلدهای سنگین، از DataLoader برای جلوگیری از N+1 استفاده کنید
- کوئریهای کلاینت را با عملیات نامدار ثبت کنید
واژههایی که باید بشناسید
- گرافکیوال در یک نگاه؛ در یک جمله: زبان پرسوجو از API که کلاینت دقیقاً همان دادهای را میگیرد که میخواهد
- کجا نمیارزد — CRUD ساده با دو سه جدول؛ REST صریحتر و سادهتر است.
- کش میشود — کش HTTP کلاسیک سختتر میشود؛ persistent query راهحل عملی است.
سه نصیحت طلایی برای شروع
- عمق کوئری را محدود کنید (حفاظت در برابر کوئریهای انفجاری)
- اشتراکت (subscription) را فقط برای بلادرنگِ واقعی بکار ببرید
چیزهایی که لازم نیست نگرانشان باشید
مبتدیها معمولاً این نگرانیها را دارند و وقتشان را میگیرد:
- نگرانی «قراردادن کل منطق در یک resolver غولپیکر» — معمولاً درست نیست و فقط شروع را عقب میاندازد
- نگرانی «بیاحتیاطی در عمق و هزینهٔ کوئریهای آزاد» — معمولاً درست نیست و فقط شروع را عقب میاندازد
- نگرانی «استفاده از گرافکیوال چون «جدیده» برای یک فرم ساده» — معمولاً درست نیست و فقط شروع را عقب میاندازد
منابع سادهٔ شروع
| منبع / ابزار | چه استفادهای؟ |
|---|---|
| Apollo | کلاینت و سرور کامل |
| GraphQL Playground | آزمایش تعاملی |
| Relay | کلاینت فیسبوکی مقیاس بزرگ |
| codegen | تولید تایپ از اسکیما |
پرسشهای خودِ مبتدیها
کجا نمیارزد؟
CRUD ساده با دو سه جدول؛ REST صریحتر و سادهتر است.
کش میشود؟
کش HTTP کلاسیک سختتر میشود؛ persistent query راهحل عملی است.
امنیت؟
همان قواعد: احراز هویت، اعتبارسنجی و محدودسازی عمق/هزینه.
جمعبندی
گرافکیوال در یک نگاه را وقتی درست به کار بگیرید، هم زمان میدهد و هم کیفیت. مسیر ساده بود: شروع کنید، اندازه بگیرید و اصلاح کنید. اگر همین امروز دو سه مورد از این فهرست را اجرا کنید، تفاوت را در هفتههای بعد خواهید دید.
دیدگاهها
۰ دیدگاههنوز دیدگاهی ثبت نشده؛ اولین نفر باشید.