JSON থেকে Go Struct: জেনারেটর কাঠামো দেয়, চারটি বিষয় আপনার হাত চায়
সংক্ষেপে: কনভার্টারে একটি নমুনা API প্রতিক্রিয়া পেস্ট করুন এবং দশ সেকেন্ডে ট্যাগসহ Go struct পেয়ে যাবেন — কিন্তু সংখ্যা float64 হয়ে যায়, ঐচ্ছিক ফিল্ড নিজে থেকে কখনো পয়েন্টার হয় না, omitempty খালি struct সরাতে পারে না, আর বেশিরভাগ তারিখ string থেকে যায়। সম্পূর্ণ ম্যাপিং টেবিল, পয়েন্টার ও omitzero-র ভারসাম্য, এবং তৈরি করা কোড পরিমার্জনের চার-ধাপের চেকলিস্ট।

আগে উপসংহার: কনভার্টার দশ সেকেন্ডে যে struct বানায় তা কম্পাইল হয়, কিন্তু প্রোডাকশনের জন্য প্রস্তুত নয়। জেনারেটর শুধু সেই একটিমাত্র নমুনাকে বর্ণনা করে যা আপনি পেস্ট করেছেন — সংখ্যা float64 হয়ে যায়, ঐচ্ছিক ফিল্ড নিজে থেকে কখনো পয়েন্টার হয় না, omitempty খালি struct সরায় না, আর বেশিরভাগ তারিখের স্ট্রিং string থেকে যায়। পেস্ট করার পর এই চার ফাঁকই আপনার কাজ।
API প্রতিক্রিয়াকে Go struct-এ রূপান্তর করা বিশুদ্ধভাবে যান্ত্রিক কাজ, আর যান্ত্রিক কাজের খরচ নীরবতায় লুকিয়ে থাকে: ভুল বানানে ফিল্ডের নাম কম্পাইল এরর দেয় না, শুধু একটি ফিল্ড চিরকাল শূন্য থেকে যায়; null সামলানোর ভুল সুইচ — আর যেখানে কেউ আশা করেনি সেখানেই প্রোডাকশনে
"note": nullএসে হাজির। struct তৈরি নাম ও টাইপের সারিবদ্ধতা সমাধান করে, কিন্তু দুটি জিনিস কখনো নিজে সারিবদ্ধ হয় না: আপনার নমুনার বাইরের রূপভেদ এবং Go-র টাইপ সিস্টেম ও JSON-এর মাঝের উপত্যকা।
জেনারেটর আসলে কী পড়ে: ম্যাপিং টেবিল
প্রতিটি JSON → Go কনভার্টার একই টেবিলের ওপর চলে। এই সাইটের /convert/go পাতায় সাধারণ অর্ডার রেসপন্স পাঠান — নমুনা পেস্ট করুন, json ট্যাগ চালু করুন — আর এই রূপটি পাবেন:
| JSON মান | তৈরি হওয়া Go টাইপ | মন্তব্য |
|---|---|---|
| string | string |
তারিখের স্ট্রিং সাধারণত string থাকে, নিচে time.Time দেখুন |
| পূর্ণসংখ্যা | float64 |
encoding/json ভেতরে সংখ্যাকে double হিসেবে পার্স করে |
| দশমিক | float64 |
মুদ্রার ফিল্ড decimal লাইব্রেরি বা ছোট এককে int64 করুন |
| true / false | bool |
ফাঁদ নেই |
| null | any |
একটিমাত্র null নমুনা কিছু প্রমাণ করে না, রক্ষণশীল fallback |
| অবজেক্ট | নাম-ধারী struct | নেস্টেড অবজেক্ট নিজস্ব struct হয়ে যায় |
খালি অবজেক্ট {} |
map[string]any |
পর্যবেক্ষণযোগ্য ফিল্ড নেই, জেনারেটর অনুমান করে না |
| অ্যারে | []এলিমেন্টটাইপ |
এলিমেন্টের টাইপ প্রথম নমুনা থেকে অনুমিত |
| মিশ্র টাইপ | any |
Go-তে union নেই, একাধিক টাইপের ফিল্ড any-তে পড়ে |
// ইনপুট নমুনা
// {"id":"A-1029","items":[{"sku":"J-01","qty":2}],"coupon":null}
type Root struct {
ID string `json:"id"`
Items []Item `json:"items"`
Coupon any `json:"coupon"`
}
type Item struct {
Sku string `json:"sku"`
Qty int `json:"qty"`
}
তিনটি পর্যবেক্ষণ। নেস্টেড অবজেক্ট items নিজস্ব struct Item হয়েছে, যাকে slice রেফারেন্স করে। coupon শুধু null হিসেবে এসেছে: জেনারেটর প্রমাণ করতে পারে না পরে এটি কী হবে, তাই any-তে পড়ে। qty সংখ্যাটি টুল অনুযায়ী int বা float64 হয়ে অবতরণ করে — কৌশলগুলো আলাদা, তবে সবগুলোই একই অনুমানে দাঁড়িয়ে: নমুনাই সমগ্র সত্য।
Json ট্যাগ: মূল নাম, অপশন এবং সহজ তিন ভুল
ট্যাগ জেনারেটরের আউটপুটে সর্বোচ্চ তথ্য-ঘনত্ব বহন করে এবং সম্পাদনার সময় সবচেয়ে সহজে ভুল হওয়ার অংশও। নিয়মগুলো সরাসরি encoding/json ডকুমেন্টেশন থেকে আসে:
Field int `json:"myName"` // myName কী-এর নিচে আসে
Field int `json:"myName,omitempty"` // পূর্ণসংখ্যা ফিল্ড খালি হলে বাদ যায়
Field int `json:",omitempty"` // ডিফল্ট ফিল্ড নাম, শুধু অপশন
Field int `json:"-"` // সবসময় উপেক্ষিত, এনকোডও নয় ডিকোডও নয়
Field int64 `json:"id,string"` // সংখ্যা স্ট্রিংয়ের ভেতরে এনকোড করা
মনে রাখার মতো তিনটি অসাবধানতা। প্রথমত, json:",omitempty"-এর শুরুর কমা — যখন কী-এর নাম না বদলে শুধু খালি মান এড়াতে চান, কমা আবশ্যক; না থাকলে ফিল্ডটিকে আক্ষরিকভাবে ,omitempty নামের কী ধরা হয়। দ্বিতীয়ত, ট্যাগে মূল JSON কী রাখুন (user_id, html_url) যখন Go ফিল্ড স্বাভাবিক ধাঁচ ব্যবহার করে (UserID, HTMLURL): ট্যাগ ছাড়া মিল ফিল্ডের আক্ষরিক নামে হয়, তাই রেসপন্সের userId কী কখনো ম্যাপ হয় না — নীরবে। তৃতীয়ত, json:"-" ছাড়াও json:"-," আছে — শেষোক্ত মানে কী-টির নাম সত্যিই -।
পয়েন্টার: nil-ই "অনুপস্থিত" থেকে "শূন্য" আলাদা করার একমাত্র উপায়
Go-র শূন্য-মান ব্যবস্থা int ও string-কে "ফিল্ড নেই" বোঝাতে দেয় না — 0 ও "" প্রকৃত ডেটাও হতে পারে, বা শুধু পার্স-হয়নি। একই JSON কী-এর তিনটি অবস্থা: মানসহ উপস্থিত, null হিসেবে উপস্থিত, এবং অনুপস্থিত। ভ্যালু-টাইপ শুধু প্রথমটি ঢাকে।
type Config struct {
Note string `json:"note,omitempty"` // কেবল হুবহু "" হলে বাদ
Alias *string `json:"alias,omitempty"` // nil হলে বাদ
Details *Meta `json:"details,omitempty"`
}
পয়েন্টার ফিল্ডের শূন্য মান nil। json.Unmarshal কী না থাকলে বা null হলে একে nil রেখে দেয়, আর omitempty ঠিক সেই ক্ষেত্রেই এড়িয়ে যায়। এ কারণেই বেশিরভাগ কনভার্টার "নেস্টেড অবজেক্টে পয়েন্টার ব্যবহার করুন" সুইচ দেয়: চালু করলে — নেস্টেড struct *Item হয়ে যায়, আর PATCH রিকোয়েস্টে "ফিল্ড পাঠানো হয়নি" ও "মুছতে null পাঠানো হয়েছে" অবশেষে আলাদা হয়। দাম হলো সর্বত্র nil-চেক — p.Address.Street Address nil হলে panic করে, Go-র JSON কোডে সবচেয়ে প্রচলিত রানটাইম ক্র্যাশগুলোর একটি।
খালি struct যা omitempty সরাতে পারে না, আর সেই গর্তের ভরাটকারী omitzero
omitempty-র সরকারি সংজ্ঞা মান দেখে রায় দেয়: false, 0, nil পয়েন্টার, nil interface এবং শূন্য-দৈর্ঘ্যের array, slices, maps বা স্ট্রিং। লক্ষ করুন তালিকায় কী নেই: খালি struct।
type Order struct {
Meta Meta `json:"meta,omitempty"`
}
type Meta struct {
Version string
Build int
}
// Meta{Version: "1.0"} → "meta":{"version":"1.0","build":0}
// Meta{} → "meta":{} ← omitempty কিছুই করেনি
struct-টাইপ ফিল্ড omitempty দ্বারা কখনো বাদ পড়ে না — স্মৃতিতে এটি নির্দিষ্ট আকারের ধারক হিসেবে বাস করে, আর বিদ্যমান ধারক "খালি" নয়। সমাধান ফিল্ডকে *Meta করা; শুধু nil পয়েন্টারই ফেলে দেওয়া হয়। Go 1.24 থেকে দ্বিতীয় সুইচ আছে, omitzero: Go-র শূন্য মান দেখে রায় দেয়, টাইপ সংজ্ঞায়িত করলে IsZero() bool ডাকে — শূন্য time.Time বাদ দেওয়ার একমাত্র পথ। encoding/json/v2-এ (Go 1.25-এ পরীক্ষামূলক) অর্থ আবার সরে: v2-র omitempty এনকোড করা JSON ফল দেখে (শুধু null, "", {}, [] খালি গণ্য), তাই count: 0 আউটপুটে থেকে যায়; পুরোনো কোড মাইগ্রেট করার সময় bool ও সাংখ্যিক ফিল্ডের omitempty omitzero হতে হবে, মূল অর্থ ধরে রাখতে।
প্রতিটি সংখ্যা float64 হয়: বড় পূর্ণসংখ্যার ফাঁদ
স্পষ্ট টাইপ ছাড়া encoding/json-এর ডিকোডার সংখ্যাকে float64 মানে, আর float64-এর ম্যান্টিসা মাত্র ৫৩ বিট। JavaScript-এর ক্লাসিক ঘটনা — 9007199254740993 হয়ে যাওয়া 9007199254740992 — Go-তেও আছে, যতক্ষণ লক্ষ্য-ফিল্ড float64 বা any।
var v map[string]any
_ = json.Unmarshal([]byte(`{"id":9007199254740993}`), &v)
// v["id"] হল float64(9007199254740992), নির্ভুলতা এখনই হারায়
তিনটি বেরোনোর পথ। struct-এর ফিল্ড int64 ঘোষণা করুন, ডিকোডার নির্ভুলভাবে সেখানেই পার্স করবে। any দিয়ে যেতে হলে decoder.UseNumber() ডাকুন, যাতে সংখ্যা json.Number স্ট্রিং হয়ে নামে, যা আপনি সচেতনভাবে রূপান্তর করেন। টাকায় কখনো ফ্লোটিং-পয়েন্ট ব্যবহার করবেন না — ছোট একক int64-এ রাখুন বা decimal লাইব্রেরি নিন। API যখনই snowflake ID বা ৬৪ বিটের অর্ডার নম্বর দেয়, এই অংশটি বাধ্যতামূলক পরীক্ষা।
time.Time কেবল RFC 3339 মেনে নেয়
"2024-01-15T10:30:00Z"-এর সামনে জেনারেটর time.Time ম্যাপ করে; "2024-01-15 10:30:00"-এর সামনে string রেখে দেয়। অলসতা নয় — encoding/json-এর কঠিন বাধা: time.Time UnmarshalJSON বাস্তবায়ন করে এবং কঠোরভাবে RFC 3339 layout 2006-01-02T15:04:05Z07:00-এ পার্স করে। T না থাকা, টাইমজোন না থাকা বা Z-এর পরে offset — সব ব্যর্থ:
parsing time "\"2022-07-27T14:16:00Z04:00\"" as
"\"2006-01-02T15:04:05Z07:00\"": cannot parse "04:00\"" as "\""
উজস্ট্রিমের ফরম্যাট বদলাতে না পারলে মানসম্মত সমাধান time.Time মোড়ানো একটি কাস্টম টাইপ, যার UnmarshalJSON কয়েকটি layout চেষ্টা করে:
type CustomDate struct{ time.Time }
func (c *CustomDate) UnmarshalJSON(b []byte) error {
s := strings.Trim(string(b), `"`)
t, err := time.Parse("2006-01-02 15:04:05", s)
if err != nil {
t, err = time.Parse(time.RFC3339, s)
if err != nil {
return fmt.Errorf("invalid date format: %w", err)
}
}
c.Time = t
return nil
}
তৈরির পর চার-ধাপের চেকলিস্ট
চার ধাপ জেনারেটরের আউটপুটকে প্রোডাকশন কোড থেকে আলাদা করে, আর একবার হাঁটা পরে ডিবাগ করার চেয়ে সস্তা:
- প্রতিটি any fallback বদলান:
anyখুঁজুন, প্রতিটি fallback ফিল্ডের জন্য তিন থেকে পাঁচটি সত্যিকারের নমুনা দেখুন, তারপর নির্দিষ্ট টাইপে বা পয়েন্টারে নামান; - সাংখ্যিক প্রস্থ আবার যাচাই করুন: ID, অর্থ ও কাউন্টার float64 থেকে int64 / int32 / decimal-এ সরান; প্রস্থ নিয়ে সন্দেহ থাকলে int64 লিখুন;
- ঐচ্ছিকতা চিহ্নিত করুন: অ্যারের অবজেক্ট-ফিল্ড, PATCH বডি ও তৃতীয় পক্ষের API-র nullable ফিল্ডে পয়েন্টার বা omitempty/omitzero — nil-এর অর্থ একবারই স্থির করুন, এখানে;
- কম্পাইল ও গো-ফেরত পরীক্ষা:
go vetচালান, তারপর Marshal→Unmarshal গো-ফেরত টেস্ট যোগ করে তারের ফরম্যাট আটকে দিন — ভবিষ্যতের encoding/json আপডেটের আচরণ-সরে যাওয়া ধরা পড়বে।
নমুনা থেকে চুক্তি: কনভার্টারের সীমানা
কনভার্টার উত্তর দেয় "এই নমুনাটি দেখতে কেমন", "এই ইন্টারফেসটি সবসময় কেমন দেখাবে" নয়। প্রতিযোগী টুলগুলো নিজেদের ডকুমেন্টেশনেই কথাটা সোজা বলে: একটি নমুনা প্রোডাকশনের রূপভেদ প্রমাণ করতে পারে না — ঐচ্ছিকতা, তারিখের ফরম্যাট ও enum-মানে মানুষের পর্যালোচনা চাই। তাই অভ্যাস গড়ুন: পেস্টের আগে এমন রেসপন্স জড়ো করুন যা পার্থক্য সবচেয়ে সহজে ফাঁস করে (খালি তালিকা, সব ফিল্ড, null-ভরা একটি); তৈরির পর আউটপুটকে খসড়া ধরুন, জমা নয়। ইন্টারফেসের চুক্তি-ডকুমেন্ট থাকলে JSON Schema দিয়ে বাধাগুলো স্পষ্ট করুন এবং তৈরি কোড তার সঙ্গে সারিবদ্ধ করুন — নমুনা থেকে অনুমানকে গুণে হারায়। একই সমস্যার আড়াআড়ি দৃষ্টিতে Java পাশ আমাদের Java জেনারেটরের মাঠপরীক্ষায়, ফ্রন্টএন্ড চুক্তি TypeScript ইন্টারফেসে; সাংখ্যিক নির্ভুলতার উপত্যকা প্রতি ভাষায় ভিন্ন ছদ্মবেশে ফিরে আসে, বিস্তারিত JSON-এর বড় সংখ্যার ফাঁদে।
তৈরির পর কোন ফিল্ডগুলো এখনো হাতে পরিমার্জন চায়?
অন্তত চারটি: any fallback, সাংখ্যিক প্রস্থ (float64 → int64), ঐচ্ছিক ফিল্ড পয়েন্টার করা, এবং তারিখের ফিল্ড string না time.Time হবে কি না। চারটিই নমুনায় অদৃশ্য প্রোডাকশন-রূপভেদ; জেনারেটর অনুমান করে না, মানুষকে পূরণ করতে হয়।
omitempty যোগ করার পরও আমার ফিল্ড JSON-এ কেন আসে?
omitempty কেবল শূন্য মান এড়ায়: false, 0, "", nil, খালি slices। খালি struct {} শূন্য মান নয়, তাই বেঁচে থাকে — ফিল্ড পয়েন্টার করুন। শূন্য time.Time-এর দরকার omitzero, omitempty নয়।
ডিসিরিয়ালাইজের পর আমার বড় পূর্ণসংখ্যা ID কেন বদলে গেল?
স্পষ্ট টাইপ ছাড়া encoding/json সংখ্যা float64 পার্স করে, যার ম্যান্টিসা ৫৩ বিট; 2^53-এর বাইরের পূর্ণসংখ্যা নির্ভুলতা হারায়। ফিল্ড int64 টাইপ করুন, বা UseNumber() ডাকুন যাতে সংখ্যা json.Number হিসেবে থাকে।
নেস্টেড অবজেক্ট-ফিল্ড কখন পয়েন্টার হওয়া উচিত?
দুটি ক্ষেত্রে: ফিল্ড অনুপস্থিত বা null হতে পারে (nil "পাঠানো হয়নি" আলাদা করে "শূন্য মান" থেকে), আর PATCH রিকোয়েস্টকে "পাঠানো হয়নি" ও "মুছতে null পাঠানো" আলাদা করতে হয়। সাধারণ non-nullable ফিল্ডওয়ালা রেসপন্স-struct-এ ভ্যালু-টাইপ নিরাপদ — nil-চেকের খরচ কেবল আলাদা করা সত্যিই দরকার হলে দিন।