endpointهای REST حجم عظیمی از دادههای اضافی برمیگردانند، در حالی که مشتری فقط به چند فیلد نیاز دارد؟ GraphQL رویکرد را تغییر میدهد: یک endpoint، مشتری فقط آنچه را نیاز دارد درخواست میکند. طرح نوعبندی شده، subscriptions برای real-time، Apollo برای کشکردن. بدون overfetching و underfetching.
GraphQL یک زبان پرسوجو و محیط اجرا برای API با طرح نوعبندی شده است. یک endpoint، مشتری خودش تصمیم میگیرد کدام فیلدها و روابط را درخواست کند. بدون overfetching، بدون under-fetching. Queries برای خواندن، mutations برای نوشتن، subscriptions برای real-time.
طرح نوعبندی شده — Schema Definition Language (SDL). هر نوع، فیلد و آرگومان به شدت نوعبندی شده است. خطاها در مرحله کامپایل، نه در زمان اجرا. GraphQL به خوبی با React و Next.js کار میکند
یک endpoint — /graphql به جای دهها مسیر REST. همه درخواستها از طریق POST، دروننگری طرح مستقیماً از مرورگر از طریق GraphiQL یا Apollo Studio
Subscriptions (real-time) — اشتراکهای WebSocket برای تغییرات. چت، اعلانها، فید فعالیتها — همه چیز در زمان واقعی از طریق یک مکانیسم واحد
Apollo / Relay — کتابخانههای مشتری با کشکردن، بهروزرسانیهای خوشبینانه و تولید کد نوع
GraphQL · Schema · Queries · Mutations · Apollo
GraphQL یک زبان پرسوجوی اعلانی است. مشتری توضیح میدهد چه دادهای نیاز دارد و دقیقاً همان را دریافت میکند. حتی یک بایت اضافی هم نیست. نوعبندی دقیق، دروننگری، یک endpoint واحد.
انواع، رابطها، union-انواع، enums. اعتبارسنجی دقیق در سطح طرح. هر پرسوجو قبل از اجرا بررسی میشود — خطاها غیرممکن است.
Apollo Server با کشکردن و مجوزدهی. Apollo Client با InMemoryCache، بهروزرسانیهای خوشبینانه و تولید کد نوع از طرح.
subscriptions مبتنی بر WebSocket. بهروزرسانیهای فوری برای چتها، اعلانها، فید فعالیت و برنامههای مشارکتی.
GraphQL قوانین بازی را تغییر میدهد: اکنون مشتری خودش تعیین میکند چه دادهای دریافت کند. توسعهدهنده فرانتاند یک پرسوجو مینویسد و دقیقاً آنچه را برای صفحه نیاز دارد دریافت میکند. هیچ هماهنگی با بکاند برای هر فیلدی وجود ندارد.
GraphQL یک قرارداد بین مشتری و سرور بر اساس طرح دقیق است. ما با رویکرد schema-first طراحی میکنیم، انواع را به طور خودکار تولید میکنیم، هر resolver را تست میکنیم.
طراحی طرح — رویکرد Schema-first. ابتدا توضیحات SDL انواع، query و mutation root. مشتریان طرح را قبل از شروع توسعه سرور دریافت میکنند.
حلکنندهها و DataLoader — حلکنندههای کارآمد با دستهبندی از طریق DataLoader. مشکل N+1 به صورت معماری حل شده است، نه با راهحلهای موقت.
ترکیبی REST + GraphQL — REST را برای عملیاتهای ساده CRUD و GraphQL را برای پرسوجوهای پیچیده ترکیب میکنیم. احراز هویت و مجوزدهی یکپارچه.
Codegen و نوعبندی — GraphQL Codegen به طور خودکار انواع TypeScript را از طرح تولید میکند. کد مشتری کاملاً نوعبندی شده است، خطاها در مرحله کامپایل.
Subscriptions و real-time — WebSocket از طریق Apollo یا graphql-ws. چت، اعلانها، ویرایش مشارکتی — همه چیز در زمان واقعی.
GraphQL برای برنامههای موبایل — مشتری فقط فیلدهای مورد نیاز را درخواست میکند، بدون overfetching. ایدهآل برای iOS و Android با پهنای باند محدود.
توضیحات طرح → تولید انواع TypeScript، هوکهای React و مستندات. هیچ کپی دستی نیست. طرح را تغییر دادید — انواع به طور خودکار بهروز شدند.
سفارش GraphQL API — دریافت یک لایه داده انعطافپذیر، نوعبندی شده و با عملکرد بالا که توسعه فرانتاند را سرعت میبخشد و درخواستهای اضافی را حذف میکند.
طرح GraphQL را در SDL قبل از نوشتن حلکنندهها طراحی میکنیم. انواع، روابط، جهشها — فرانتاند از روز اول قرارداد آماده را میبیند.
تستهای واحد هر resolver، تستهای یکپارچهسازی طرح، استقرار خودکار با Apollo Studio. طرح مشتریان را در هنگام تغییرات خراب نمیکند.
مستندات تعاملی با قابلیت اجرای پرسوجوها مستقیماً در مرورگر. Subscriptions از طریق WebSocket در زمان واقعی.
GraphQL انعطافپذیری بدون هرجومرج است. مشتری دقیقاً آنچه را درخواست کرده دریافت میکند و سرور انواع و ساختار را تضمین میکند. فرانتاند و بکاند به طور مستقل توسعه مییابند اما سازگار میمانند — طرح نظم را حفظ میکند.
VKontakte
Gmail
