Go struct ডেফিনিশন পেস্ট করুন এবং marshal করার সময় encoding/json যে নিয়ম প্রয়োগ করে সেই নিয়মেই তৈরি একটি উদাহরণ JSON ডকুমেন্ট পান: json:"..." ট্যাগের নাম, - দিয়ে লুকানো ফিল্ড, ,string অপশন, unexported ছোট হাতের ফিল্ড আর সমতল করা embedded struct।
Gin, Echo বা net/http-এর request struct থেকে curl body তৈরি করতে, gRPC-Gateway বা REST ডকুমেন্টেশনের নমুনা প্রস্তুত করতে, আর যেসব ফিল্ডের ট্যাগ প্রত্যাশিত key তৈরি করে না সেগুলো খুঁজে বের করতে এটি কাজে আসে।
type Xxx struct { ... } ডিক্লারেশন পেস্ট করুন। গ্রুপ করা type ( ... ) ব্লক আর একসাথে কয়েকটি struct দিলেও চলে।decimal.Decimal) null হয়।curl -d, Postman body বা httptest-ভিত্তিক handler টেস্টে কপি করুন।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
}{
"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"-এর মতো স্ট্রিংয়ে মোড়ানো হয়।*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 ফিল্ড সাপোর্টেড।c.ShouldBindJSON(&req) দিয়ে যে struct bind করেন সেটি পেস্ট করে body তৈরি করুন, তারপর httptest.NewRequest বা curl দিয়ে endpoint কল করুন। Key সরাসরি ট্যাগ থেকে আসে বলে binding-এর অমিলের সম্ভাবনা কম।
json:"user_id" আর json:"userId" ট্যাগ মেশানো, বা ভুলে যাওয়া ট্যাগের কারণে বড় হাতের UserID key বেরিয়ে যাওয়া, আউটপুটে এক নজরেই স্পষ্ট হয়।
আপনার Go response struct থেকে তৈরি JSON ফ্রন্টএন্ড বা Python ব্যবহারকারীদের দিন; তারা JSON → TypeScript বা JSON → Python-এর মতো টুল দিয়ে সেটিকে আবার মডেলে বদলাতে পারবে।
omitempty ফিল্ড নমুনায় সবসময় দেখানো হয়; আসল marshaling-এ zero value থাকলে সেগুলো বাদ পড়ে।nil pointer marshal হয় null হিসেবে, কিন্তু নমুনা পূরণ করা অবস্থাটি দেখায়।MarshalJSON() থাকা type আর json.RawMessage-এর আসল কনটেন্ট জানা সম্ভব নয়, তাই প্রতিফলিত হয় না।omitzero-এর মতো নতুন অপশন আর encoding/json/v2-এর আচরণ এর আওতায় নেই।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 পেজ ব্যবহার করুন। তার আউটপুট আবার এই পেজে দিলে দ্রুত যাচাই করা যায় যে আসা-যাওয়ায় মূল key-গুলো ঠিক থাকছে কি না।