Alakaʻi iā JSON Schema
Ma mua o ko mākou komo ʻana i JSON Schema, he mea nui e ʻike i ka ʻokoʻa ma waena o JSON a me JSON Schema.
JSON
He pōkole ʻo JSON no JavaScript Object Notation, a he ʻano ʻikepili kūʻokoʻa ʻōlelo i hoʻohana ʻia e nā API no ka hoʻouna ʻana i nā noi a me nā pane. He maʻalahi ʻo JSON e heluhelu a kākau no nā kānaka a me nā mīkini like. ʻO JSON kahi ʻano kikokikona i hoʻopaʻa ʻole ʻia i ka ʻōlelo (Lenguage kūʻokoʻa).
Hoʻolālā JSON
He mea hana pono ʻo JSON Schema no ka hōʻoia ʻana i ka hoʻolālā ʻikepili JSON. No ka wehewehe ʻana i ke ʻano o JSON, e hoʻohana i kahi ʻano hoʻokumu JSON. ʻO kāna kumu e hōʻoia i ka ʻae ʻia o ka ʻikepili JSON. Hiki ke wehewehe ʻia ka ʻaha kūkā no ka ʻikepili JSON o kā mākou noi me ka hoʻohana ʻana i ka schema.
ʻEkolu mau ʻāpana nui i ka kikoʻī JSON Schema:
JSON Hyper-Schema:
ʻO JSON Hyper-Schema kahi ʻōlelo JSON Schema hiki ke hoʻohana ʻia e lepili i nā palapala JSON me nā loulou a me nā ʻōlelo kuhikuhi no ka hoʻoponopono ʻana a me ka hoʻololi ʻana i nā kumuwaiwai JSON waho ma o nā kaiapuni pili kikokikona e like me HTTP. Kaomi maanei e aʻo hou e pili ana iā JSON Hyper-Schema.
JSON Schema Core:
He hoʻonohonoho ia o nā lula no ka hōʻailona ʻana a me ka hōʻoia ʻana i nā palapala JSON.
JSON Schema Core:
- Hōʻike i ke ʻano ʻikepili i loaʻa iā ʻoe i kēia manawa.
- Hōʻoia i ka ʻikepili i hiki ke hoʻohana ʻia i ka hoʻāʻo ʻakomi.
- E hōʻoia i ka pololei o ka ʻikepili i hāʻawi ʻia e nā mea kūʻai aku.
- Hāʻawi i nā palapala hiki ke heluhelu ʻia no nā kānaka a me nā mīkini.
Hōʻoia ʻo JSON Schema:
ʻO ka hōʻoia e pili ana i ka JSON Schema e kau i nā palena ma ke ʻano o ka ʻikepili laʻana. Ma hope o kēlā, kēlā me kēia huaʻōlelo i loaʻa ʻole ka manaʻo ike, e like me nā metadata wehewehe a me nā hōʻailona hoʻohana, ua hoʻohui ʻia i kahi kūlana e hoʻokō i nā koi āpau i haʻi ʻia.
ʻO kā Newtonsoft's JSON Schema Validator mea paahana hiki iā ʻoe ke hoʻohana pololei i kāu polokalamu kele pūnaewele, me ka uku ʻole. Hiki iā ʻoe ke hoʻohana i kēia hāmeʻa e hoʻāʻo i ke ʻano o kāu schema JSON. Aia kēia ʻaoʻao i nā mana a me nā wehewehe e hoʻomaka ai. Ma ia ala, maʻalahi ke ʻike pehea e hoʻomaikaʻi ai i kāu hoʻolālā JSON.
Hiki iā mākou ke nānā i kā mākou JSON Object me ka hoʻohana ʻana i ka JSON Schema Validation Tool:
Loaʻa iā mākou ka hōʻoia makahiki (ka liʻiliʻi = 20 a me ke kiʻekiʻe = 40) e like me ka mea i hōʻike ʻia ma ke kiʻi ma luna. ʻAʻohe hewa i loaʻa.
Ua hōʻike ʻia i kahi hewa inā i hoʻokomo hewa ʻia ka hōʻoia makahiki.
ʻO ka hana ʻana o kahi JSON Schema
E nānā i kahi laʻana o JSON Schema e ʻike i kā mākou e kamaʻilio nei. ʻO kahi mea JSON kumu e wehewehe ana i kahi palapala huahana penei:
Hiki ke kākau ʻia kāna JSON Schema penei:
ʻO kahi JSON Schema he palapala JSON, a he mea pono kēlā palapala. ʻO nā huaʻōlelo he mau lālā / ʻano i kuhikuhi ʻia e JSON Schema. "Nā hua'ōlelo" ma JSON Schema e pili ana i ka māhele "kī" o kahi hui kī/waiwai i loko o kahi mea. ʻO ke kākau ʻana i kahi JSON Schema e pili ana i ka palapala ʻana i kahi "huaʻōlelo" i kahi waiwai i loko o kahi mea no ka hapa nui.
E nānā pono kākou i nā huaʻōlelo a mākou i hoʻohana ai i kā mākou laʻana:
Ua kākau ʻia ka schema JSON e pili ana i ke kumu waiwai e kēia ʻano. Ua kākau ʻia kēia schema ma hope o nā drafts v4 standard, e like me ka mea i ʻōlelo ʻia e ka "$ schema” huaʻōlelo. ʻAʻole kēia e hoʻihoʻi i kāu hoʻolālā i ka mana o kēia manawa, hiki a kūpono ʻole paha me ka mea kahiko.
ka "inoa"A me"hōʻikeʻano” He wehewehe wale nā huaʻōlelo; ʻaʻole lākou e kau i nā palena i ka ʻikepili i nānā ʻia. Hōʻike kēia mau huaʻōlelo ʻelua i ke kumu o ka schema: wehewehe i kahi huahana.
ka "ʻAno” wehewehe ʻōlelo huaʻōlelo i kā mākou ʻikepili JSON kūlana palena mua; pono ia he JSON Object. Inā ʻaʻole mākou e hoʻonohonoho i ke ʻano no nā schema āpau, ʻaʻole e hana ke code. ʻO kekahi ʻano maʻamau he "helu" "Boolean" "integer" "null" "object" "array" "string".
Kākoʻo ʻia ʻo JSON Schema e nā hale waihona puke:
'ōlelo | waihona Puke |
C | WJElement |
Python | jschon |
PHP | Opis Json Schema |
pio ka | ajv |
Go | gojsonschema |
Kotlin | Medeia-validator |
Ruby | JSONSchemer |
JSON (Syntax)
E nānā pōkole i ka syntax kumu a JSON. ʻO ka syntax JSON kahi ʻāpana o ka syntax JavaScript e loaʻa ana kēia mau mea:
- Hoʻohana ʻia nā hui inoa/waiwai e hōʻike ana i ka ʻikepili.
- Hoʻopaʻa ʻia nā mea i loko o nā pale wili, a alakaʻi ʻia kēlā me kēia inoa e kahi ':' (colon), me nā hui waiwai i hoʻokaʻawale ʻia e “,” (koma).
- Hoʻokaʻawale ʻia nā waiwai e ka "," (koma) a mālama ʻia nā ʻōkuhi ma nā bracket square.
Kākoʻo ʻia nā ʻōnaehana ʻikepili ʻelua e JSON:
- Ka papa inoa o nā waiwai: Hiki iā ia ke ʻano, he papa inoa, a he vector paha.
- ʻOhi ʻana o nā hui inoa/waiwai: Kākoʻo nā ʻōlelo kamepiula ʻē aʻe i kēia Structure Data.
JSON (mea)
ʻO ka schema JSON kahi mea JSON e wehewehe ana i ke ʻano a me ke ʻano o kahi mea JSON ʻē aʻe. Hiki i ka hōʻike mea JavaScript ke hōʻike i kahi mea JSON ma nā kaiapuni wā holo JavaScript. ʻO kekahi mau laʻana o nā mea hoʻolālā kūpono penei:
Kālena | ihoiho |
{} | kekahi waiwai |
{ ʻano: 'mea' } | he mea JavaScript |
{ ʻano: 'helu' } | he helu JavaScript |
{ ʻano: 'string'} | he kaula JavaScript |
ʻAno:
Ke hana nei i kahi mea hou i nele:
var JSON_Obj = {};
Hana Mea Hou:
var JSON_Obj = mea hou ()
JSON (Hoʻohālikelike me XML)
ʻO JSON a me XML nā ʻōlelo i hiki ke heluhelu ʻia e ke kanaka. Ma nā hiʻohiʻona o ka honua maoli, hiki iā lākou ke hana, heluhelu, a hoʻokaʻawale. Ma muli o kēia mau pae hoʻohālike, hiki iā mākou ke hoʻohālikelike iā JSON me XML.
Ka nui
No ka mea ʻoi aku ka paʻakikī o XML ma mua o JSON, makemake nā mea polokalamu iā JSON.
Ka hoʻohana ʻana i nā Arrays
Hoʻohana ʻia ka XML e hōʻike i ka ʻikepili i kūkulu ʻia; akā naʻe, ʻaʻole kākoʻo ʻo XML i nā arrays, akā hana ʻo JSON.
ʻO ka hoʻopaʻa ʻana
Ua unuhi ʻia ʻo JSON me ka hoʻohana ʻana i ka hana eval a JavaScript. eval i ka mea i wehewehe ʻia ke hoʻohana ʻia me JSON.
la'ana:
JSON | 'ōkuene |
{ "hui": Ferrari, "inoa": "GTS", "kuai": 404000 } |
Ferrari
GTS
404000
|
Nā Pōmaikaʻi o JSON Schema
Hoʻolālā ʻia ʻo JSON e hoʻohuli i kahi ʻōlelo hiki ke heluhelu ʻia e ke kanaka a me ka mīkini. Eia nō naʻe, me ka ʻole o ka hoʻoponopono ʻana, ʻaʻole hiki. Loaʻa iā JSON Schema ka maikaʻi o ka hoʻomaopopo ʻana iā JSON no nā mīkini a me nā kānaka.
ʻO ka hoʻohana ʻana i ka JSON Schema e hoʻoneʻe i ka pono no nā mea hoʻonui ʻaoʻao ʻaoʻao. ʻO ka hana ʻana i kahi papa inoa o nā code HTML maʻamau a laila hoʻokō iā lākou ma ka ʻaoʻao o ka mea kūʻai aku he ala maʻamau akā pololei ʻole i ke kūkulu ʻana i ka ʻaoʻao o ka mea kūʻai aku. API nā polokalamu. Akā naʻe, ʻaʻole kēia ka hoʻolālā maikaʻi loa no ka mea hiki ke hoʻololi i ka ʻaoʻao kikowaena i kekahi mau hana.
ʻO ka pōmaikaʻi nui o JSON Schema ʻo ia ka hoʻohālikelike ʻana me nā ʻano ʻōlelo hoʻonohonoho like ʻole, a me ka pololei a me ke kūlike o ka hōʻoia.
Kākoʻo ʻo JSON schema i kahi ākea o nā polokalamu kele pūnaewele a nā pūnaewele hana, no laila ʻaʻole hoʻoikaika nui nā polokalamu i kākau ʻia ma JSON e hoʻokō pono iā lākou a pau. I ka wā o ka hoʻomohala ʻana, noʻonoʻo nā mea hoʻomohala i kekahi mau polokalamu kele pūnaewele, ʻoiai ua loaʻa iā JSON nā mana.
ʻO JSON ke ala maikaʻi loa e kaʻana like i ka ʻikepili o kēlā me kēia nui, me ka leo, wikiō, a me nā media ʻē aʻe. ʻO kēia ma muli o ka mālama ʻana o JSON i ka ʻikepili i nā arrays, kahi e maʻalahi ai ka lawe ʻana i ka ʻikepili. ʻO ka hopena, ʻo JSON ka waihona faila maikaʻi loa no nā API pūnaewele a me ka hoʻomohala ʻana.
I ka ulu ʻana o nā API i mea maʻamau, pono e manaʻo e lilo ka hōʻoia ʻana a me ka hoʻāʻo ʻana o API i mea nui. Maikaʻi nō hoʻi ka manaʻo ʻaʻole e maʻalahi ka maʻalahi o JSON i ka hele ʻana o ka manawa. Hōʻike kēia i ka loaʻa ʻana o kahi schema no kāu ʻikepili e ulu nui aʻe i ke koʻikoʻi ke hele nei ka manawa. No ka mea, ʻo JSON ke ʻano faila maʻamau no ka hana ʻana me nā API, ʻo JSON Schema kahi mea kūpono no ka poʻe e hana pū ana me nā API.
