Udhëzues për skemën JSON
Përpara se të kalojmë në skemën JSON, është e rëndësishme të dimë ndryshimin midis skemës JSON dhe JSON.
JSON
JSON është shkurtim i JavaScript Object Notation dhe është një format i të dhënave i pavarur nga gjuha që përdorin API-të për të dërguar kërkesa dhe përgjigje. JSON është i thjeshtë për t'u lexuar dhe shkruar për njerëzit dhe makinat njësoj. JSON është një format i bazuar në tekst që nuk është i lidhur me gjuhën (e pavarur nga gjuha).
Skema JSON
Skema JSON është një mjet i dobishëm për verifikimin e strukturës së të dhënave JSON. Për të specifikuar strukturën e JSON, përdorni një format të bazuar në JSON. Qëllimi i tij është të sigurojë që të dhënat JSON janë të pranueshme. Konventa për të dhënat JSON të aplikacionit tonë mund të përcaktohet duke përdorur skemën.
Ekzistojnë tre seksione kryesore për specifikimin e skemës JSON:
Hiper-Skema JSON:
JSON Hyper-Schema është një gjuhë Skema JSON që mund të përdoret për të etiketuar dokumentet JSON me hiperlidhje dhe udhëzime për përpunimin dhe ndryshimin e burimeve të jashtme JSON nëpërmjet mjediseve të bazuara në tekst si HTTP. Klikoni këtu për të mësuar më shumë rreth JSON Hyper-Schema.
Bërthama e skemës JSON:
Është një grup rregullash për etiketimin dhe vërtetimin e dokumenteve JSON.
Bërthama e skemës JSON:
- Përshkruan formatin e të dhënave që keni aktualisht.
- Vërteton të dhënat që mund të përdoren në testimin e automatizuar.
- Sigurimi i saktësisë së të dhënave të dhëna nga klientët.
- Ofron dokumentacion të lexueshëm si për njerëzit ashtu edhe për makineritë.
Vleresimi i skemës JSON:
Vërtetimi i bazuar në skemën JSON vendos kufizime në strukturën e të dhënave të shembullit. Pas kësaj, çdo fjalë kyçe që nuk ka pohim informacion, të tilla si meta të dhënat përshkruese dhe indikacionet e përdorimit, i shtohen një pozicioni shembulli që plotëson të gjitha kufizimet e deklaruara.
Mjeti JSON Schema Validator i Newtonsoft është një mjet që mund ta përdorni drejtpërdrejt në shfletuesin tuaj, pa pagesë. Ju mund ta përdorni këtë mjet për të testuar strukturën e skemës suaj JSON. Kjo faqe përmban kontrolle dhe shpjegime për të filluar. Në këtë mënyrë, është e lehtë të shihet se si të përmirësoni strukturën tuaj JSON.
Ne mund të kontrollojmë objektin tonë JSON duke përdorur Mjetin e Vlefshmërisë së Skemës JSON:
Kemi vërtetimin e moshës (minimumi = 20 dhe maksimumi = 40) siç tregohet në figurën e mësipërme. Nuk u gjetën gabime.
Shfaqi një gabim nëse vërtetimi i moshës ishte futur gabimisht.
Krijimi i një skeme JSON
Le të shohim një shembull të Skemës JSON për të parë se për çfarë po flasim. Një objekt bazë JSON që përshkruan një katalog produktesh është si më poshtë:
Skema e saj JSON mund të shkruhet si më poshtë:
Një skemë JSON është një dokument JSON dhe ai dokument DUHET të jetë një objekt. Fjalët kyçe janë anëtarë/atribute objektesh të specifikuara nga Skema JSON. "Fjalë kyçe" në skemën JSON i referohen pjesës "çelës" të një kombinimi çelës/vlerë në një objekt. Shkrimi i një Skema JSON përfshin hartimin e një "fjalë kyçe" të veçantë në një vlerë brenda një objekti në pjesën më të madhe.
Le të hedhim një vështrim më të afërt në fjalët kyçe që kemi përdorur në shembullin tonë:
Skema JSON me të cilën përputhet skema e burimit shkruhet nga ky atribut. Kjo skemë është shkruar duke ndjekur standardin draft v4, siç specifikohet nga "skema $"fjalë kyçe. Kjo parandalon që skema juaj të kthehet në versionin aktual, i cili mund të jetë ose jo i pajtueshëm me versionin e vjetër.
"titull"Dhe"përshkrim” fjalë kyçe janë thjesht shpjeguese; ato nuk vendosin asnjë kufizim për të dhënat që kontrollohen. Këto dy fjalë kyçe përshkruajnë qëllimin e skemës: ajo përshkruan një produkt.
"lloj” fjala kyçe përcakton kushtin e parë kufitar të të dhënave tona JSON; duhet të jetë një objekt JSON. Nëse nuk caktojmë llojin për të gjitha skemat, kodi nuk do të funksiononte. Disa lloje të zakonshme janë "numër" "Boolean", "integer" "null" "object" "array" "string".
Skema JSON mbështetet nga bibliotekat e mëposhtme:
Gjuhe | Bibliotekë |
C | WJElement |
Piton | jschon |
PHP | Opis Json Skema |
JavaScript | ajv |
Go | gojsonschema |
Kotlin | Medeia-validator |
rubin | JSONSchemer |
JSON (Sintaksë)
Le të hedhim një vështrim të shkurtër në sintaksën themelore të JSON. Sintaksa JSON është një nëngrup i sintaksës JavaScript që përfshin elementët e mëposhtëm:
- Përdoren çiftet emër/vlerë që përfaqësojnë të dhëna.
- Objektet mbahen në kllapa kaçurrelë, dhe secili emër drejtohet nga një ':' (dy pika), me çiftet e vlerave të ndara me "," (presje).
- Vlerat ndahen me “,” (presje) dhe vargjet mbahen në kllapa katrore.
Dy strukturat e mëposhtme të të dhënave mbështeten nga JSON:
- Lista e renditur e vlerave: Mund të jetë një grup, një listë ose një vektor.
- Mbledhja e çifteve të emrit/vlerës: Gjuhë të ndryshme kompjuterike mbështesin këtë strukturë të të dhënave.
JSON (Objekt)
Një skemë JSON është një objekt JSON që përshkruan llojin dhe strukturën e një objekti të ndryshëm JSON. Një shprehje e objektit JavaScript mund të përfaqësojë një objekt JSON në mjediset e kohës së ekzekutimit të JavaScript. Disa shembuj të objekteve të vlefshme të skemës janë si më poshtë:
skemë | Shkrepëse |
{} | çdo vlerë |
{ type: 'objekt' } | një objekt JavaScript |
{ Lloji: 'numër' } | një numër JavaScript |
{ type: 'string'} | një varg JavaScript |
P.sh:
Krijimi i një objekti të ri që është bosh:
var JSON_Obj = {};
Krijimi i një objekti të ri:
var JSON_Obj = objekt i ri()
JSON (Krahasimi me XML)
JSON dhe XML janë formate të lexueshme nga njeriu, të pavarur nga gjuha. Në skenarët e botës reale, ata mund të krijojnë, lexojnë dhe deshifrojnë. Bazuar në kriteret e mëposhtme, ne mund të krahasojmë JSON me XML.
kompleksitet
Për shkak se XML është më kompleks se JSON, programuesit preferojnë JSON.
Përdorimi i vargjeve
XML përdoret për të shprehur të dhëna të strukturuara; megjithatë, XML nuk mbështet vargje, por JSON i mbështet.
Analizimi
JSON interpretohet duke përdorur funksionin eval të JavaScript. eval kthen objektin e përshkruar kur përdoret me JSON.
Shembull:
JSON | XML |
{ "kompania": Ferrari, "emri": "GTS", “Çmimi”: 404000 } |
Ferrari
GTS
404000
|
Përparësitë e skemës JSON
JSON është krijuar për të devijuar në një gjuhë të lexueshme nga njeriu dhe nga makineritë. Megjithatë, pa një rregullim të imët, nuk mund të jetë asnjëra. Skema JSON ka avantazhin që e bën JSON më të kuptueshëm si për makinat ashtu edhe për njerëzit.
Përdorimi i skemës JSON gjithashtu heq nevojën për disa përditësime nga ana e klientit. Bërja e një liste të kodeve të zakonshme HTML dhe më pas zbatimi i tyre në anën e klientit është një metodë tipike por e pasaktë për të ndërtuar nga ana e klientit API aplikacionet. Megjithatë, kjo nuk është strategjia më e mirë sepse ndryshimet në anën e serverit mund të shkaktojnë mosfunksionim të disa funksioneve.
Avantazhi kryesor i JSON Schema është përputhshmëria e tij me një sërë gjuhësh programimi, si dhe saktësia dhe qëndrueshmëria e vlefshmërisë.
Skema JSON mbështet një gamë të gjerë shfletuesish dhe sisteme operative, prandaj aplikacionet e shkruara në JSON nuk kërkojnë shumë përpjekje për t'i bërë të gjitha të pajtueshme me shfletuesin. Gjatë zhvillimit, zhvilluesit konsiderojnë disa shfletues, megjithëse JSON tashmë i ka aftësitë.
JSON është mënyra më efikase për të shkëmbyer të dhëna të çdo madhësie, duke përfshirë audio, video dhe media të tjera. Kjo për faktin se JSON ruan të dhënat në vargje, gjë që e bën më të lehtë transmetimin e të dhënave. Si rezultat, JSON është formati më i mirë i skedarit për API dhe zhvillim në internet.
Ndërsa API-të bëhen më të zakonshme, është logjike të supozohet se vërtetimi dhe testimi i API do të bëhen gjithnjë e më të rëndësishëm. Është gjithashtu realiste të pritet që JSON nuk ka të ngjarë të bëhet shumë më i thjeshtë me kalimin e kohës. Kjo nënkupton që të kesh një skemë për të dhënat e tua do të bëhet më kritike me kalimin e kohës. Për shkak se JSON është formati standard i skedarit për të punuar me API, JSON Schema është një zëvendësues i mirë për ata që punojnë me API.
