أدخل كود Java لـ DTO أو POJO أو record لتحصل على JSON الذي يُرجَّح أن ينتجه إعداد Jackson الافتراضي في Spring Boot. تأتي المفاتيح من الحقول المُعلنة، مع تطبيق @JsonProperty و@JsonIgnore و@JsonIgnoreProperties واستبعاد static/transient.
استخدمه لإنتاج مثال Swagger أو payload نموذجي للواجهة الأمامية من DTO الطلب أو الاستجابة في controller، أو ببساطة للتحقق من المفاتيح التي سيُخرجها صنف يستخدم @Data من Lombok.
static class وrecord وenum المتداخلة في الإدخال نفسه حتى تُملأ الحقول التي تشير إليها ببنيتها.النوع الجذري على تلقائي، يُختار الصنف الذي لا يستخدمه أي صنف آخر نوعًا لحقل. وحين تشير الكيانات إلى بعضها، اختر ما تريده من القائمة.@Schema(example = ...) أو مقتطف REST Docs أو جسم طلب في MockMvc.@Data
@JsonIgnoreProperties({"password"})
public class MemberResponse {
private Long memberId;
@JsonProperty("nick_name")
private String nickname;
private String password;
private Grade grade = Grade.SILVER;
private LocalDate birthDate;
private List<Address> addresses;
private static final long serialVersionUID = 1L;
public enum Grade { BRONZE, SILVER, GOLD }
public record Address(String zipCode, String city, boolean primary) {}
}{
"memberId": 0,
"nick_name": "",
"grade": "SILVER",
"birthDate": "1970-01-01",
"addresses": [
{
"zipCode": "",
"city": "",
"primary": false
}
]
}يُحذف password بسبب @JsonIgnoreProperties({"password"}) على مستوى الصنف، ولا يظهر serialVersionUID المعرَّف بـ static final أبدًا. تُقرأ القيمة الابتدائية Grade.SILVER، فيكون grade هو "SILVER" لا أول ثابت في الـ enum. ويتوسع record Address المتداخل إلى مصفوفة من الكائنات.
@JsonProperty("x") أو @JsonProperty(value = "x").@JsonIgnore، والمفاتيح المدرجة في @JsonIgnoreProperties({...}) على مستوى الصنف، والحقول static أو transient.record في Java 16+، وتعريفات static class المتداخلة، والحقول الموروثة عبر extends (حقول الأب أولًا).@JsonProperty("x") على الثابت يغيّر السلسلة إلى x.LocalDateTime → 1970-01-01T00:00:00، LocalDate → 1970-01-01، Instant/OffsetDateTime/ZonedDateTime → سلسلة ISO تنتهي بـ Z، java.util.Date/Timestamp → 1970-01-01T00:00:00.000+00:00.BigDecimal وLong تصبح 0، وOptional<T> يُفك إلى T، وbyte[] يصبح سلسلة Base64، ويحصل UUID وObjectId في MongoDB على قيم سليمة الصيغة.List وSet والمصفوفات تحصل على عنصر نموذجي واحد؛ والـ map ذات المفتاح الرقمي مثل Map<Long, V> تستخدم "0"، وإلا فـ "key".قيم example المكتوبة يدويًا تتقادم كلما أُضيف حقل إلى الـ DTO. ولّد JSON من كود الـ DTO وحسّن القيم انطلاقًا منه، فلا يكون أي مفتاح ناقصًا أو مكتوبًا خطأً.
أنشئ JSON الطلب مباشرة من DTO الـ @RequestBody والصقه في text block (""") داخل اختبارك. المفاتيح المعاد تسميتها بـ @JsonProperty مطبّقة أصلًا، مطابقةً للربط الحقيقي.
مطورو الواجهة الأمامية الذين لا يقرؤون كود الخلفية يحصلون على بنية JSON لنقطة النهاية مباشرة، بدلًا من الاضطرار إلى تفسير صنف Java.
= "guest"، = 100، = true) أو ثابت enum (= Grade.SILVER)؛ وأي شيء آخر، مثل new ArrayList<>() أو استدعاء دالة، يعود إلى القيمة البديلة للنوع.getFullName() أو boolean isVip()، تُضاف كخصائص كما يفعل Jackson، مع احترام @JsonIgnore/@JsonProperty على ذلك الـ getter. وفي المقابل، يُفترض أن الحقل private الذي ليس له getter مرئي (كما مع @Getter/@Data في Lombok).@JsonNaming(SnakeCaseStrategy.class)، spring.jackson.property-naming-strategy) ولا أنماط التاريخ في @JsonFormat.@JsonValue في الـ enums لا تُقيَّم، لذا تظل هذه الـ enums تُظهر الثابت (أو اسم @JsonProperty الخاص به).Page<T>/Slice<T> في Spring Data تُبسَّط إلى مصفوفة عناصر؛ بينما التسلسل الحقيقي لـ Page كائن فيه content وpageable وغيرهما.@Data أو @Getter من Lombok دوال الوصول؟نعم. تُبنى المفاتيح من الحقول المُعلنة، لذا لا حاجة لوجود الـ getters والـ setters التي يولّدها Lombok وقت الترجمة في الكود.
LocalDateTime سلسلة نصية لا مصفوفة أرقام؟يسجّل Spring Boot الوحدة jackson-datatype-jsr310 ويعطّل WRITE_DATES_AS_TIMESTAMPS افتراضيًا، فينتج سلاسل ISO؛ والعيّنة تتبع هذا الإعداد الافتراضي. أما ObjectMapper من Jackson المجرد فقد يكتب بدلًا من ذلك مصفوفة مثل [1970,1,1,0,0].
للكيانات بنية الحقول نفسها، فتُحلَّل بلا مشكلة. العلاقات ثنائية الاتجاه مثل @OneToMany كانت ستدور في حلقة، لذا تُوسَّع مرة واحدة ثم تُقطع بـ null أو بمصفوفة فارغة. وهناك أيضًا صفحة مخصصة Spring Boot JPA → JSON.
@JsonIgnore على setter أو على getter لحقل موجود؟التعليقات التوضيحية على تعريف الحقل تُطبَّق دائمًا، أما التي على الـ getter فلا تُطبَّق إلا إذا لم يوجد حقل بذلك الاسم. لا يُطبَّق @JsonIgnore على setter، ولا على getter لحقل مُعلن، فانقله إلى الحقل لترى أثره.