JSON स्कीमासाठी मार्गदर्शक
JSON स्कीमामध्ये जाण्यापूर्वी, JSON आणि JSON स्कीमामधील फरक जाणून घेणे महत्त्वाचे आहे.
JSON
JSON हे JavaScript ऑब्जेक्ट नोटेशनसाठी लहान आहे आणि हे एक भाषा-स्वतंत्र डेटा स्वरूप आहे जे API विनंत्या आणि उत्तरे पाठवण्यासाठी वापरतात. JSON लोकांसाठी आणि मशीन्ससाठी सारखेच वाचणे आणि लिहिणे सोपे आहे. JSON हा मजकूर-आधारित स्वरूप आहे जो भाषेला बांधील नाही (भाषा स्वतंत्र).
JSON स्कीमा
JSON डेटा संरचना सत्यापित करण्यासाठी JSON स्कीमा हे एक उपयुक्त साधन आहे. JSON ची रचना निर्दिष्ट करण्यासाठी, JSON-आधारित स्वरूप वापरा. JSON डेटा स्वीकार्य आहे याची खात्री करणे हा त्याचा उद्देश आहे. आमच्या ऍप्लिकेशनच्या JSON डेटासाठीचे नियम स्कीमा वापरून परिभाषित केले जाऊ शकतात.
JSON स्कीमा तपशीलाचे तीन मुख्य विभाग आहेत:
JSON हायपर-स्कीमा:
JSON Hyper-Schema ही JSON स्कीमा भाषा आहे जी JSON दस्तऐवजांना हायपरलिंकसह लेबल करण्यासाठी वापरली जाऊ शकते आणि HTTP सारख्या मजकूर-आधारित वातावरणाद्वारे बाह्य JSON संसाधनांवर प्रक्रिया करण्यासाठी आणि बदलण्यासाठी सूचना. क्लिक करा येथे JSON हायपर-स्कीमा बद्दल अधिक जाणून घेण्यासाठी.
JSON स्कीमा कोर:
हे JSON दस्तऐवज लेबलिंग आणि प्रमाणित करण्यासाठी नियमांचा संच आहे.
JSON स्कीमा कोर:
- तुमच्याकडे सध्या असलेल्या डेटा फॉरमॅटचे वर्णन करते.
- स्वयंचलित चाचणीमध्ये वापरता येणारा डेटा प्रमाणित करते.
- ग्राहकांनी दिलेल्या डेटाच्या अचूकतेची खात्री करणे.
- मानव आणि मशीन दोघांसाठी वाचनीय दस्तऐवज प्रदान करते.
JSON स्कीमा प्रमाणीकरण:
JSON स्कीमावर आधारित प्रमाणीकरण उदाहरण डेटाच्या संरचनेवर मर्यादा घालते. त्यानंतर, कोणतेही कीवर्ड ज्यामध्ये गैर-प्रतिपादन आहे माहिती, जसे की वर्णनात्मक मेटाडेटा आणि वापर संकेत, सर्व घोषित मर्यादांची पूर्तता करणाऱ्या उदाहरण स्थितीत जोडले जातात.
Newtonsoft चे JSON Schema Validator टूल हे एक साधन आहे जे तुम्ही थेट तुमच्या ब्राउझरमध्ये विनामूल्य वापरू शकता. तुमच्या JSON स्कीमाच्या संरचनेची चाचणी घेण्यासाठी तुम्ही हे साधन वापरू शकता. या पृष्ठामध्ये तुम्हाला प्रारंभ करण्यासाठी नियंत्रणे आणि स्पष्टीकरणे आहेत. अशा प्रकारे, तुमची JSON रचना कशी सुधारायची हे पाहणे सोपे आहे.
आम्ही JSON स्कीमा प्रमाणीकरण साधन वापरून आमचे JSON ऑब्जेक्ट तपासू शकतो:
वरील आकृतीमध्ये दाखवल्याप्रमाणे आमच्याकडे वय प्रमाणीकरण (किमान = 20 आणि कमाल = 40) आहे. कोणत्याही त्रुटी आढळल्या नाहीत.
जर वय प्रमाणीकरण चुकीचे प्रविष्ट केले असेल तर ते एक त्रुटी प्रदर्शित करते.
JSON स्कीमाची निर्मिती
आपण कशाबद्दल बोलत आहोत हे पाहण्यासाठी JSON स्कीमाचे उदाहरण पाहू या. उत्पादन कॅटलॉगचे वर्णन करणारे मूलभूत JSON ऑब्जेक्ट खालीलप्रमाणे आहे:
त्याची JSON स्कीमा खालीलप्रमाणे लिहिली जाऊ शकते:
JSON स्कीमा एक JSON दस्तऐवज आहे आणि तो दस्तऐवज एक ऑब्जेक्ट असणे आवश्यक आहे. कीवर्ड हे JSON स्कीमाद्वारे निर्दिष्ट केलेले ऑब्जेक्ट सदस्य/विशेषता आहेत. JSON स्कीमा मधील “कीवर्ड” हे ऑब्जेक्टमधील की/मूल्य संयोजनाच्या “की” भागाचा संदर्भ देतात. JSON स्कीमा लिहिण्यामध्ये बहुतेक भागासाठी ऑब्जेक्टमधील मूल्यावर विशिष्ट "कीवर्ड" मॅप करणे समाविष्ट असते.
आम्ही आमच्या उदाहरणात वापरलेले कीवर्ड जवळून पाहू:
संसाधनाचा स्कीमा ज्याचे पालन करते ती JSON स्कीमा या विशेषताद्वारे लिहिली जाते. हा स्कीमा ड्राफ्ट v4 मानकांनुसार लिहिलेला आहे, जसे की "ma स्कीमा" कीवर्ड. हे तुमच्या स्कीमाला वर्तमान आवृत्तीवर परत येण्यापासून प्रतिबंधित करते, जी जुन्याशी सुसंगत असू शकते किंवा नाही.
"शीर्षक"आणि"वर्णन" कीवर्ड फक्त स्पष्टीकरणात्मक आहेत; ते तपासल्या जात असलेल्या डेटावर कोणतीही मर्यादा घालत नाहीत. हे दोन कीवर्ड स्कीमाच्या उद्देशाचे वर्णन करतात: ते उत्पादनाचे वर्णन करतात.
"प्रकार” कीवर्ड आमच्या JSON डेटाची पहिली सीमा स्थिती परिभाषित करतो; ते JSON ऑब्जेक्ट असणे आवश्यक आहे. आम्ही सर्व स्कीमांसाठी प्रकार सेट न केल्यास, कोड कार्य करणार नाही. काही सामान्य प्रकार म्हणजे “संख्या” “बूलियन” “पूर्णांक” “नल” “ऑब्जेक्ट” “अॅरे” “स्ट्रिंग”.
JSON स्कीमा खालील लायब्ररीद्वारे समर्थित आहे:
भाषा | ग्रंथालय |
C | WJElement |
python ला | jschon |
कृपया PHP | Opis Json स्कीमा |
जावास्क्रिप्ट | ajv |
Go | gojsonschema |
कोटलिन | मीडिया-प्रमाणीकरणकर्ता |
रुबी | JSONSchemer |
JSON (वाक्यरचना)
जेएसओएनच्या मूलभूत वाक्यरचनाकडे थोडेसे पाहू. JSON सिंटॅक्स हा JavaScript सिंटॅक्सचा एक उपसंच आहे ज्यामध्ये खालील घटक समाविष्ट आहेत:
- डेटाचे प्रतिनिधित्व करणाऱ्या नाव/मूल्याच्या जोड्या वापरल्या जातात.
- वस्तू कुरळे ब्रेसेसमध्ये धरल्या जातात आणि प्रत्येक नावाचे नेतृत्व ':' (कोलन) केले जाते, ज्यामध्ये मूल्य जोड्या “,” (स्वल्पविराम) ने विभक्त केल्या जातात.
- मूल्ये “,” (स्वल्पविराम) द्वारे विभक्त केली जातात आणि अॅरे चौरस कंसात ठेवल्या जातात.
खालील दोन डेटा स्ट्रक्चर्स JSON द्वारे समर्थित आहेत:
- मूल्यांची क्रमबद्ध सूची: हे अॅरे, सूची किंवा वेक्टर असू शकते.
- नाव/मूल्य जोड्यांचा संग्रह: विविध संगणक भाषा या डेटा स्ट्रक्चरला समर्थन देतात.
JSON (ऑब्जेक्ट)
JSON स्कीमा एक JSON ऑब्जेक्ट आहे जो भिन्न JSON ऑब्जेक्टचा प्रकार आणि रचना दर्शवितो. JavaScript ऑब्जेक्ट एक्सप्रेशन JavaScript रनटाइम वातावरणात JSON ऑब्जेक्टचे प्रतिनिधित्व करू शकते. वैध स्कीमा ऑब्जेक्ट्सची काही उदाहरणे खालीलप्रमाणे आहेत:
स्कीमा | सामने |
{} | कोणतेही मूल्य |
{ प्रकार: 'ऑब्जेक्ट' } | JavaScript ऑब्जेक्ट |
{ प्रकार: 'नंबर' } | JavaScript क्रमांक |
{ प्रकार: 'स्ट्रिंग'} | JavaScript स्ट्रिंग |
उदा:
रिक्त असलेली नवीन वस्तू तयार करणे:
var JSON_Obj = {};
नवीन ऑब्जेक्ट निर्मिती:
var JSON_Obj = नवीन ऑब्जेक्ट()
JSON (XML सह तुलना)
JSON आणि XML हे भाषा-स्वतंत्र मानव-वाचनीय स्वरूप आहेत. वास्तविक-जगातील परिस्थितींमध्ये, ते दोन्ही तयार करू शकतात, वाचू शकतात आणि डीकोड करू शकतात. खालील निकषांवर आधारित, आम्ही JSON ची XML शी तुलना करू शकतो.
जटिलता
XML JSON पेक्षा अधिक जटिल असल्यामुळे, प्रोग्रामर JSON ला प्राधान्य देतात.
अॅरेचा वापर
XML संरचित डेटा व्यक्त करण्यासाठी वापरला जातो; तथापि, XML अॅरेला समर्थन देत नाही, परंतु JSON करते.
पार्सिंग
JavaScript चे eval फंक्शन वापरून JSON चा अर्थ लावला जातो. JSON सह वापरल्यास eval वर्णन केलेले ऑब्जेक्ट परत करते.
उदाहरण:
JSON | एक्स एम एल |
{ "कंपनी": फेरारी, "नाव": "GTS", "किंमत": 404000 } |
फेरारी
GTS
404000
|
JSON स्कीमा फायदे
JSON ची रचना मानवी- आणि मशीन-वाचनीय भाषेत विचलित करण्यासाठी केली आहे. तथापि, काही सूक्ष्म-ट्यूनिंगशिवाय, ते दोन्हीही असू शकत नाही. JSON स्कीमाचा फायदा मशीन आणि मानव दोघांसाठी JSON अधिक समजण्यायोग्य बनवण्याचा आहे.
JSON स्कीमा वापरणे अनेक क्लायंट-साइड अद्यतनांची आवश्यकता देखील काढून टाकते. सामान्य HTML कोडची सूची बनवणे आणि नंतर क्लायंटच्या बाजूने त्यांची अंमलबजावणी करणे ही क्लायंट-साइड तयार करण्यासाठी एक सामान्य परंतु चुकीची पद्धत आहे. API अॅप्स तथापि, ही सर्वात मोठी रणनीती नाही कारण सर्व्हर-साइडवरील बदलांमुळे काही कार्यक्षमता खराब होऊ शकतात.
JSON स्कीमाचा मुख्य फायदा म्हणजे त्याची विविध प्रोग्रामिंग भाषांशी सुसंगतता, तसेच प्रमाणीकरणाची अचूकता आणि सुसंगतता.
JSON स्कीमा ब्राउझरच्या विस्तृत श्रेणीचे समर्थन करते आणि ऑपरेटिंग सिस्टम, म्हणून JSON मध्ये लिहिलेले अॅप्स ते सर्व ब्राउझर सुसंगत बनवण्यासाठी जास्त मेहनत घेत नाहीत. विकासादरम्यान, विकासक अनेक ब्राउझरचा विचार करतात, जरी JSON कडे आधीपासूनच क्षमता आहेत.
JSON हा ऑडिओ, व्हिडिओ आणि इतर माध्यमांसह कोणत्याही आकाराचा डेटा शेअर करण्याचा सर्वात कार्यक्षम मार्ग आहे. हे JSON अॅरेमध्ये डेटा संचयित करते या वस्तुस्थितीमुळे आहे, ज्यामुळे डेटा ट्रान्समिशन सोपे होते. परिणामी, JSON ऑनलाइन API आणि विकासासाठी सर्वोत्तम फाइल स्वरूप आहे.
जसजसे API अधिक सामान्य होत जातात, तसतसे API प्रमाणीकरण आणि चाचणी अधिकाधिक महत्त्वपूर्ण होत जाईल असे मानणे तर्कसंगत आहे. वेळ पुढे जात असताना JSON अधिक सोपे होण्याची शक्यता नाही अशी अपेक्षा करणे देखील वास्तववादी आहे. याचा अर्थ असा आहे की तुमच्या डेटासाठी स्कीमा असणे ही वेळ जसजशी अधिक गंभीर होत जाईल. API सह कार्य करण्यासाठी JSON हे मानक फाइल स्वरूप असल्यामुळे, API सह काम करणाऱ्यांसाठी JSON स्कीमा हा एक चांगला पर्याय आहे.
