Aratohu ki te JSON Schema
I mua i to urunga ki roto JSON Schema, he mea nui kia mohio koe ki te rereketanga o JSON me JSON Schema.
JSON
He poto a JSON mo te JavaScript Object Notation, a he whakatakotoranga raraunga motuhake-reo e whakamahia ana e nga API ki te tuku tono me nga whakautu. He ngawari a JSON ki te panui me te tuhi mo nga tangata me nga miihini. Ko te JSON he whakatakotoranga-a-tuhi kaore e herea ki te reo (Reo motuhake).
Kaupapa JSON
Ko te JSON Schema he taputapu whai hua hei manatoko i te hanganga raraunga JSON. Hei tautuhi i te hanganga o JSON, whakamahia te whakatakotoranga-a-JSON. Ko tana kaupapa ko te whakarite kia whakaaetia nga raraunga JSON. Ko te tikanga mo nga raraunga JSON o taatau tono ka taea te tautuhi ma te whakamahi i te aronuinga.
E toru nga waahanga matua ki te tohu JSON Schema:
Kaupapa-Tukupapa JSON:
Ko te JSON Hyper-Schema he reo JSON Schema ka taea te whakamahi ki te tapanga i nga tuhinga JSON me nga honongaitua me nga tohutohu mo te tukatuka me te whakarereke i nga rauemi JSON o waho ma nga taiao-a-tuhi penei i te HTTP. Pāwhiri ki konei ki te ako atu mo JSON Hyper-Schema.
JSON Aronui Matua:
He huinga ture mo te tapanga me te whakamana i nga tuhinga JSON.
JSON Aronui Matua:
- He whakaahua i te whakatakotoranga raraunga kei a koe inaianei.
- Ka whakamanahia nga raraunga ka taea te whakamahi i nga whakamatautau aunoa.
- Te whakarite i te tika o nga raraunga i homai e nga kaihoko.
- Ka whakarato tuhinga panui mo nga tangata me nga miihini.
Whakamanatanga Kaupapa JSON:
Ko te whakamanatanga i runga i te JSON Schema ka whakatau i nga rohe mo te hanganga o nga raraunga tauira. Whai muri i tera, ko nga kupu matua kaore he whakapae mōhiohio, penei i te metadata whakaahuatanga me nga tohu whakamahi, ka taapirihia ki tetahi tuunga tauira e tutuki ana i nga here katoa kua kiia.
Ko te taputapu JSON Schema Validator a Newtonsoft he taputapu ka taea e koe te whakamahi tika ki to kaitirotiro, kaore he utu. Ka taea e koe te whakamahi i tenei taputapu hei whakamatautau i te hanganga o to kaupapa JSON. Kei tenei wharangi nga mana whakahaere me nga whakamarama kia timata koe. Ma tera ara, he ngawari ki te kite me pehea te whakapai ake i to hanganga JSON.
Ka taea e taatau te tirotiro i ta maatau JSON Ahanoa ma te whakamahi i te Utauta Whakamana Kaupapa JSON:
Kei a matou te whakamanatanga tau (te iti = 20 me te teitei = 40) penei i te ahua o runga. Karekau he hapa i kitea.
I whakaatu he hapa mena i he te whakaurunga o te whakamanatanga tau.
Te Waihanga o te Kaupapa JSON
Me titiro ki tetahi tauira o JSON Schema kia kite he aha ta tatou e korero nei. Ko tetahi Ahanoa JSON taketake e whakaahua ana i te raarangi hua e whai ake nei:
Ko tana JSON Schema pea ka tuhia penei:
He tuhinga JSON te Aronuinga JSON, me waiho taua tuhinga hei ahanoa. Ko nga kupu matua he mema ahanoa/huanga kua tohua e JSON Schema. Ko nga "Kupumatua" kei te JSON Schema e tohu ana ki te waahanga "matua" o te huinga matua/uara i roto i tetahi mea. Ko te tuhi i te Kaupapa JSON ko te mapi i tetahi "kupu matua" ki tetahi uara i roto i tetahi mea mo te nuinga.
Kia ata titiro ki nga kupumatua i whakamahia e matou i roto i ta maatau tauira:
Ko te aronuinga JSON e ū ana te aronuinga o te rauemi kua tuhia e tenei huanga. Kua tuhia tenei aronuinga i muri i nga tauira tauira v4 paerewa, i tohua e te "$ aronuinga” kupu matua. Ma tenei ka aukati i to aronuinga kia hoki ki te putanga o naianei, he hototahi pea ki nga mea tawhito.
Ko te "taitara"A"whakaahuatanga” Ko nga kupu matua he whakamarama noa; e kore ratou e utaina he herenga ki nga raraunga e tirohia ana. Ko enei kupu matua e rua e whakaatu ana i te kaupapa o te aronuinga: he whakaahua i tetahi hua.
Ko te "momo” ka tautuhia e te kupu matua te tikanga rohe tuatahi o ta tatou raraunga JSON; me waiho he Ahanoa JSON. Ki te kore matou e tautuhi momo mo nga aronuinga katoa, ka kore te waehere e mahi. Ko etahi momo noa he "tau" "Boolean" "tauoti" "null" "mea" "ahua" "aho".
Kei te tautokohia a JSON Schema e nga whare pukapuka e whai ake nei:
Reo | Puna |
C | WJElement |
nānati | jschon |
PHP | Opis Json Schema |
JavaScript | ajv |
Go | gojsonschema |
Kotlin | Medeia-whakamana |
Ruby | JSONSchemer |
JSON (Wetereo)
Me titiro poto ki te wetereo taketake a JSON. Ko te wetereo JSON he wahanga o te wetereo JavaScript kei roto nga huānga e whai ake nei:
- Ka whakamahia nga takirua ingoa/uara hei tohu raraunga.
- Ka mau nga mea ki roto i nga taiapa mingimingi, ka arahina ia ingoa e te ':' (korona), me nga takirua uara ka wehea e te “,” (piko).
- Ka wehea nga uara ki te "," (piko) ka mau nga huinga ki nga taiapa tapawha.
Ko nga hanganga raraunga e rua e tautokohia ana e JSON:
- Rarangi uara kua raupapa: Ka taea he huinga, he rarangi, he vector ranei.
- Kohinga takirua ingoa/uara: Ko nga reo rorohiko rereke e tautoko ana i tenei Hanganga Raraunga.
JSON (Anoa)
Ko te kaupapa JSON he ahanoa JSON e whakaatu ana i te momo me te hanganga o tetahi ahanoa JSON rereke. Ka taea e te whakaaturanga ahanoa JavaScript te tohu i tetahi ahanoa JSON i roto i nga taiao wa whakahaere JavaScript. Ko etahi tauira o nga ahanoa aronuinga whaimana e whai ake nei:
aronuinga | kēmu |
{} | ahakoa he uara |
{ momo: 'mea' } | he ahanoa JavaScript |
{ momo: 'tau' } | he nama JavaScript |
{ momo: 'aho'} | he aho JavaScript |
Eg:
Te hanga ahanoa hou kua putua:
var JSON_Obj = {};
Waihanga Ahanoa Hou:
var JSON_Obj = ahanoa hou()
JSON (Whakataurite ki te XML)
Ko JSON me XML he whakatakotoranga reo-motuhake ka taea e te tangata te panui. I roto i nga ahuatanga o te ao, ka taea e raua te hanga, te panui, me te wetewete. I runga i nga paearu e whai ake nei, ka whakatauritea e tatou a JSON me XML.
Tuhinga
Na te mea he uaua ake te XML i a JSON, he pai ake te hunga hötaka ki a JSON.
Te Whakamahinga Huanga
Ka whakamahia te XML hei whakaatu i nga raraunga hanganga; heoi, karekau a XML e tautoko i nga raupapa, engari ko JSON.
Tuhinga
Ka whakamaoritia a JSON ma te whakamahi i te mahi eval a JavaScript. Ka whakahokia e eval te ahanoa kua whakaahuahia ina whakamahia ana me JSON.
tauira:
JSON | XML |
{ "Kamupene": Ferrari, "ingoa": "GTS", "utu": 404000 } |
Ferrari
GTS
404000
|
Nga Painga JSON Schema
I hoahoatia a JSON ki te paopao i roto i te reo ka taea te panui e te tangata me te reo miihini. Heoi, ki te kore he whakatikatika pai, kaore e taea. He painga a JSON Schema ki te whakamarama ake i a JSON mo nga miihini me nga tangata.
Ma te whakamahi i te JSON Schema ka whakakorehia te hiahia mo te maha o nga whakahoutanga taha-kiritaki. Ko te hanga rarangi o nga waehere HTML noa katahi ka whakatinanahia ki te taha o te kiritaki he tikanga angamaheni engari he kore tika mo te hanga taha-kiritaki. API taupānga. Heoi, ehara tenei i te rautaki nui rawa atu na te mea ko nga huringa i te taha-tumau ka raru etahi mahi.
Ko te painga nui o JSON Schema ko tona hototahi ki nga momo reo hotaka, me te tika me te riterite o te whakamana.
Ko te kaupapa JSON e tautoko ana i te whānuitanga o nga kaitirotiro me te pūnaha whakahaere, no reira ko nga tono kua tuhia ki te JSON kare e whakapau kaha ki te whakarite kia hototahi katoa nga kaitirotiro. I te wa o te whanaketanga, ka whakaarohia e nga kaiwhakawhanake he maha nga kaitirotiro, ahakoa kei a JSON nga kaha.
Ko JSON te huarahi tino pai ki te tiri i nga raraunga ahakoa te rahi, tae atu ki te ororongo, te ataata, me etahi atu korero. Ko te mea tenei na te mea kei te rongoa a JSON i nga raraunga i roto i nga raupapa, ka ngawari ake te tuku raraunga. Ko te mutunga, ko JSON te whakatakotoranga konae pai rawa atu mo nga API ipurangi me te whanaketanga.
I te piki haere o nga API, he mea tika ki te whakaaro ka kaha ake te whakamana me te whakamatautau API. He tika ano te tumanako ka kore pea a JSON e ngawari ake i te wa e haere ana te waa. Ko te tikanga ko te whai kaupapa mo o raraunga ka piki ake te whakahirahira i te wa e haere ana. Na te mea ko JSON te whakatakotoranga konae paerewa mo te mahi me nga API, he pai te whakakapi a JSON Schema mo te hunga e mahi ana me nga API.