JSON eskemaren gida
JSON eskeman sartu aurretik, garrantzitsua da JSON eta JSON eskemaren arteko aldea ezagutzea.
JSON
JSON JavaScript Object Notation laburra da, eta APIek eskaerak eta erantzunak bidaltzeko erabiltzen duten hizkuntzaz kanpoko datu-formatu bat da. JSON irakurtzeko eta idazteko erraza da pertsonentzat eta makinentzat. JSON testuan oinarritutako formatua da, hizkuntzari lotuta ez dagoena (Hizkuntza independentea).
JSON eskema
JSON Schema JSON datuen egitura egiaztatzeko tresna erabilgarria da. JSONen egitura zehazteko, erabili JSONn oinarritutako formatua. Bere helburua JSON datuak onargarriak direla ziurtatzea da. Gure aplikazioaren JSON datuen konbentzioa eskema erabiliz defini daiteke.
JSON eskemaren zehaztapenean hiru atal nagusi daude:
JSON hipereskema:
JSON Hyper-Schema JSON eskema hizkuntza bat da, JSON dokumentuak etiketatzeko hiperestekekin eta kanpoko JSON baliabideak prozesatzeko eta aldatzeko jarraibideekin testuan oinarritutako inguruneen bidez HTTP bezalakoak. Egin klik hemen JSON Hyper-Schema-ri buruz gehiago jakiteko.
JSON eskema core:
JSON dokumentuak etiketatzeko eta baliozkotzeko arau multzo bat da.
JSON eskema core:
- Une honetan duzun datu-formatua deskribatzen du.
- Proba automatizatuetan erabil daitezkeen datuak balioztatzen ditu.
- Bezeroek emandako datuen zehaztasuna ziurtatzea.
- Dokumentazio irakurgarria eskaintzen du gizakientzat zein makinentzat.
JSON eskemaren baliozkotzea:
JSON eskeman oinarritutako baliozkotzeak instantzia-datuen egiturari mugak ezartzen dizkio. Horren ondoren, baieztapena ez duten gako-hitzak informazio, hala nola metadatu deskribatzaileak eta erabilera-adierazpenak, adierazitako muga guztiak betetzen dituen instantzia-posizio batean gehitzen dira.
Newtonsoft-en JSON Schema Validator tresna zure arakatzailean zuzenean erabil dezakezun tresna da, doan. Tresna hau erabil dezakezu zure JSON eskemaren egitura probatzeko. Orrialde honek kontrolak eta azalpenak ditu hasteko. Horrela, erraza da zure JSON egitura nola hobetu ikustea.
Gure JSON objektua egiaztatu dezakegu JSON eskema baliozkotzeko tresna erabiliz:
Adinaren baliozkotzea dugu (gutxienez = 20 eta gehienez = 40) goiko irudian ikusten den moduan. Ez da akatsik aurkitu.
Errore bat erakutsi du adinaren baliozkotzea gaizki sartu bada.
JSON eskema baten sorrera
Ikus dezagun JSON eskemaren adibide bat zertaz ari garen ikusteko. Produktu katalogo bat deskribatzen duen oinarrizko JSON objektu bat honako hau da:
Bere JSON eskema honela idatzi daiteke:
JSON eskema JSON dokumentu bat da, eta dokumentu horrek objektu bat izan BEHAR DU. Gako-hitzak JSON eskemak zehaztutako objektu/atributuak dira. JSON eskeman "gako-hitzak" objektu bateko gako/balio konbinazio baten "gako" zatiari egiten diote erreferentzia. JSON eskema idazteak "gako-hitz" jakin bat objektu baten balio batekin mapatzea dakar gehienetan.
Ikus ditzagun hurbilagotik gure adibidean erabili ditugun gako-hitzak:
Baliabidearen eskemak betetzen duen JSON eskema atributu honek idazten du. Eskema hau zirriborroak v4 estandarra jarraituz idatzita dago, "$ eskema” gako-hitza. Honek zure eskema egungo bertsiora itzultzea eragozten du, zaharragoekin bateragarria izan daitekeena edo ez.
El "izenburua"Eta"deskribapena” gako-hitzak azalpenak besterik ez dira; ez dute inolako mugarik ezartzen egiaztatzen diren datuei. Bi gako-hitz hauek eskemaren helburua deskribatzen dute: produktu bat deskribatzen du.
El "mota” keywords gure JSON datuen lehen muga-baldintza definitzen du; JSON objektu bat izan behar du. Eskema guztietarako mota ezartzen ez badugu, kodeak ez luke funtzionatuko. Mota arrunt batzuk "zenbakia" "boolearra" "osokoa" "null" "objektua" "matrizea" "katea" dira.
JSON Schema honako liburutegi hauek onartzen dute:
Hizkuntza | Liburutegia |
C | WJEelement |
Python | jschon |
PHP | Deskribapena: Json Schema |
Ikusteko Javascript-a | ajv |
Go | gojsonsskema |
Kotlin | Medeia-balidatzailea |
Ruby | JSONSchemer |
JSON (sintaxia)
Ikus dezagun JSON-ren oinarrizko sintaxiari. JSON sintaxia JavaScript sintaxiaren azpimultzo bat da, eta elementu hauek barne hartzen ditu:
- Datuak adierazten dituzten izen/balio bikoteak erabiltzen dira.
- Objektuak giltza kizkurren artean jartzen dira, eta izen bakoitza ':' (bi-bi puntu) batekin darama, balio-bikoteak "," (koma) bidez bereizita.
- Balioak "," (koma) bidez bereizten dira eta matrizeak kortxete artean daude.
Bi datu-egitura hauek JSON-ek onartzen ditu:
- Balioen zerrenda ordenatua: Array bat, zerrenda bat edo bektore bat izan daiteke.
- Izen/balio bikoteen bilduma: Lengoaia informatiko ezberdinek Datu Egitura hau onartzen dute.
JSON (objektua)
JSON eskema JSON objektu desberdin baten mota eta egitura zehazten dituen JSON objektu bat da. JavaScript objektuaren adierazpen batek JSON objektu bat irudika dezake JavaScript exekuzio-inguruneetan. Baliozko eskema-objektuen adibide batzuk hauek dira:
eskema | Partiduak |
{} | edozein balio |
{mota: 'objektua'} | JavaScript objektu bat |
{ mota: 'zenbakia'} | JavaScript zenbaki bat |
{ mota: 'katea'} | JavaScript kate bat |
adibidez:
Hutsik dagoen objektu berri bat egitea:
var JSON_Obj = {};
Objektu berria sortzea:
var JSON_Obj = objektu berria ()
JSON (XML-rekin alderatuta)
JSON eta XML hizkuntzatik kanpoko gizakiak irakur daitezkeen formatuak dira. Mundu errealeko eszenatokietan, biak sortu, irakurri eta deskodetu ditzakete. Ondorengo irizpideetan oinarrituta, JSON XMLrekin alderatu dezakegu.
konplexutasuna
XML JSON baino konplexuagoa denez, programatzaileek JSON nahiago dute.
Array-en erabilera
XML datu egituratuak adierazteko erabiltzen da; hala ere, XML-ek ez ditu matrizeak onartzen, baina JSONek bai.
parsing
JSON JavaScript-en eval funtzioa erabiliz interpretatzen da. eval-ek deskribatutako objektua itzultzen du JSONrekin erabiltzen denean.
Adibidea:
JSON | XML |
{ "konpainia": Ferrari, “izena”: “GTS”, "prezioa": 404000 } |
Ferrari
GTS
404000
|
JSON eskemaren abantailak
JSON gizakiek eta makinek irakurtzeko moduko hizkuntza batean desbideratzeko diseinatuta dago. Hala ere, doikuntzarik gabe, ezin da bata ez bestea izan. JSON Eskemak JSON ulergarriagoa egiteko abantaila du makinentzat zein gizakientzat.
JSON Eskema erabiltzeak bezeroen aldetik hainbat eguneratzeen beharra ere kentzen du. Ohiko HTML kodeen zerrenda egitea eta gero bezeroaren aldean ezartzea bezeroaren aldetik eraikitzeko metodo tipikoa baina zehaztugabea da. API aplikazioak. Hala ere, hau ez da estrategiarik onena zerbitzariaren alboko aldaketek funtzionalitate jakin batzuk gaizki funtzionatzea eragin dezaketelako.
JSON Schemaren abantaila nagusia hainbat programazio-lengoaiarekin bateragarria da, baita baliozkotzearen zehaztasuna eta koherentzia ere.
JSON eskemak arakatzaile ugari onartzen ditu eta sistema eragileak, beraz, JSONean idatzitako aplikazioek ez dute ahalegin handirik eskatzen arakatzaile guztiak bateragarriak izan daitezen. Garapenean, garatzaileek hainbat arakatzaile kontuan hartzen dituzte, nahiz eta JSONek dagoeneko gaitasunak baditu.
JSON da edozein tamainatako datuak partekatzeko modurik eraginkorrena, audioa, bideoa eta bestelako euskarriak barne. Hau da, JSONek datuak arrayetan gordetzen dituelako, eta horrek datuen transmisioa errazten du. Ondorioz, JSON lineako APIetarako eta garapenerako fitxategi formatu onena da.
APIak ohikoagoak diren heinean, logikoa da APIen baliozkotzea eta probak gero eta garrantzitsuago izango direla pentsatzea. Era berean, errealista da espero izatea JSON ez dela askoz errazagoa izango denborak aurrera egin ahala. Horrek esan nahi du zure datuetarako eskema bat edukitzea kritikoagoa izango dela denbora aurrera joan ahala. JSON APIekin lan egiteko fitxategi formatu estandarra denez, JSON Schema ordezko ona da APIekin lan egiten dutenentzat.
