إدخال JSON

مخرجات Java

ما هو تحويل JSON إلى Java؟

تستخدم Java كائنات POJO (Plain Old Java Objects) للبيانات المنظمة. عند استهلاك JSON باستخدام Jackson أو Gson، تحتاج إلى كلاسات Java مطابقة بأسماء الحقول والأنواع الصحيحة. تُعرِّف مواصفة JSON الكائنات والمصفوفات والنصوص والأرقام والقيم المنطقية — لكن Java تحتاج إلى تعريفات كلاسات صريحة لكل كائن متداخل.

تُولِّد هذه الأداة كائنات Java POJO من بيانات JSON الخاصة بك. حدد اسم الحزمة والكلاس في لوحة الإعداد. فعِّل Lombok للحصول على @Data أو @Getter/@Setter لتقليل الكود النمطي. فعِّل أنواع Nullable للحصول على Optional<T> أو @Nullable على الحقول الاختيارية. يعمل المخرج مع ObjectMapper.readValue() (Jackson) أو Gson.fromJson().

تعمل عملية التحويل بالكامل في متصفحك. لا يتم إرسال بيانات JSON الخاصة بك إلى أي خادم. يمكنك التحقق من ذلك بفتح تبويب الشبكة في متصفحك أثناء استخدام الأداة.

متى يساعد تحويل JSON إلى Java

عند بناء تطبيقات Spring Boot أو Android أو أي تطبيق Java يستهلك واجهات REST البرمجية، تحتاج إلى كائنات POJO مكتوبة بنوع محدد. استخدم Jackson أو Gson للتحليل. الصق استجابة نموذجية هنا لتوليد الكلاسات المطابقة.

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

الصق أو ارفع JSON

انسخ JSON الخاص بك والصقه في المحرر الأيسر. يمكنك أيضاً النقر على رفع الملف لتحميل ملف .json أو .txt. استخدم زر تحميل مثال لتحميل بيانات نموذجية. في لوحة الإعداد، حدد اسم الحزمة (مثل com.example.model) واسم الكلاس (مثل User). فعِّل Lombok للحصول على @Data أو @Getter/@Setter لتقليل الكود النمطي.

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

تعرض اللوحة اليمنى كلاسات Java المُولَّدة. تصبح الكائنات المتداخلة كلاسات داخلية أو منفصلة. تصبح المصفوفات <code>List<T></code>. أضف <code>@JsonProperty</code> (Jackson) أو <code>@SerializedName</code> (Gson) إذا اختلفت مفاتيح JSON عن أسماء حقول Java. إذا كان JSON يحتوي على أخطاء نحوية، صحِّحها أولاً باستخدام منسق JSON أو التحقق من JSON.

نسخ أو تنزيل

استخدم نسخ لوضع النتيجة في الحافظة، أو تنزيل لحفظها كملف .java. الصقها في مشروعك.

أمثلة JSON إلى Java

إليك مثالاً على توليد كلاسات Java POJO من كائن JSON.

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

إدخال JSON:

إدخال JSON

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

المخرجات

متى يساعد تحويل JSON إلى Java

يحتاج معظم المطورين إلى هذا عند الدمج مع واجهات REST البرمجية. ترسل طلباً عبر Postman أو RestTemplate الخاص بـ Spring أو HttpClient، وتأتي الاستجابة بصيغة JSON. لصقها هنا يمنحك كائنات POJO مكتوبة يمكن استخدامها فوراً مع Jackson أو Gson.

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

كثيراً ما تكون صادرات قواعد البيانات أو ملفات الإعداد أو حمولات الأحداث بصيغة JSON. تشغيلها عبر هذه الأداة يساعدك على فهم البنية وتوليد كلاسات Java لنصوص الاستيراد أو مستهلكي الرسائل أو طبقات الثبات.

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

Lombok أم getters/setters يدوية؟

يُولِّد Lombok الـ getters والـ setters والمُنشِئات وequals/hashCode في وقت الترجمة. يقلل بشكل كبير من الكود النمطي. يتطلب وجود Lombok في الـ classpath وتفعيل معالجة التعليقات التوضيحية.

Jackson مقابل Gson؟

كلتاهما تعمل مع كائنات POJO المُولَّدة. تستخدم Jackson @JsonProperty لأسماء المفاتيح المخصصة؛ وتستخدم Gson @SerializedName. يُنتج المولِّد عادةً مخرجاً متوافقاً مع Jackson.

هل يتم إرسال بياناتي إلى أي مكان؟

لا. تعمل عملية التوليد بالكامل في متصفحك باستخدام JavaScript. لا يتم إرسال أي بيانات إلى أي خادم. يمكنك التحقق من ذلك بفتح تبويب الشبكة في متصفحك أثناء استخدام الأداة.

أنواع قابلة للقيمة الفارغة؟

فعِّل أنواع Nullable للحصول على Optional<T> أو @Nullable على حقول JSON الاختيارية. مفيد عندما يمكن أن يكون الحقل فارغاً أو غائباً في استجابة الواجهة البرمجية.

كلاسات Record؟

كلاسات Java 16+ records غير قابلة للتعديل وموجزة. قد تُولِّد هذه الأداة كلاسات عادية. بالنسبة للـ records، قد تحتاج إلى تعديل المخرجات أو استخدام مولِّد آخر يدعم الـ records.

أدوات ذات صلة

لمكتبات JSON في Java، انظر Jackson وGson. لمعلومات حول JSON، انظر مواصفة JSON وRFC 8259. لاختبار الواجهات البرمجية، انظر Postman.