একটি JSON নমুনা পেস্ট করুন এবং এমন Java ক্লাস বা record পান যা Jackson সরাসরি deserialize করতে পারে। Nested অবজেক্টগুলো একই ফাইলে অতিরিক্ত ক্লাস হয়, আর array হয় List<T>।
Spring Boot-এ যে DTO-গুলো না হলে হাতে টাইপ করতেন সেগুলোর জন্য এটি ব্যবহার করুন: RestTemplate, WebClient বা Feign ক্লায়েন্টের response type, অথবা থার্ড-পার্টি API-এর request body। Java 16+ হলে record তৈরি করতে পারেন, আর আপনার কোডবেস আগে থেকেই Lombok ব্যবহার করলে Lombok অপশন আউটপুটকে একই স্টাইলে রাখে।
টাইপের নাম-এ DTO-র নাম দিন। শুধু প্রথম ক্লাসটি public, তাই এটি ফাইলের নামের সাথে মিলিয়ে নিন।স্টাইল-এ class (getter/setter-সহ) বা record বেছে নিন।class বেছে নিলে getter/setter-এর বদলে @Data, @NoArgsConstructor আর @AllArgsConstructor পেতে Lombok-এ টিক দিন।.java ফাইলে পেস্ট করে আপনার package ডিক্লারেশন যোগ করুন।{
"id": 1296269,
"full_name": "octocat/Hello-World",
"private": false,
"stargazers_count": 80,
"owner": { "login": "octocat", "site_admin": false },
"topics": ["api", "demo"]
}import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;
public class Repository {
private Integer id;
@JsonProperty("full_name") private String fullName;
@JsonProperty("private") private Boolean private_;
@JsonProperty("stargazers_count") private Integer stargazersCount;
private Owner owner;
private List<String> topics;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getFullName() {
return fullName;
}
public void setFullName(String fullName) {
this.fullName = fullName;
}
public Boolean getPrivate() {
return private_;
}
public void setPrivate(Boolean private_) {
this.private_ = private_;
}
public Integer getStargazersCount() {
return stargazersCount;
}
public void setStargazersCount(Integer stargazersCount) {
this.stargazersCount = stargazersCount;
}
public Owner getOwner() {
return owner;
}
public void setOwner(Owner owner) {
this.owner = owner;
}
public List<String> getTopics() {
return topics;
}
public void setTopics(List<String> topics) {
this.topics = topics;
}
}
class Owner {
private String login;
@JsonProperty("site_admin") private Boolean siteAdmin;
public String getLogin() {
return login;
}
public void setLogin(String login) {
this.login = login;
}
public Boolean getSiteAdmin() {
return siteAdmin;
}
public void setSiteAdmin(Boolean siteAdmin) {
this.siteAdmin = siteAdmin;
}
}
full_name-এর মতো snake_case key @JsonProperty-এর মাধ্যমে fullName ফিল্ডে ম্যাপ হয়। private একটি Java keyword, তাই ফিল্ডটি হয়েছে private_, যদিও এর accessor getPrivate()/setPrivate()-ই থাকে, আর owner অবজেক্টটি একই ফাইলে একটি Owner ক্লাসে আলাদা হয়েছে।
class, অথবা immutable record।@Data, @NoArgsConstructor, @AllArgsConstructor যোগ করে এবং accessor কোড বাদ দেয়।@JsonProperty শুধু সেখানেই যোগ হয় যেখানে ফিল্ডের নাম JSON key থেকে আলাদা, তার import-সহ।Integer, Long, Double, Boolean) ব্যবহার করে, তাই বাড়তি কাজ ছাড়াই JSON null বসে যায়।Long; মিশ্র type-এর ভ্যালু হয় Object।class বা default-এর মতো keyword key-এর শেষে _ যোগ হয়; সংখ্যা দিয়ে শুরু হওয়া key n prefix পায়।// Root: List<RootItem> কমেন্ট আর element ক্লাস তৈরি হয়।পেমেন্ট, ম্যাপ বা মেসেজিং API-এর ডকুমেন্টেশনের নমুনা response পেস্ট করে জেনারেট হওয়া ক্লাসটি restTemplate.getForObject(url, PaymentResponse.class)-এ দিন। Nesting যত গভীর, হাতে লেখার তুলনায় তত বেশি ফিল্ড বাদ পড়া এড়ানো যায়।
যে response শুধু পড়েন তার জন্য record ছোট এবং কোনো setter নেই; Jackson 2.12+ record-এর canonical constructor দিয়ে deserialize করে।
যে legacy প্রজেক্টে শুধু fixture JSON ফাইল আছে, সেখানে একটি fixture দিয়ে ফিল্ডের বিন্যাস দেখুন এবং DTO-র প্রথম খসড়া পান।
null হিসেবে আসে; কোনো কিছু সেটিকে ঐচ্ছিক বলে চিহ্নিত করে না। Required ভ্যালু validate করলে @NotNull বা এমন কিছু নিজে যোগ করুন।@JsonIgnoreProperties(ignoreUnknown = true) বা FAIL_ON_UNKNOWN_PROPERTIES বন্ধ করার কথা ভাবুন।String হিসেবে আসে। সেগুলোকে LocalDateTime বা OffsetDateTime-এ ম্যাপ করতে jackson-datatype-jsr310 মডিউল লাগে।record বেছে নিলে Lombok চেকবক্স লুকিয়ে যায়, কারণ record-এর এটি দরকার হয় না।public নয়। অন্য package-এর দরকার হলে সেগুলো আলাদা ফাইলে ভাগ করুন।isXxx না হয়ে getXxx?ফিল্ডের type হলো Boolean wrapper, primitive boolean নয়। Jackson দীর্ঘদিন ধরে শুধু primitive boolean-এর জন্য isXxx accessor চেনে, তাই যেকোনো Jackson ভার্সনে প্রপার্টি একইভাবে bind করাতে getXxx ব্যবহার করা হয়।
record আউটপুটে কি @JsonProperty থাকে?হ্যাঁ, নাম বদলানো component-গুলো @JsonProperty("full_name") String fullName হিসেবে লেখা হয়। Jackson 2.12 বা পরের ভার্সন canonical constructor দিয়ে সেগুলো পূরণ করে।
spring.jackson.property-naming-strategy=SNAKE_CASE সেট করলে কি annotation মুছে ফেলা যায়?গ্লোবাল SNAKE_CASE strategy থাকলে annotation ছাড়াই full_name ↔ fullName ম্যাপ হয়। Keyword-এর কারণে বদলানো নাম, যেমন private_, strategy-র আওতায় পড়ে না, তাই ওই annotation-গুলো রেখে দিন।
Gson @JsonProperty উপেক্ষা করে। class আউটপুটে এটিকে @SerializedName দিয়ে বদলালে একই গঠন Gson-এ কাজ করে; Gson 2.10 থেকে record সাপোর্ট করে।