JSON से Go Struct जनरेटर

Go का स्टैटिक टाइप सिस्टम और इसका स्टैंडर्ड लाइब्रेरी `encoding/json` पैकेज, Go प्रोग्राम में JSON डेटा को हैंडल करने के लिए 'struct tag-based JSON serialization' को सबसे सही तरीका बनाते हैं। हर JSON की (key) एक struct फ़ील्ड से जुड़ी होती है, जिसमें एक संबंधित `json` struct टैग होता है। यह टैग सीरियलाइज़ेशन की की (key) का नाम, वैकल्पिक `omitempty` व्यवहार और वैकल्पिक स्ट्रिंग कन्वर्ज़न (coercion) बताता है। कॉम्प्लेक्स API रिस्पॉन्स पेलोड या बड़ी JSON कॉन्फ़िगरेशन फ़ाइलों के लिए इन struct डेफ़िनिशन को हाथ से लिखना समय लेने वाला और गलतियों की संभावना वाला काम है। डेवलपर्स अक्सर फ़ील्ड के नाम गलत टाइप कर देते हैं, गलत Go टाइप चुन लेते हैं, या struct टैग जोड़ना भूल जाते हैं। इन सभी वजहों से JSON अनमार्शलिंग (unmarshaling) के दौरान ऐसी साइलेंट फ़ेलियर (silent failures) होती हैं जिनका पता लगाना मुश्किल होता है। JSON उदाहरणों से Go structs को ऑटोमैटिक रूप से बनाने से इस तरह की गलतियाँ पूरी तरह खत्म हो जाती हैं।

JSON-से-Go कन्वर्ज़न के लिए टाइप इन्फ़रेंस नियम, JSON टाइप सिस्टम और Go के प्रिमिटिव और कम्पोजिट टाइप के बीच सीधे मैपिंग का पालन करते हैं। JSON स्ट्रिंग्स, Go स्ट्रिंग फ़ील्ड्स बन जाते हैं। JSON बूलियन वैल्यूज़, Go bool बन जाते हैं। JSON null एक खास मामला है: क्योंकि स्ट्रिंग्स, इंटीजर्स और बूलियन्स (खाली स्ट्रिंग, 0, false) के लिए Go की ज़ीरो वैल्यूज़ ऐसी मान्य वैल्यूज़ हैं जो JSON के 'अनुपस्थिति' (absence) वाले कॉन्सेप्ट से टकराती हैं, इसलिए nullable JSON फ़ील्ड्स को पॉइंटर टाइप (*string, *int64, *bool) के तौर पर टाइप किया जाना चाहिए ताकि Go का nil पॉइंटर, ज़ीरो वैल्यू से अलग JSON null को सही ढंग से दिखा सके। JSON एरेज़, एलिमेंट टाइप के आधार पर Go स्लाइस ([]string, []int64, []NestedStruct) बन जाते हैं। JSON ऑब्जेक्ट्स, नेस्टेड स्ट्रक्ट टाइप बन जाते हैं, जिनमें से हर एक का अपना स्ट्रक्ट डेफ़िनिशन होता है।

Go का encoding/json पैकेज मार्शलिंग और अनमार्शलिंग के व्यवहार को कंट्रोल करने के लिए struct टैग का इस्तेमाल करता है। json struct टैग सिंटैक्स `json:"keyname"` struct फ़ील्ड को JSON की से मैप करता है। टैग में अतिरिक्त विकल्प व्यवहार को कंट्रोल करते हैं: `json:"keyname,omitempty"` मार्शलिंग के दौरान फ़ील्ड को छोड़ देता है अगर उसमें उसका ज़ीरो वैल्यू हो, जिससे ऑप्शनल फ़ील्ड के लिए साफ़ JSON आउटपुट मिलता है; `json:"-"` फ़ील्ड को पूरी तरह से इग्नोर कर देता है; `json:"keyname,string"` न्यूमेरिक वैल्यू को JSON स्ट्रिंग में और उससे वापस बदलता है। जनरेटर हर फ़ील्ड के लिए बेसिक keyname टैग बनाता है। डेवलपर्स को ऑप्शनल फ़ील्ड के लिए omitempty जोड़ना चाहिए और अपने असल API कॉन्ट्रैक्ट के आधार पर नलेबल फ़ील्ड के लिए पॉइंटर टाइप का इस्तेमाल करना चाहिए।

यह JSON से Go Struct जनरेटर सही PascalCase एक्सपोर्टेड फ़ील्ड नामों, उपयुक्त टाइप वाले फ़ील्ड्स और ओरिजिनल JSON की-नेम (key names) वाले सटीक JSON स्ट्रक्ट टैग्स के साथ सही Go स्ट्रक्ट डेफ़िनिशन बनाता है। नेस्टेड JSON ऑब्जेक्ट्स को Go की नेमिंग कन्वेंशन के अनुसार अलग-अलग नाम वाले स्ट्रक्ट टाइप्स में निकाला जाता है। जब इस आउटपुट को सही पैकेज डिक्लेरेशन के साथ Go सोर्स फ़ाइल में पेस्ट किया जाता है, तो यह तुरंत कम्पाइल होने लायक होता है और encoding/json के साथ-साथ jsoniter और go-json जैसी लोकप्रिय थर्ड-पार्टी JSON लाइब्रेरीज़ के साथ भी कम्पैटिबल होता है। Go में API क्लाइंट डेवलपमेंट, माइक्रोसर्विस डेटा मॉडलिंग और कॉन्फ़िगरेशन पार्सिंग के लिए, यह टूल नए डेटा स्ट्रक्चर्स के लिए बूटस्ट्रैपिंग के समय को मिनटों के मैनुअल काम से घटाकर सेकंडों के ऑटोमेटेड जनरेशन में बदल देता है।