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

Go struct দিন এবং তার json ট্যাগ অনুযায়ী উদাহরণ JSON তৈরি করুন! Go (Golang) struct, json tags সমর্থিত। API ডকুমেন্টেশন ও টেস্ট request body (sample JSON)-এর জন্য উপযোগী।
Go struct
ফলাফল
 

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

Go struct ডেফিনিশন পেস্ট করুন এবং marshal করার সময় encoding/json যে নিয়ম প্রয়োগ করে সেই নিয়মেই তৈরি একটি উদাহরণ JSON ডকুমেন্ট পান: json:"..." ট্যাগের নাম, - দিয়ে লুকানো ফিল্ড, ,string অপশন, unexported ছোট হাতের ফিল্ড আর সমতল করা embedded struct।

Gin, Echo বা net/http-এর request struct থেকে curl body তৈরি করতে, gRPC-Gateway বা REST ডকুমেন্টেশনের নমুনা প্রস্তুত করতে, আর যেসব ফিল্ডের ট্যাগ প্রত্যাশিত key তৈরি করে না সেগুলো খুঁজে বের করতে এটি কাজে আসে।

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

  1. type Xxx struct { ... } ডিক্লারেশন পেস্ট করুন। গ্রুপ করা type ( ... ) ব্লক আর একসাথে কয়েকটি struct দিলেও চলে।
  2. কোনো ফিল্ড অন্য struct ব্যবহার করলে সেই ডেফিনিশনও দিন। ইনপুটে নেই এমন এক্সটার্নাল package-এর type (যেমন decimal.Decimal) null হয়।
  3. কোনো অপশন নেই: অন্য কোনো type reference করে না এমন প্রথম struct-ই top-level JSON, তাই যেটি চান সেটি প্রথমে রাখুন বা অপ্রাসঙ্গিক struct বাদ দিন।
  4. ফলাফলটি curl -d, Postman body বা httptest-ভিত্তিক handler টেস্টে কপি করুন।

উদাহরণ

ইনপুট (Go struct)
type Base struct {
	ID        string    `json:"id"`
	CreatedAt time.Time `json:"created_at"`
}

type Job struct {
	Base
	Queue      string            `json:"queue"`
	Attempts   int               `json:"attempts,string"`
	Labels     map[string]string `json:"labels,omitempty"`
	TimeoutSec *int              `json:"timeout_sec,omitempty"`
	Token      string            `json:"-"`
	Done       bool
	lastErr    error
}
আউটপুট (JSON)
{
  "id": "",
  "created_at": "0001-01-01T00:00:00Z",
  "queue": "",
  "attempts": "0",
  "labels": {
    "key": ""
  },
  "timeout_sec": 0,
  "Done": false
}

Embedded Base সরাসরি Job-এ id আর created_at যোগ করে, আর ,string ট্যাগ দেওয়া Attempts সংখ্যার বদলে স্ট্রিং "0" হয়। Token (ট্যাগ -) আর unexported lastErr বাদ পড়ে, অন্যদিকে ট্যাগ ছাড়া Done তার Go ফিল্ডের নামকেই key হিসেবে রাখে। time.Time দেখায় Go-র zero value, 0001-01-01T00:00:00Z।

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

  • json:"name" ট্যাগকে key হিসেবে ব্যবহার করে, ট্যাগ না থাকলে হুবহু ফিল্ডের নাম।
  • json:"-" ফিল্ড আর unexported ছোট হাতের ফিল্ড এড়িয়ে যায়; json:"-," ফিল্ডটিকে আক্ষরিক key --এর অধীনে রাখে।
  • ,string থাকলে সংখ্যা আর boolean ফিল্ড "0" আর "false"-এর মতো স্ট্রিংয়ে মোড়ানো হয়।
  • ট্যাগ ছাড়া embedded struct parent-এ সমতল হয়ে যায়, নামের সংঘাতে বাইরের ফিল্ড জেতে; ট্যাগ দেওয়া embedded struct সেই নামের অধীনে nested অবজেক্ট হয়।
  • Pointer (*int, *Profile) নির্দেশিত type দিয়ে পূরণ হয়, আর type Status string-এর মতো defined type তার underlying type অনুসরণ করে।
  • []byte হয় Base64 (ফাঁকা) স্ট্রিং, map[int]T একটি "0" key ব্যবহার করে, time.Duration হয় ন্যানোসেকেন্ডের integer 0, আর interface{}/any হয় null।
  • Children []Node-এর মতো নিজেকে reference করা struct একটি ফাঁকা array-তে থেমে যায়। Anonymous nested struct ফিল্ড সাপোর্টেড।

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

