Rêbernameya JSON Schema
Berî ku em biçin nav JSON Schema, girîng e ku em cûdahiya di navbera JSON û JSON Schema de bizanibin.
JSON
JSON kurteya JavaScript Object Notation e, û ew formatek daneya serbixwe-zimanî ye ku API ji bo şandina daxwaz û bersivan bikar tîne. JSON ji bo mirov û makîneyan ji bo xwendin û nivîsandinê hêsan e. JSON formatek li ser nivîsê ye ku bi ziman ve ne girêdayî ye (Ziman serbixwe).
JSON Schema
JSON Schema ji bo verastkirina avahiya daneya JSON amûrek bikêr e. Ji bo diyarkirina avahiya JSON-ê, formatek JSON-based bikar bînin. Armanca wê ew e ku piştrast bike ku daneyên JSON qebûl e. Dibe ku peymana ji bo daneyên JSON-ê yên serîlêdana me bi karanîna şemayê were destnîşankirin.
Sê beşên sereke yên taybetmendiya JSON Schema hene:
JSON Hyper-Schema:
JSON Hyper-Schema zimanek JSON Schema ye ku dibe ku were bikar anîn da ku belgeyên JSON bi hîpergirêdan û rêwerzan ji bo pêvajoyê û guheztina çavkaniyên JSON ên derveyî bi navgîniya nivîsê - hawîrdorên bingehîn ên mîna HTTP-ê nîşan bide. Bikirtînin vir ji bo bêtir fêrbûna JSON Hyper-Schema.
JSON Schema Core:
Ew ji bo nîşankirin û pejirandina belgeyên JSON komek rêzik e.
JSON Schema Core:
- Forma daneya ku we niha heye diyar dike.
- Daneyên ku dikarin di ceribandina otomatîkî de werin bikar anîn rast dike.
- Piştrastkirina rastiya daneyên ku ji hêla xerîdaran ve têne dayîn.
- Hem ji bo mirovan hem jî ji bo makîneyan belgeyên xwendinê peyda dike.
JSON Schema Validation:
Verastkirina li ser bingeha JSON Schema sînoran li ser avahiya daneyên nimûneyê ferz dike. Piştî vê yekê, her peyvên sereke yên ku ne-îddîa dikin agahî, wek metadata danasîn û nîşaneyên bikar anînê, li cîhek mînakek ku hemî astengiyên diyarkirî bicîh tîne têne zêde kirin.
Amûra JSON Schema Validator ya Newtonsoft amûrek e ku hûn dikarin rasterast di geroka xwe de, belaş bikar bînin. Hûn dikarin vê amûrê bikar bînin da ku strukturên şema JSON-a xwe ceribandin. Di vê rûpelê de kontrol û ravekirin hene ku hûn dest pê bikin. Bi vî rengî, hêsan e ku meriv çawa strukturek JSON-ya xwe baştir bike.
Em dikarin Tişta JSON-ya xwe bi karanîna Amûra Verastkirina Schema JSON kontrol bikin:
Weke ku di jimareya li jor de tê xuyang kirin, pejirandina temenê me heye (kêmtirîn = 20 û herî zêde = 40). Tu xeletî nehatin dîtin.
Heke erêkirina temen xelet hatibe nivîsandin xeletiyek nîşan dide.
Afirandina Schema JSON
Ka em li mînakek JSON Schema binêrin ku em li ser çi dipeyivin bibînin. Tiştek bingehîn a JSON ku katalogek hilberek diyar dike wiha ye:
Dibe ku JSON Schema wê bi vî rengî were nivîsandin:
JSON Schema belgeyek JSON e, û ew belge DIVÊ objeyek be. Peyvên sereke endamên / taybetmendiyên objektê ne ku ji hêla JSON Schema ve hatine destnîşankirin. "Peyvên sereke" di JSON Schema de beşa "kilît" ya berhevokek mifteyek / nirxê di tiştekê de vedibêjin. Nivîsandina Schema JSON bi piranî nexşeya "keyword"ek taybetî bi nirxek di hundurê tiştekê de digire.
Werin em hûrgulî li peyvên sereke yên ku me di mînaka xwe de bikar anîne binêrin:
Şemaya JSON ya ku şemaya çavkaniyê pê re ye ji hêla vê taybetmendiyê ve tê nivîsandin. Ev şema li gorî pêşnûmeyên v4 standard hatî nivîsandin, wekî ku ji hêla "$ schema” keyword. Ev rê nade ku şemaya we vegere guhertoya heyî, ya ku dibe ku bi kevintir re hevaheng be an nebe.
The "nav"Û"terîf” peyvên sereke tenê raveker in; ew li ser daneyên ku têne kontrol kirin ti sînordar nakin. Ev her du peyvên sereke armanca schema diyar dikin: ew hilberek diyar dike.
The "awa” keyword şerta sînorê yekem a daneya JSON me diyar dike; divê ew JSON Objekt be. Ger em tîp ji bo hemî şemayan saz nekin, kod dê nexebite. Hin cûreyên gelemperî "hejmar" "Boolean" "tevjimar" "null" "object" "array" "string" in.
JSON Schema ji hêla pirtûkxaneyên jêrîn ve tê piştgirî kirin:
Ziman | Pirtûkxane |
C | WJElement |
python | jschon |
PHP | Opis Json Schema |
JavaScript | ajv |
Go | gojsonschema |
Kotlin | Medeia-validator |
Cewher | JSONSchemer |
JSON (Sîntaks)
Ka em bi kurtasî li hevoksaziya bingehîn a JSON binêrin. Hevoksaziya JSON binkomek hevoksaziya JavaScriptê ye ku hêmanên jêrîn vedihewîne:
- Cotên nav/nirx têne bikar anîn ku daneyan temsîl dikin.
- Tişt di nav kêşan de têne girtin, û her navek bi ':' (kolon), bi cotên nirxan bi "," (komma) veqetandî ye.
- Nirx bi “,” (komma) ji hev têne veqetandin û rêzik di kemberên çargoşe de têne girtin.
Du strukturên daneya jêrîn ji hêla JSON ve têne piştgirî kirin:
- Lîsteya rêzkirî ya nirxan: Ew dikare rêzek, navnîşek an vektorek be.
- Komkirina cotên nav/nirx: Zimanên cuda yên kompîturê piştgirî didin vê Struktura Daneyê.
JSON (Object)
Şemayek JSON hêmanek JSON e ku celeb û strûktûra tiştek JSON cûda diyar dike. Gotarek tişta JavaScript dikare di hawîrdorên dema xebitandinê yên JavaScript de hêmanek JSON temsîl bike. Hin mînakên tiştên şema yên derbasdar wiha ne:
Schema | Matches |
{} | her nirx |
{typ: 'objekt'} | tiştek JavaScript |
{typ: 'hejmar'} | hejmarek JavaScript |
{typ: 'string'} | rêzikek JavaScriptê |
Mînak:
Çêkirina tiştekî nû ya ku vala ye:
var JSON_Obj = {};
Afirandina Tiştên Nû:
var JSON_Obj = tişta nû()
JSON (Berhevdana bi XML re)
JSON û XML formatên mirov-xwende yên serbixwe-zimanî ne. Di senaryoyên cîhana rastîn de, ew dikarin hem biafirînin, hem bixwînin, hem jî deşîfre bikin. Li ser bingeha pîvanên jêrîn, em dikarin JSON bi XML re bidin hev.
Tevlîheviyê
Ji ber ku XML ji JSON tevlihevtir e, bernamenûs JSON tercîh dikin.
Bikaranîna Arrays
XML ji bo îfadekirina daneyên sazkirî tê bikar anîn; lêbelê, XML array piştgirî nake, lê JSON piştgirî dike.
Parsing
JSON bi karanîna fonksiyona evalê ya JavaScriptê tê şîrove kirin. eval dema ku bi JSON re tê bikar anîn, tiştê diyarkirî vedigerîne.
Mînak:
JSON | XML |
{ "şîrket": Ferrari, "nav": "GTS", "biha": 404000 } |
Ferrari
GTS
404000
|
Avantajên Schema JSON
JSON hatiye dîzaynkirin ku bi zimanekî mirovî û makîne-xwendinê veqetîne. Lêbelê, bêyî hin hûrgulî, ew yek jî nabe. JSON Schema xwedan avantaj e ku JSON hem ji bo makîneyan û hem jî ji mirovan re bêtir tê fêm kirin.
Bikaranîna JSON Schema di heman demê de hewcedariya çend nûvekirinên alîgirê xerîdar jî radike. Amadekirina navnîşek kodên HTML-ê yên hevpar û dûv re pêkanîna wan li ser milê xerîdar, rêbazek tîpîk lê nerast e ku ji bo avakirina aliyê xerîdar. API apps. Lêbelê, ev ne stratejiya herî mezin e ji ber ku guhertinên li ser server-aliyê dibe ku bibe sedema xirabkirina hin fonksiyonan.
Feydeya sereke ya JSON Schema lihevhatina wê bi cûrbecûr zimanên bernamekirinê re, û hem jî rastbûn û domdariya pejirandinê ye.
JSON schema gelek gerok û gerok piştgirî dike pergalên xebitandinê, ji ber vê yekê sepanên ku bi JSON hatine nivîsandin zêde hewil nadin ku wan hemî gerokê li hev bikin. Di dema pêşkeftinê de, pêşdebiran çend gerokan dihesibînin, her çend JSON berê xwedan kapasîteyên e.
JSON awayê herî bikêr e ji bo parvekirina daneyên her mezinahiyê, di nav de deng, vîdyo û medyayên din. Ev ji ber vê yekê ye ku JSON daneyan di rêzan de hilîne, ku veguheztina daneyê hêsantir dike. Wekî encamek, JSON ji bo API û pêşkeftina serhêl forma pelê çêtirîn e.
Her ku API gelemperî dibin, mentiqî ye ku meriv texmîn bike ku pejirandin û ceribandina API-ê dê her ku diçe girîngtir bibe. Di heman demê de realîst e ku meriv li bendê be ku JSON her ku diçe pir hêsan nabe. Ev tê vê wateyê ku hebûna nexşeyek ji bo daneyên we her ku diçe krîtîktir dibe. Ji ber ku JSON ji bo xebata bi API-yan re forma pelê standard e, JSON Schema ji bo kesên ku bi API-yê re dixebitin cîgirek baş e.
