JSON إلى فئة Java

مثال على المخرجات: Jackson + Lombok

المدخل:

{ "firstName": "Alice", "age": 30, "address": { "city": "Madrid" } }

المخرج:

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class User {
    @JsonProperty("firstName")
    private String firstName;

    @JsonProperty("age")
    private int age;

    @JsonProperty("address")
    private Address address;
}

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Address {
    @JsonProperty("city")
    private String city;
}

مطابقة الأنواع

الاختيار بين النوع المُغلَّف والنوع الأولي

• النوع الأولي (int، long، boolean)، لا يقبل null، وفعّال، ودون تغليف تلقائي (auto-boxing).
• النوع المُغلَّف (Integer، Long، Boolean)، يقبل null، ومطلوب إذا كان الحقل قد يغيب أو يكون null في JSON.

يستخدم المولّد افتراضيًا النوع المُغلَّف لكل ما يُعدّ قابلًا لقيمة null، والنوع الأولي فيما عدا ذلك.

Jackson مقابل Gson

الأخطاء الشائعة

• استخدام الأنواع الأولية لحقول تقبل null. لا يمكن أن يكون int فارغًا (null)؛ وسيُطلق Jackson خطأً إذا احتوى JSON على "age": null. استخدم Integer.
• غياب وحدات التاريخ. يحتاج Jackson إلى jackson-datatype-jsr310 لـ Instant/LocalDate. وبدونها، تعود التواريخ إلى String أو إلى قيم long بتوقيت الحقبة (epoch).
• مشاركة الأنواع المُغلَّفة بين فئات غير مترابطة. إذا احتوى شكلان من JSON على Address متداخل، فسينشئ المولّد فئتَي Address. أعِد التسمية أو وحِّدهما يدويًا.
• نسيان @JsonIgnoreProperties(ignoreUnknown = true). يُطلق Jackson الصارم خطأً عند الخصائص غير المعروفة؛ أضِف هذا التعليق (أو اضبطه عالميًا) لإلغاء تسلسل متسامح.