የJSON Schema መመሪያ
ወደ JSON Schema ከመግባታችን በፊት፣ በJSON እና JSON Schema መካከል ያለውን ልዩነት ማወቅ አስፈላጊ ነው።
JSON
JSON ለJavaScript Object Notation አጭር ነው፣ እና ኤፒአይዎች ጥያቄዎችን እና መልሶችን ለመላክ የሚጠቀሙበት ከቋንቋ ነጻ የሆነ የውሂብ ቅርጸት ነው። JSON ለሰዎች እና ለማሽን ለማንበብ እና ለመፃፍ ቀላል ነው። JSON ከቋንቋ ጋር የማይገናኝ በጽሑፍ ላይ የተመሠረተ ቅርጸት ነው (ቋንቋ ገለልተኛ)።
JSON እቅድ
JSON Schema የJSON ውሂብ መዋቅርን ለማረጋገጥ ጠቃሚ መሳሪያ ነው። የJSON አወቃቀሩን ለመግለጽ በJSON ላይ የተመሰረተ ቅርጸት ይጠቀሙ። ዓላማው የJSON ውሂብ ተቀባይነት ያለው መሆኑን ማረጋገጥ ነው። የኛ መተግበሪያ የJSON ውሂብ ስምምነት schema በመጠቀም ሊገለጽ ይችላል።
ለJSON Schema ዝርዝር መግለጫ ሦስት ዋና ዋና ክፍሎች አሉ፡
JSON Hyper-Schema፡-
JSON Hyper-Schema የJSON ሰነዶችን በሃይፐርሊንኮች ለመሰየም እና ውጫዊ የJSON ሃብቶችን በጽሁፍ - እንደ HTTP ባሉ አካባቢዎች ለመቀየር የሚያገለግል የJSON Schema ቋንቋ ነው። ጠቅ ያድርጉ እዚህ ስለ JSON Hyper-Schema የበለጠ ለማወቅ።
JSON Schema ኮር፡
JSON ሰነዶችን ለመሰየም እና ለማፅደቅ የሕጎች ስብስብ ነው።
JSON Schema ኮር፡
- አሁን ያለዎትን የውሂብ ቅርጸት ይገልጻል።
- በራስ-ሰር ሙከራ ውስጥ ጥቅም ላይ ሊውል የሚችል ውሂብ ያረጋግጣል።
- በደንበኞች የተሰጠውን የውሂብ ትክክለኛነት ማረጋገጥ.
- ለሁለቱም ሰዎች እና ማሽኖች ሊነበቡ የሚችሉ ሰነዶችን ያቀርባል.
የJSON እቅድ ማረጋገጫ፡
በJSON Schema ላይ የተመሰረተ ማረጋገጫ በአብነት ውሂብ አወቃቀር ላይ ገደቦችን ይጥላል። ከዚያ በኋላ ማንኛውም ቁልፍ ቃላቶች ማረጋገጫ የሌላቸው መረጃእንደ ገላጭ ሜታዳታ እና የአጠቃቀም አመላካቾች ያሉ ሁሉንም የታወጁ ገደቦችን ወደሚያሟላ የአብነት ቦታ ተጨምረዋል።
የኒውተንሶፍት JSON Schema አረጋጋጭ መሳሪያ በቀጥታ በአሳሽዎ ውስጥ በነጻ ሊጠቀሙበት የሚችሉበት መሳሪያ ነው። የJSON ንድፍዎን መዋቅር ለመፈተሽ ይህንን መሳሪያ መጠቀም ይችላሉ። ይህ ገጽ እርስዎን ለመጀመር መቆጣጠሪያዎችን እና ማብራሪያዎችን ይዟል። በዚህ መንገድ፣ የእርስዎን የJSON መዋቅር እንዴት ማሻሻል እንደሚቻል ማየት ቀላል ነው።
የJSON Schema ማረጋገጫ መሣሪያን በመጠቀም የኛን JSON ነገር ማረጋገጥ እንችላለን፡-
ከላይ በስዕሉ ላይ እንደሚታየው የዕድሜ ማረጋገጫ (ቢያንስ = 20 እና ከፍተኛ = 40) አለን። ምንም ስህተቶች አልተገኙም።
የእድሜ ማረጋገጫው በስህተት ከገባ ስህተት አሳይቷል።
የ JSON ንድፍ መፍጠር
የምንናገረውን ለማየት የJSON Schema ምሳሌን እንይ። የምርት ካታሎግ የሚገልጸው መሠረታዊ የJSON ነገር የሚከተለው ነው፡-
የእሱ የJSON መርሃ ግብር እንደሚከተለው ሊፃፍ ይችላል፡-
JSON Schema የJSON ሰነድ ነው፣ እና ያ ሰነድ እቃ መሆን አለበት። ቁልፍ ቃላቶች በJSON Schema የተገለጹ የነገር አባላት/ባህሪያት ናቸው። በJSON Schema ውስጥ ያሉት “ቁልፍ ቃላት” በአንድ ነገር ውስጥ ያለውን የቁልፍ/የዋጋ ጥምር “ቁልፍ” ክፍል ያመለክታሉ። የJSON Schema መፃፍ አንድን የተወሰነ "ቁልፍ ቃል" በአብዛኛው በአንድ ነገር ውስጥ ላለ እሴት ካርታ ማድረግን ያካትታል።
በምሳሌአችን ውስጥ የተጠቀምናቸውን ቁልፍ ቃላት በዝርዝር እንመልከታቸው፡-
የመርጃው እቅድ የሚያከብርበት የJSON እቅድ የተፃፈው በዚህ ባህሪ ነው። ይህ እቅድ የተፃፈው ረቂቆች v4 መስፈርትን በመከተል ነው፣ በ" በተገለጸው መሰረት$ እቅድ” ቁልፍ ቃል። ይሄ የእርስዎ እቅድ ወደ የአሁኑ ስሪት እንዳይመለስ ይከላከላል፣ ይህም ከቀድሞው ጋር ተኳሃኝ ላይሆን ይችላል ወይም ላይሆን ይችላል።
የ "አርእስት"እና"መግለጫ" ቁልፍ ቃላት ገላጭ ብቻ ናቸው; እየተፈተሸ ባለው መረጃ ላይ ምንም ገደቦችን አይጥሉም። እነዚህ ሁለት ቁልፍ ቃላቶች የመርሃግብርን አላማ ይገልፃሉ፡ ምርቱን ይገልፃል።
የ "ዓይነት” ቁልፍ ቃል የእኛን JSON ውሂብ የመጀመሪያ የድንበር ሁኔታን ይገልጻል። JSON Object መሆን አለበት። ለሁሉም መርሃግብሮች አይነት ካላዘጋጀን ኮዱ አይሰራም። አንዳንድ የተለመዱ ዓይነቶች "ቁጥር" "ቡሊያን" "ኢንቲጀር" "ኑል" "ነገር" "ድርድር" "ሕብረቁምፊ" ናቸው.
JSON Schema በሚከተሉት ቤተ-መጻሕፍት ይደገፋል፡
ቋንቋ | ቤተ መጻሕፍት |
C | WJElement |
ዘንዶ | jschoን |
ፒኤችፒ | Opis Json Schema |
ጃቫስክሪፕት | አጅቭ |
Go | gojsonschema |
Kotlin | ሚዲያ-አረጋጋጭ |
ሩቢ | JSONSchemer |
JSON (አገባብ)
የJSONን መሠረታዊ አገባብ በአጭሩ እንመልከት። JSON አገባብ የሚከተሉትን አካላት ያካተተ የጃቫስክሪፕት አገባብ ንዑስ ስብስብ ነው።
- ውሂብን የሚወክሉ ስም/እሴት ጥንዶች ጥቅም ላይ ይውላሉ።
- ነገሮች በተጠማዘዙ ማሰሪያዎች ውስጥ ተይዘዋል፣ እና እያንዳንዱ ስም በ':' (ኮሎን) ይመራል፣ የእሴት ጥንዶች በ “,” (ነጠላ ሰረዝ) ይለያሉ።
- እሴቶች በ "," (ነጠላ ሰረዝ) ይለያያሉ እና ድርድሮች በካሬ ቅንፎች ውስጥ ይያዛሉ.
የሚከተሉት ሁለት የውሂብ አወቃቀሮች በJSON ይደገፋሉ፡
- የታዘዙ የእሴቶች ዝርዝር፡- እሱ ድርድር፣ ዝርዝር ወይም ቬክተር ሊሆን ይችላል።
- የስም/የእሴት ጥንዶች ስብስብ፡- የተለያዩ የኮምፒውተር ቋንቋዎች ይህንን የውሂብ መዋቅር ይደግፋሉ።
JSON (ነገር)
የJSON schema የተለየ የJSON ነገር አይነት እና አወቃቀሩን የሚገልጽ የJSON ነገር ነው። የጃቫ ስክሪፕት ነገር አገላለጽ የJSON ነገርን በጃቫስክሪፕት አሂድ ጊዜ ሊወክል ይችላል። አንዳንድ ትክክለኛ የንድፍ እቃዎች ምሳሌዎች የሚከተሉት ናቸው፡
ብያኔ | ግጥሚያዎች |
{} | ማንኛውም ዋጋ |
{ አይነት: 'ነገር' } | የጃቫስክሪፕት ነገር |
{አይነት: 'ቁጥር'} | የጃቫስክሪፕት ቁጥር |
{ዓይነት፡ 'ሕብረቁምፊ'} | የጃቫስክሪፕት ሕብረቁምፊ |
ለምሳሌ-
ባዶ የሆነ አዲስ ነገር መሥራት;
var JSON_Obj = {};
አዲስ ነገር መፍጠር፡
var JSON_Obj = አዲስ ነገር ()
JSON (ከኤክስኤምኤል ጋር ማነፃፀር)
JSON እና XML ከቋንቋ ነጻ የሆኑ ሰው ሊነበቡ የሚችሉ ቅርጸቶች ናቸው። በገሃዱ ዓለም ሁኔታዎች፣ ሁለቱም መፍጠር፣ ማንበብ እና መፍታት ይችላሉ። በሚከተሉት መመዘኛዎች መሰረት፣ JSON ከኤክስኤምኤል ጋር ልናወዳድረው እንችላለን።
ውስብስብነት
XML ከJSON የበለጠ የተወሳሰበ ስለሆነ ፕሮግራመሮች JSONን ይመርጣሉ።
የድርድር አጠቃቀም
ኤክስኤምኤል የተዋቀረ መረጃን ለመግለጽ ጥቅም ላይ ይውላል; ቢሆንም፣ XML ድርድሮችን አይደግፍም፣ JSON ግን ይደግፋል።
መተካት።
JSON የሚተረጎመው የጃቫስክሪፕት ኢቫል ተግባርን በመጠቀም ነው። ኢቫል ከJSON ጋር ጥቅም ላይ ሲውል የተገለጸውን ነገር ይመልሳል።
ለምሳሌ:
JSON | XML |
{ "ኩባንያ": ፌራሪ, "ስም": "GTS", ዋጋ: 404000 } |
ፌራሪ
ጂቲኤስ
404000
|
የJSON ንድፍ ጥቅሞች
JSON በሰው እና በማሽን ሊነበብ በሚችል ቋንቋ ለመገልበጥ የተነደፈ ነው። ሆኖም ፣ ያለ አንዳንድ ጥሩ ማስተካከያ ፣ ሁለቱም ሊሆኑ አይችሉም። JSON Schema ለሁለቱም ማሽኖች እና ሰዎች JSON የበለጠ ለመረዳት የሚያስችል ጥቅም አለው።
የJSON Schemaን መጠቀም በተጨማሪ የደንበኛ-ጎን ማሻሻያዎችን አስፈላጊነት ያስወግዳል። የተለመዱ የኤችቲኤምኤል ኮዶችን ዝርዝር ማውጣት እና በደንበኛው በኩል መተግበር ከደንበኛ ጎን ለመገንባት የተለመደ ግን ትክክለኛ ያልሆነ ዘዴ ነው ። ኤ ፒ አይ መተግበሪያዎች. ነገር ግን ይህ ትልቁ ስልት አይደለም ምክንያቱም በአገልጋይ በኩል የሚደረጉ ለውጦች የተወሰኑ ተግባራትን እንዲሳኩ ሊያደርጉ ይችላሉ።
የJSON Schema ዋነኛው ጠቀሜታ ከተለያዩ የፕሮግራም አወጣጥ ቋንቋዎች ጋር መጣጣሙ፣ እንዲሁም የማረጋገጫው ትክክለኛነት እና ወጥነት ነው።
JSON schema ሰፋ ያለ አሳሾችን ይደግፋል ስርዓተ ክወናዎችስለዚህ በJSON የተፃፉ አፕሊኬሽኖች ሁሉንም አሳሽ ተኳሃኝ ለማድረግ ብዙ ጥረት አያደርጉም። በእድገት ጊዜ ገንቢዎች ብዙ አሳሾችን ግምት ውስጥ ያስገባሉ፣ ምንም እንኳን JSON ቀድሞውንም አቅም ቢኖረውም።
JSON ኦዲዮ፣ ቪዲዮ እና ሌላ ሚዲያን ጨምሮ ማንኛውንም መጠን ያለው ውሂብ ለማጋራት በጣም ቀልጣፋው መንገድ ነው። ይህ የሆነበት ምክንያት JSON መረጃን በድርድር ውስጥ ስለሚያከማች የውሂብ ማስተላለፍን ቀላል ያደርገዋል። በውጤቱም፣ JSON ለመስመር ላይ ኤፒአይዎች እና ልማት ምርጡ የፋይል ቅርጸት ነው።
ኤፒአይዎች ይበልጥ እየተለመዱ ሲሄዱ፣ የኤፒአይ ማረጋገጫ እና ሙከራ ከጊዜ ወደ ጊዜ አስፈላጊ ይሆናሉ ብሎ ማሰብ ምክንያታዊ ነው። JSON ጊዜ እያለፈ ሲሄድ በጣም ቀላል አይሆንም ብሎ መጠበቅም ምክንያታዊ ነው። ይህ የሚያመለክተው የውሂብዎ እቅድ መኖሩ ጊዜ እያለፈ ሲሄድ ይበልጥ ወሳኝ እየሆነ ይሄዳል። JSON ከኤፒአይዎች ጋር አብሮ ለመስራት መደበኛ የፋይል ፎርማት ስለሆነ፣ JSON Schema ከ APIs ጋር ለሚሰሩ ጥሩ ምትክ ነው።