Handler টেস্টের request body

c.ShouldBindJSON(&req) দিয়ে যে struct bind করেন সেটি পেস্ট করে body তৈরি করুন, তারপর httptest.NewRequest বা curl দিয়ে endpoint কল করুন। Key সরাসরি ট্যাগ থেকে আসে বলে binding-এর অমিলের সম্ভাবনা কম।

ট্যাগের ভুল খুঁজে বের করা

json:"user_id" আর json:"userId" ট্যাগ মেশানো, বা ভুলে যাওয়া ট্যাগের কারণে বড় হাতের UserID key বেরিয়ে যাওয়া, আউটপুটে এক নজরেই স্পষ্ট হয়।

অন্য ভাষার ক্লায়েন্টের সাথে schema শেয়ার করা

আপনার Go response struct থেকে তৈরি JSON ফ্রন্টএন্ড বা Python ব্যবহারকারীদের দিন; তারা JSON → TypeScript বা JSON → Python-এর মতো টুল দিয়ে সেটিকে আবার মডেলে বদলাতে পারবে।

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

  • omitempty ফিল্ড নমুনায় সবসময় দেখানো হয়; আসল marshaling-এ zero value থাকলে সেগুলো বাদ পড়ে।
  • nil pointer marshal হয় null হিসেবে, কিন্তু নমুনা পূরণ করা অবস্থাটি দেখায়।
  • কাস্টম MarshalJSON() থাকা type আর json.RawMessage-এর আসল কনটেন্ট জানা সম্ভব নয়, তাই প্রতিফলিত হয় না।
  • Go 1.24-এর omitzero-এর মতো নতুন অপশন আর encoding/json/v2-এর আচরণ এর আওতায় নেই।

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

ট্যাগ ছাড়া ফিল্ড কোন key পায়?

encoding/json exported ফিল্ডের নাম হুবহু ব্যবহার করে, তাই Done bool হয় "Done"। Go-তে decode করার সময় case-insensitive ভাবে মেলে, কিন্তু অন্য ভাষার ক্লায়েন্টে তা হয় না, তাই স্পষ্ট ট্যাগ বেশি নিরাপদ।

time.Time কেন 0001 সালে সেট করা?

Go-র zero time.Time হলো 0001-01-01 00:00:00 UTC, যা RFC 3339-এ 0001-01-01T00:00:00Z হিসেবে marshal হয়। সেজন্যই এটি অন্য → JSON পেজগুলোর 1970 সালের তারিখ থেকে আলাদা।

json:",string" কখন কাজে আসে?

মূলত বড় int64 ID-র জন্য, যা JavaScript নির্ভুলভাবে প্রকাশ করতে পারে না, তাই সেগুলো স্ট্রিং হিসেবে আদান-প্রদান হয়। নমুনা "0" দেখায়, ফলে ক্লায়েন্টের কাছে স্পষ্ট হয় যে তারা স্ট্রিং পাবে।

আমি উল্টোটা চাই: JSON থেকে Go struct।

JSON → Go struct পেজ ব্যবহার করুন। তার আউটপুট আবার এই পেজে দিলে দ্রুত যাচাই করা যায় যে আসা-যাওয়ায় মূল key-গুলো ঠিক থাকছে কি না।