GraphQL

باستخدام GraphQL، يتم نمذجة مجال الأعمال كرسم بياني من خلال تحديد مخطط؛ ضمن هذا المخطط، يتم تعريف أنواع مختلفة من العقد وعلاقاتها. ^{[ 13 ]}

يصف نظام أنواع GraphQL البيانات التي يمكن الاستعلام عنها من واجهة برمجة التطبيقات (API). وتُعرف مجموعة هذه الإمكانيات باسم مخطط الخدمة ، ويمكن للعملاء استخدام هذا المخطط لإرسال استعلامات إلى واجهة برمجة التطبيقات (API) تُعيد نتائج متوقعة. ^{[ 14 ]}

يحتوي النوع الأساسي لمخطط GraphQL، Queryافتراضيًا، على جميع الحقول التي يمكن الاستعلام عنها. وتُحدد الأنواع الأخرى الكائنات والحقول التي يمكن لخادم GraphQL إرجاعها. وهناك عدة أنواع أساسية، تُسمى أنواعًا قياسية، لتمثيل أشياء مثل السلاسل النصية والأرقام والمعرفات.

تُعرَّف الحقول افتراضيًا على أنها تقبل القيم الفارغة ، ويمكن استخدام علامة تعجب في نهاية الحقل لجعله غير قابل للقيم الفارغة (إلزامي). ويمكن تعريف الحقل كقائمة عن طريق وضع نوع الحقل بين قوسين مربعين (على سبيل المثال، authors: [String]). ^{[ 15 ]}

نوع الاستعلام { المستخدم الحالي : المستخدم }نوع المستخدم { المعرف : ID ! الاسم : سلسلة ! }

يحدد استعلام GraphQL الشكل الدقيق للبيانات التي يحتاجها العميل.

استعلام عن المستخدم الحالي { المستخدم الحالي { الاسم العمر } }

بمجرد التحقق من صحة البيانات وتنفيذها بواسطة خادم GraphQL، يتم إرجاعها بنفس الشكل.

{ "currentUser" : { "name" : "John Doe" , "age" : 23 } }

تتيح عملية التعديل في GraphQL إنشاء البيانات أو تحديثها أو حذفها. تحتوي عمليات التعديل عادةً على متغيرات ، تسمح بتمرير البيانات من العميل إلى الخادم. كما تحدد عملية التعديل شكل البيانات التي ستُعاد إلى العميل بعد اكتمال العملية.

mutation CreateUser ( $name : String !, $age : Int !) { createUser ( userName : $name , age : $age ) { name age } }

يتم تمرير المتغيرات ككائن يحتوي على حقول تطابق أسماء المتغيرات في عملية التغيير.

{ "name" : "هان سولو" , "age" : 42 }

بمجرد اكتمال العملية، سيعيد خادم GraphQL البيانات المطابقة للشكل المحدد بواسطة التغيير.

{ "data" : { "createUser" : { "name" : "Han Solo" , "age" : 42 } } }

يدعم GraphQL أيضًا التحديثات المباشرة المرسلة من الخادم إلى العميل في عملية تُسمى الاشتراك. وكما ذكرنا سابقًا، يُحدد العميل شكل البيانات التي يحتاجها عند إجراء أي تحديث.

الاشتراك { شخص جديد { الاسم العمر } }

عند إجراء تغيير من خلال خادم GraphQL يقوم بتحديث الحقل المرتبط، يتم إرسال البيانات إلى جميع العملاء المشتركين بالتنسيق المحدد من خلال الاشتراك.

{ "newPerson" : { "name" : "Jane" , "age" : 23 } }

على الرغم من عدم وجود ما يمنع ترقيم إصدارات خدمة GraphQL تمامًا مثل أي واجهة برمجة تطبيقات أخرى، إلا أن GraphQL تتخذ موقفًا قويًا بشأن تجنب ترقيم الإصدارات من خلال توفير الأدوات اللازمة للتطوير المستمر لمخطط GraphQL. ^{[ 16 ]}

يُستخدم التوجيه @deprecatedالمدمج ضمن لغة تعريف نظام الأنواع للإشارة إلى الأجزاء المهملة من مخطط خدمة GraphQL، مثل الحقول المهملة في نوع ما أو قيم التعداد المهملة. ^{[ 15 ]}

لا تُعيد GraphQL إلا البيانات المطلوبة صراحةً، لذا يُمكن إضافة إمكانيات جديدة عبر أنواع جديدة أو حقول جديدة في الأنواع الموجودة دون إحداث تغييرات جذرية. وقد أدّى ذلك إلى ممارسة شائعة تتمثل في تجنّب التغييرات الجذرية وتقديم واجهة برمجة تطبيقات غير مرتبطة بإصدار. ^{[ 16 ]}

لا توفر GraphQL لغة استعلام رسومية متكاملة مثل SPARQL ، ولا حتى لهجات SQL التي تدعم الإغلاق المتعدي . على سبيل المثال، لا يمكن لواجهة GraphQL التي تُبلغ عن آباء فرد ما أن تُرجع، في استعلام واحد، مجموعة جميع أسلافه.