إدخال JSON

مخرجات Ruby

ما هو محوّل JSON إلى Ruby؟

إذا كنت تبني عميل API لـ Rails أو سكريبت Ruby يستدعي خدمة خارجية، ستحصل على JSON. وما لم تكن تريد التعامل مع hashes خام في كل مكان، فأنت بحاجة إلى كلاسات Ruby مع accessors مناسبة للخصائص. مواصفة JSON واضحة وبسيطة، لكن Ruby تحتاج إلى تعريفات كلاسات صريحة للعمل مع البيانات المكتوبة — هذه الأداة تُنشئها تلقائياً.

تُولِّد هذه الأداة كلاسات Ruby من JSON. فعِّل attr_accessor للحصول على دوال getter/setter. يستخدم المخرج snake_case لأسماء الخصائص وفق اصطلاحات Ruby.

تتم عملية التحويل بالكامل في المتصفح. لا يُرسل JSON إلى أي خادم.

متى يكون تحويل JSON إلى Ruby مفيداً

عند بناء تطبيقات Rails أو Ruby التي تستهلك واجهات REST البرمجية وتحتاج إلى كلاسات مكتوبة. الصق استجابة نموذجية هنا لتوليد الكلاسات المناسبة.

كيفية استخدام هذه الأداة

1

الصق أو ارفع JSON

انسخ JSON والصقه في المحرر الأيسر. يمكنك أيضاً النقر على رفع الملف لتحميل ملف. استخدم زر تحميل مثال للحصول على بيانات اختبارية. حدد اسم الكلاس والخيارات في لوحة الإعداد.

2

مراجعة الكلاسات المُولَّدة

تعرض اللوحة اليمنى كلاسات Ruby المُولَّدة. تصبح الكائنات المتداخلة كلاسات منفصلة. إذا كانت بنية JSON غير صالحة، استخدم أولاً منسق JSON أو التحقق من JSON لإصلاحها.

3

نسخ أو تنزيل

استخدم نسخ أو تنزيل للحصول على الكود. الصقه في مشروع Rails أو Ruby الخاص بك.

أمثلة JSON إلى Ruby

مثال على توليد كلاسات Ruby من كائن JSON.

مثال: سجل مشترك

إدخال JSON:

إدخال JSON

مخرجات Ruby المُولَّدة:

المخرجات

متى يكون تحويل JSON إلى Ruby مفيداً

يحتاج معظم المطورين إلى هذا عند دمج واجهات REST البرمجية. الصق هنا واحصل على كلاسات Ruby للاستخدام مع JSON.parse.

إذا كنت بحاجة إلى دمج ملفين JSON أولاً، استخدم أداة دمج JSON المنفصلة لذلك.

كثيراً ما تكون استجابات الواجهات البرمجية أو ملفات الإعداد أو صادرات البيانات بصيغة JSON. شغِّلها هنا لتوليد كلاسات Ruby.

الأسئلة الشائعة

كيف أُجري تحليل JSON في كلاس Ruby؟

استدع JSON.parse(json_string) للحصول على Hash، ثم قم بربط المفاتيح بخصائص الكلاس في المُهيِّئ. نهج أسرع: أنشئ كلاس Ruby هنا — الصق JSON الخاص بك، انسخ الناتج وأضف مُهيِّئاً يربط مفاتيح الـ hash بحقول attr_accessor.

ما هو attr_accessor في Ruby؟

attr_accessor يُنشئ كلاً من طريقة getter وطريقة setter لمتغير نسخة. إنه مكافئ Ruby لخاصية عامة. استخدم attr_reader للقراءة فقط أو attr_writer للكتابة فقط عندما تريد تقييد الوصول.

كيف أتعامل مع تسمية مفاتيح JSON في Ruby؟

اتفاقية Ruby هي snake_case، لكن JSON غالباً يستخدم camelCase. يُحوِّل المولد إلى snake_case تلقائياً. في وقت التشغيل، استخدم JSON.parse(json_string, symbolize_names: true) أو مكتبة مثل HashWithIndifferentAccess في Rails للوصول المرن إلى المفاتيح.

هل يُرسَل JSON الخاص بي إلى خادم؟

لا. يعمل توليد الكلاسات بالكامل في متصفحك. لا يغادر JSON الخاص بك جهازك أبداً.

ماذا عن كائنات JSON المتداخلة؟

تصبح كائنات JSON المتداخلة كلاسات Ruby منفصلة. تصبح المصفوفات مصفوفات من نسخ تلك الكلاسات. يمكنك إنشاء نسخ من الكلاسات المتداخلة في مُهيِّئ الكلاس الأصلي لنمذجة بنية JSON بشكل كامل.

أدوات ذات صلة

Ruby JSON — انظر JSON. JSON — انظر مواصفة JSON. Rails — انظر Rails.