JSON কে Go struct-এ রূপান্তর করুন!

JSON দিন এবং সেটিকে json ট্যাগসহ Go struct-এ রূপান্তর করুন! Go (Golang) struct, json tags সমর্থিত।
JSON
ফলাফল

JSON কে Go struct-এ রূপান্তর করুন!

JSON-কে encoding/json ট্যাগসহ Go struct ডেফিনিশনে কনভার্ট করুন। ফিল্ডের নাম Go-র exported-name নিয়ম আর golint-এর initialism তালিকা (ID, URL, API, ...) মেনে চলে, আর কলামগুলো এমনভাবে সাজানো থাকে যেন কোডটি gofmt দিয়ে চালানো হয়েছে।

Webhook payload বা API response json.Unmarshal করার জন্য একটি type, net/http, Gin বা Echo handler-এর request-body struct, অথবা কোনো CLI-এর config struct দরকার হলে এটি কাজে আসে।

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

  1. JSON পেস্ট করুন। কয়েকটি row-এর array দিলে কিছু row-এ না থাকা ফিল্ড শনাক্ত হয়ে omitempty ট্যাগ পায়।
  2. Struct-এর নাম-এ top-level struct-এর নাম দিন (ডিফল্ট Root); এটি URL-এ ?name= হিসেবে থাকে।
  3. ফলাফলটি একটি .go ফাইলে পেস্ট করে package clause যোগ করুন। Time ফিল্ড পাওয়া গেলে import "time" যুক্ত থাকে।
  4. var ev WebhookEvent; err := json.Unmarshal(body, &ev) হিসেবে ব্যবহার করুন।

উদাহরণ

ইনপুট (JSON)
{
  "event_id": "evt_1Pq",
  "type": "invoice.paid",
  "created_at": "2024-05-01T03:15:00Z",
  "amount_cents": 4999,
  "customer": { "id": "cus_9", "email": "kim@example.com" },
  "retry_count": null
}
আউটপুট (Go)
import "time"

type WebhookEvent struct {
	EventID     string    `json:"event_id"`
	Type        string    `json:"type"`
	CreatedAt   time.Time `json:"created_at"`
	AmountCents int       `json:"amount_cents"`
	Customer    Customer  `json:"customer"`
	RetryCount  any       `json:"retry_count,omitempty"`
}

type Customer struct {
	ID    string `json:"id"`
	Email string `json:"email"`
}

golint-এর initialism নিয়মে event_id হয় EventID, আর RFC 3339 স্ট্রিং created_at-কে time.Time হিসেবে অনুমান করা হয়, যা import "time" যোগ করে। retry_count হলো null, তাই এর type অজানা: এটি omitempty-সহ any হয়।

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

  • প্রতিটি ফিল্ডে একটি json:"originalKey" ট্যাগ, আর কিছু row-এ না থাকা বা null থাকা ফিল্ডে ,omitempty।
  • ঐচ্ছিক value type (int, string, bool, struct, time.Time) pointer (*int) হয়, যাতে "অনুপস্থিত" আর zero value আলাদা থাকে। Slice আর any আগে থেকেই nil হতে পারে, তাই non-pointer থাকে।
  • সংখ্যা: 32-বিট integer-এর জন্য int, তার বেশি হলে int64, দশমিক থাকলে float64।
  • 2024-05-01T03:15:00Z-এর মতো RFC 3339 স্ট্রিংকে time.Time হিসেবে অনুমান করা হয়।
  • প্রচলিত initialism বড় হাতের থাকে (user_id → UserID, home_url → HomeURL); সংখ্যা দিয়ে শুরু হওয়া key Field prefix পায়।
  • যেসব key Go json ট্যাগে আসতে পারে না, যেমন "", সেগুলো বাদ দিয়ে struct-এর উপরে একটি কমেন্টে তালিকা করা হয়।
  • অবজেক্টের top-level array থেকে element-এর জন্য একটি struct আর []Root-এ unmarshal করার একটি কমেন্ট তৈরি হয়।

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

Webhook রিসিভার

পেমেন্ট বা Git হোস্টিং সার্ভিসের পাঠানো একটি নমুনা ইভেন্ট থেকে struct তৈরি করে json.NewDecoder(r.Body).Decode(&ev) দিয়ে decode করুন, map[string]any-এর উপর বারবার type assertion না করে।

Gin বা Echo-তে request binding

ক্লায়েন্টের একটি request নমুনা থেকে c.ShouldBindJSON(&req)-এর জন্য struct তৈরি করুন, তারপর যেখানে দরকার binding:"required" ট্যাগ যোগ করুন।

JSON config পড়া CLI

config.json-কে একবার struct-এ বদলে নিন, তাহলে os.ReadFile-এর পরে একটিমাত্র json.Unmarshal দিয়েই পুরো config টাইপড ভ্যালু হিসেবে পেয়ে যাবেন।

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

  • শুধু RFC 3339 স্ট্রিং থেকেই time.Time অনুমান হয়; 2024-05-01 03:15:00 বা Unix timestamp-এর মতো ভ্যালু string বা int থাকে।
  • json.Unmarshal ডিফল্টভাবে অজানা key উপেক্ষা করে এবং key case-insensitive ভাবে মেলায়। কড়া decoding চাইলে Decoder.DisallowUnknownFields() ব্যবহার করুন।
  • 64-বিট প্ল্যাটফর্মে int 64-বিট, কিন্তু int64 লেখা হয় শুধু যখন কোনো নমুনা ভ্যালু 32 বিট ছাড়িয়ে যায়। বাড়তে পারে এমন ID-র জন্য নিজে int64-এ বদলে নেওয়া বেশি নিরাপদ।
  • Nested struct-গুলো সব আলাদা top-level type হিসেবে ডিফাইন হয়; কোনো anonymous inline struct ব্যবহার হয় না।
  • মিশ্র type-এর ভ্যালু আর সবসময় শুধু null থাকা ভ্যালু any হয়; আসল type জানা হলে সেগুলো বদলে দিন।

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

ঐচ্ছিক ফিল্ডগুলো কেন *int-এর মতো pointer?

সাধারণ int ফিল্ড key না থাকলে 0 হয়, যা আসল 0 থেকে আলাদা করা যায় না। Key অনুপস্থিত বা null হলে pointer হয় nil, আর omitempty-এর সাথে মিলে আবার marshal করার সময় key-টি বাদ পড়ে।

ফিল্ডের নাম কি ছোট হাতের করা যায়?

encoding/json শুধু exported (বড় হাতের অক্ষরে শুরু) ফিল্ড পড়ে ও লেখে; ছোট হাতের ফিল্ড ট্যাগ থাকলেও উপেক্ষিত হয়। Go-তে নাম বড় হাতের অক্ষরেই থাকে আর JSON key যায় ট্যাগে।

retry_count-এর মতো একটি null ফিল্ড any হিসেবে এসেছে।

নমুনায় শুধু null থাকলে type অনুমান করার কিছু থাকে না। আসল ভ্যালুসহ আরেকটি response একটি array-তে যোগ করে দুটো একসাথে কনভার্ট করুন, অথবা হাতে *int-এর মতো কিছুতে বদলে দিন।

Go struct থেকে কি আবার নমুনা JSON পাওয়া যায়?

হ্যাঁ। উপরের Go struct → JSON ট্যাবে struct পেস্ট করুন; এটি ট্যাগগুলো পড়ে উদাহরণ JSON তৈরি করে।