من اكثر المشاكل التي تواجهنا في REST APIs هي تعدد المسارات و نقص/زيادة البيانات عن حاجتها، صحيح؟ حسنا يمكننا الابتعاد عن هذا ! في عالم تطوير الواجهات الخلفية (Backend)، اعتدنا لسنوات طويلة على بناء واجهات برمجية باستخدام REST API، تكلمنا عن REST APIs سابقا هنا:
الفكرة بسيطة: نقوم بإنشاء عدة مسارات (Endpoints) مثل /users لجلب قائمة المستخدمين، أو /users/:id لجلب بيانات مستخدم محدد. ورغم أن هذا النموذج ما زال مستخدماً على نطاق واسع، إلا أنه يواجه بعض القيود مع تعقّد التطبيقات الحديثة.
هنا ظهر GraphQL، وهو عبارة عن لغة استعلام (Query Language) طوّرتها شركة فيسبوك عام 2015. المميز في GraphQL أنّه يسمح للعميل (Client) بطلب البيانات التي يحتاجها فقط، وبالشكل الذي يريده، دون الحاجة لإنشاء مسارات متعددة أو تحميل بيانات زائدة.
الفروقات بين GraphQL و REST API
- في REST:
- لكل نوع من البيانات أو العملية مسار محدد.
- قد يضطر العميل إلى استدعاء أكثر من Endpoint للحصول على البيانات المطلوبة.
- أحياناً يتم جلب بيانات أكثر من اللازم (Over-Fetching) أو بيانات أقل من اللازم (Under-Fetching).
- في GraphQL:
- يوجد Endpoint واحد فقط (عادة /graphql).
- العميل يحدد في الاستعلام ما هي الحقول التي يريدها تحديداً.
- يمكن دمج أكثر من كيان (Entity) في استعلام واحد، مما يقلل عدد الطلبات للشبكة.
مميزات GraphQL
طبعا كل تقنية لها ميزات وسيئات تجعلنا نستخدمها في بعض الاوقات والبعض الاخر نستخدم غيرها، لذا الان نأتي الى مميزات GraphQL والتي جعلت انتشارها يتوسع بشكل سريع:
- تحكم كامل بالبيانات: العميل لا يستقبل إلا ما طلبه فقط.
- تقليل عدد الطلبات: يمكن الحصول على بيانات معقدة من استعلام واحد.
- قابلية التوسع بسهولة: عند إضافة حقول جديدة لا يتأثر العملاء القدامى.
- أداة GraphiQL: واجهة رسومية لتجربة الاستعلامات بسهولة.
سلبيات GraphQL
لكن رغم قوته، إلا أن GraphQL ليس مثالياً دائماً، واحد اسباب ذلك وسلبياتها:
- تعقيد التنفيذ: يحتاج إلى إعدادات إضافية مقارنة بالـ REST.
- إدارة التخزين المؤقت (Caching) أصعب من REST، خاصة مع استعلامات معقدة.
- الإفراط في المرونة: إذا لم يُضبط بشكل جيد، قد يطلب العميل بيانات ضخمة تُرهق الخادم.
- غير مناسب لكل الحالات: أحياناً REST أبسط وأسرع للتطبيقات الصغيرة.
استخدامات GraphQL
حسنا وهذا كله يأتينا الى سؤال، متى نستخدم GraphQL؟ عند بناء تطبيقات أمامية (Frontend) معقدة تحتاج بيانات متعددة في نفس الشاشة (مثل تطبيقات الموبايل أو الـ Single Page Applications).
في المشاريع الكبيرة التي يتغير فيها هيكل البيانات باستمرار.
عندما نريد توفير تجربة مرنة للمطورين المستهلكين للـ API.
بينما قد يكون REST API أكثر من كافٍ في الأنظمة البسيطة أو الخدمات الصغيرة التي لا تتطلب مرونة عالية.
مثال كود بسيط في Node JS لتجربة GraphQL APIs
قم بانشاء بيئة NPM وتحميل المكتبات اللازمة:
- انشئ بيئة npm:
npm init -y
- حمل المكتبات:
npm install apollo-server graphql
انشئ ملف باسم schema.js واكتب به الكود التالي:
انشئ ملف باسم resolvers.js واكتب به الكود التالي:
انشئ ملف باسم index.js واكتب به الكود التالي:
لتجربة السيرفر:
- افتح على متصفحك الرابط التالي:
http://localhost:4000
- يمكنك تجربة الquery كالمثال التالي:
- يمكنك تجربة الmutation كالمثال التالي:
طبعا كما قلنا يمكنك جلب البيانات التي تحتاجها فقط، اي مثلا في الquery السابق يمكنك جلب ال id وال name فقط او اي بيانات تريدها، لا تحتاج لجلب البيانات او ب اي ترتيب محدد.
يمكنك تحميل الكود السابق كاملا مباشرة من الرابط التالي:
https://drive.google.com/file/d/1yV7StvHYqyJluvD__kzGsqcVQVVwe-Bv/view?usp=sharing
طبعا GraphQL ليس بديلاً كاملاً لـ REST، بل هو خيار آخر يعتمد على طبيعة مشروعك. إذا كان مشروعك يتطلب مرونة كبيرة، واستعلامات معقدة، وتجربة غنية على الواجهة الأمامية، فإن GraphQL سيكون أداة قوية جداً. أما إذا كان التطبيق بسيطاً بعدد محدود من البيانات، فقد يكون REST الخيار الأمثل والأسرع للتنفيذ.