JSON কে Java class-এ রূপান্তর করুন!

JSON দিন এবং nested object সহ Java class কোড তৈরি করুন! Jackson @JsonProperty, Lombok সমর্থিত। Spring Boot JPA @Entity · MongoDB @Document উপরের ট্যাবে।
JSON
ফলাফল
 

JSON কে Java class-এ রূপান্তর করুন!

একটি 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 অপশন আউটপুটকে একই স্টাইলে রাখে।

কীভাবে ব্যবহার করবেন

  1. ইনপুট বক্সে API response-এর JSON পেস্ট করুন।
  2. টাইপের নাম-এ DTO-র নাম দিন। শুধু প্রথম ক্লাসটি public, তাই এটি ফাইলের নামের সাথে মিলিয়ে নিন।
  3. স্টাইল-এ class (getter/setter-সহ) বা record বেছে নিন।
  4. class বেছে নিলে getter/setter-এর বদলে @Data, @NoArgsConstructor আর @AllArgsConstructor পেতে Lombok-এ টিক দিন।
  5. ফলাফলটি একটি .java ফাইলে পেস্ট করে আপনার package ডিক্লারেশন যোগ করুন।

উদাহরণ

ইনপুট (JSON)
{
  "id": 1296269,
  "full_name": "octocat/Hello-World",
  "private": false,
  "stargazers_count": 80,
  "owner": { "login": "octocat", "site_admin": false },
  "topics": ["api", "demo"]
}
আউটপুট (Java · class)
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 ক্লাসে আলাদা হয়েছে।

সমর্থিত বৈশিষ্ট্য

  • দুটি আউটপুট স্টাইল: getter/setter-সহ সাধারণ class, অথবা immutable record।
  • Lombok অপশন (শুধু class স্টাইলে): import-সহ @Data, @NoArgsConstructor, @AllArgsConstructor যোগ করে এবং accessor কোড বাদ দেয়।
  • @JsonProperty শুধু সেখানেই যোগ হয় যেখানে ফিল্ডের নাম JSON key থেকে আলাদা, তার import-সহ।
  • প্রতিটি ফিল্ড wrapper type (Integer, Long, Double, Boolean) ব্যবহার করে, তাই বাড়তি কাজ ছাড়াই JSON null বসে যায়।
  • 32-বিট সীমার বাইরের integer হয় Long; মিশ্র type-এর ভ্যালু হয় Object।
  • class বা default-এর মতো keyword key-এর শেষে _ যোগ হয়; সংখ্যা দিয়ে শুরু হওয়া key n prefix পায়।
  • Java-তে type alias নেই, তাই top-level array থেকে একটি // Root: List<RootItem> কমেন্ট আর element ক্লাস তৈরি হয়।

ব্যবহারের ক্ষেত্র

Spring Boot-এ থার্ড-পার্টি API-এর DTO

পেমেন্ট, ম্যাপ বা মেসেজিং API-এর ডকুমেন্টেশনের নমুনা response পেস্ট করে জেনারেট হওয়া ক্লাসটি restTemplate.getForObject(url, PaymentResponse.class)-এ দিন। Nesting যত গভীর, হাতে লেখার তুলনায় তত বেশি ফিল্ড বাদ পড়া এড়ানো যায়।

Record হিসেবে read-only response মডেল

যে response শুধু পড়েন তার জন্য record ছোট এবং কোনো setter নেই; Jackson 2.12+ record-এর canonical constructor দিয়ে deserialize করে।

টেস্ট fixture থেকে মডেল উদ্ধার

যে legacy প্রজেক্টে শুধু fixture JSON ফাইল আছে, সেখানে একটি fixture দিয়ে ফিল্ডের বিন্যাস দেখুন এবং DTO-র প্রথম খসড়া পান।

নোট ও সীমাবদ্ধতা

  • কিছু আইটেমে না থাকা ফিল্ড wrapper type-এ শুধু null হিসেবে আসে; কোনো কিছু সেটিকে ঐচ্ছিক বলে চিহ্নিত করে না। Required ভ্যালু validate করলে @NotNull বা এমন কিছু নিজে যোগ করুন।
  • ডিফল্ট সেটিংসে Jackson অজানা key পেলে exception ছোড়ে। API নতুন ফিল্ড যোগ করতে পারলে @JsonIgnoreProperties(ignoreUnknown = true) বা FAIL_ON_UNKNOWN_PROPERTIES বন্ধ করার কথা ভাবুন।
  • তারিখের স্ট্রিং String হিসেবে আসে। সেগুলোকে LocalDateTime বা OffsetDateTime-এ ম্যাপ করতে jackson-datatype-jsr310 মডিউল লাগে।
  • record বেছে নিলে Lombok চেকবক্স লুকিয়ে যায়, কারণ record-এর এটি দরকার হয় না।
  • Nested ক্লাসগুলো একই ফাইলে package-private ক্লাস, public নয়। অন্য package-এর দরকার হলে সেগুলো আলাদা ফাইলে ভাগ করুন।

সাধারণ প্রশ্ন

Boolean ফিল্ডের getter কেন 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-এর সাথে ব্যবহার করা যায়?

Gson @JsonProperty উপেক্ষা করে। class আউটপুটে এটিকে @SerializedName দিয়ে বদলালে একই গঠন Gson-এ কাজ করে; Gson 2.10 থেকে record সাপোর্ট করে।