Itọsọna si Eto JSON
Ṣaaju ki a to lọ sinu JSON Schema, o ṣe pataki lati mọ iyatọ laarin JSON ati JSON Schema.
JSON
JSON kuru fun Akọsilẹ Nkankan JavaScript, ati pe o jẹ ọna kika data ti o ni ominira ede ti awọn API lo lati fi awọn ibeere ati awọn idahun ranṣẹ. JSON rọrun lati ka ati kọ fun eniyan ati awọn ẹrọ bakanna. JSON jẹ ọna kika ti o da lori ọrọ ti ko ni adehun si ede (Ominira Ede).
Ilana JSON
JSON Schema jẹ ohun elo ti o wulo fun ijẹrisi igbekalẹ data JSON. Lati pato ọna ti JSON, lo ọna kika orisun-JSON. Idi rẹ ni lati rii daju pe data JSON jẹ itẹwọgba. Apejọ fun data JSON ohun elo wa le jẹ asọye nipa lilo eto.
Awọn apakan akọkọ mẹta wa si sipesifikesonu Eto JSON:
JSON Hyper-Schema:
JSON Hyper-Schema jẹ ede JSON Schema ti o le ṣee lo lati samisi awọn iwe aṣẹ JSON pẹlu awọn ọna asopọ hyperlinks ati awọn ilana fun sisẹ ati yiyipada awọn orisun JSON ita nipasẹ ọrọ – awọn agbegbe orisun bi HTTP. Tẹ Nibi lati ni imọ siwaju sii nipa JSON Hyper-Schema.
Ilana Ilana JSON:
O jẹ eto awọn ofin fun isamisi ati ifọwọsi awọn iwe aṣẹ JSON.
Ilana Ilana JSON:
- Apejuwe ọna kika data ti o ni lọwọlọwọ.
- Awọn ijẹrisi data ti o le ṣee lo ni adaṣe adaṣe.
- Ni idaniloju deede ti data ti a fun nipasẹ awọn alabara.
- Pese iwe kika fun awọn eniyan ati awọn ẹrọ.
Afọwọsi Ilana JSON:
Ifọwọsi ti o da lori Ilana JSON fi opin si eto ti data apẹẹrẹ. Lẹhin iyẹn, awọn koko-ọrọ eyikeyi ti ko ni idaniloju alaye, gẹgẹbi metadata ijuwe ati awọn itọkasi lilo, ti wa ni afikun si ipo apẹẹrẹ ti o ba gbogbo awọn ihamọ ti a kede.
Newtonsoft's JSON Schema Validator ọpa jẹ irinṣẹ ti o le lo taara ninu ẹrọ aṣawakiri rẹ, laisi idiyele. O le lo ọpa yii lati ṣe idanwo igbekalẹ ti ero JSON rẹ. Oju-iwe yii ni awọn idari ati awọn alaye lati jẹ ki o bẹrẹ. Ni ọna yẹn, o rọrun lati rii bi o ṣe le mu eto JSON rẹ dara si.
A le ṣayẹwo Nkankan JSON wa nipa lilo Ọpa Ifọwọsi Iṣeto JSON:
A ni ijẹrisi ọjọ-ori (o kere ju = 20 ati pe o pọju = 40) bi o ṣe han ninu nọmba loke. Ko si awọn aṣiṣe ti a rii.
O ṣe afihan aṣiṣe ti o ba jẹ pe afọwọsi ọjọ-ori ti wa ni titẹ lọna ti ko tọ.
Awọn ẹda ti A JSON Schema
Jẹ ki a wo apẹẹrẹ JSON Schema lati wo kini a n sọrọ nipa. Nkan JSON ipilẹ kan ti n ṣapejuwe katalogi ọja jẹ bi atẹle:
Eto JSON rẹ le jẹ kikọ bi atẹle:
Ilana JSON jẹ iwe-ipamọ JSON, ati pe iwe-ipamọ gbọdọ jẹ ohun kan. Awọn koko-ọrọ jẹ awọn ọmọ ẹgbẹ ohun/awọn abuda ti a tọka nipasẹ JSON Schema. "Awọn koko-ọrọ" ni JSON Schema tọka si apakan "bọtini" ti bọtini / iye iye ninu ohun kan. Kikọ Eto JSON kan pẹlu ṣiṣe aworan “ọrọ koko” kan pato si iye kan laarin ohun kan fun apakan pupọ julọ.
Jẹ ki a ṣe akiyesi diẹ sii ni awọn koko-ọrọ ti a lo ninu apẹẹrẹ wa:
Eto JSON eyiti eto orisun orisun naa ni ibamu jẹ kikọ silẹ nipasẹ abuda yii. Eto yii jẹ kikọ ni atẹle boṣewa v4, bi pato nipasẹ “$ eto” koko. Eyi ṣe idiwọ ero rẹ lati ja bo pada si ẹya ti isiyi, eyiti o le tabi ko le ni ibamu pẹlu agbalagba.
awọn "akọle"Ati"apejuwe” Koko ni o kan Àlàye; wọn ko fa awọn idiwọn eyikeyi lori data ti n ṣayẹwo. Awọn koko-ọrọ meji wọnyi ṣe apejuwe idi ero: o ṣe apejuwe ọja kan.
awọn "iruKoko-ọrọ ṣe alaye ipo aala akọkọ ti data JSON wa; o gbọdọ jẹ Nkan JSON. Ti a ko ba ṣeto iru fun gbogbo awọn eto, koodu yoo ko ṣiṣẹ. Diẹ ninu awọn orisi ti o wọpọ jẹ "nọmba" "Boolean" "odidi" "asan" "ohun" "orun" "okun".
Ilana JSON jẹ atilẹyin nipasẹ awọn ile-ikawe wọnyi:
Language | Ìkàwé |
C | WJElementi |
Python | jschon |
PHP | Opis Json Schema |
JavaScript | àjv |
Go | gojsonschema |
Kotlin | Media-afọwọsi |
Ruby | JSONSchemer |
JSON (Syntax)
Jẹ ki a ṣe akiyesi kukuru ni sintasi ipilẹ JSON. JSON syntax jẹ ipin ti JavaScript sintasi ti o pẹlu awọn eroja wọnyi:
- Orukọ/awọn orisii iye ni a lo ti o ṣe aṣoju data.
- Awọn ohun kan wa ni awọn àmúró iṣupọ, ati pe orukọ kọọkan jẹ idari nipasẹ ':' (colon), pẹlu awọn orisii iye ti o yapa nipasẹ “,” (koma).
- Awọn iye wa niya nipasẹ “,” (koma) ati awọn akojọpọ wa ni idaduro ni awọn biraketi onigun mẹrin.
Awọn ẹya data meji wọnyi jẹ atilẹyin nipasẹ JSON:
- Akojọ ti a paṣẹ fun awọn iye: O le jẹ orun, atokọ, tabi fekito kan.
- Gbigba orukọ/awọn orisii iye: Awọn ede kọmputa oriṣiriṣi ṣe atilẹyin Ilana Data yii.
JSON (Ohun)
Ilana JSON jẹ nkan JSON ti o ṣe ilana iru ati ilana ti nkan JSON ti o yatọ. Ọrọ ikosile ohun JavaScript le ṣe aṣoju ohun JSON ni awọn agbegbe asiko asiko JavaScript. Diẹ ninu awọn apẹẹrẹ ti awọn nkan eto eto to wulo jẹ bi atẹle:
aworan | -kere |
{} | eyikeyi iye |
{iru: 'ohun'} | ohun JavaScript |
{iru: 'nọmba'} | nọmba JavaScript |
{iru: 'okun'} | okun JavaScript |
Fun apẹẹrẹ:
Ṣiṣe nkan titun ti o ṣofo:
var JSON_Obj = {};
Ṣiṣẹda Nkan Tuntun:
var JSON_Obj = ohun tuntun ()
JSON (Ifiwera pẹlu XML)
JSON ati XML jẹ awọn ọna kika ti o ni ominira ede ti eniyan. Ni awọn oju iṣẹlẹ gidi-aye, wọn le ṣẹda, ka, ati pinnu. Da lori awọn ibeere wọnyi, a le ṣe afiwe JSON pẹlu XML.
complexity
Nitori XML jẹ eka sii ju JSON, awọn pirogirama fẹ JSON.
Lilo ti Arrays
XML ti wa ni lo lati han ti eleto data; sibẹsibẹ, XML ko ni atilẹyin orun, ṣugbọn JSON ṣe.
Lilọ kiri
JSON jẹ itumọ nipa lilo iṣẹ eval JavaScript. eval da ohun ti a sapejuwe pada nigba lilo pẹlu JSON.
apere:
JSON | XML |
{ "ile-iṣẹ": Ferrari, "orukọ": "GTS", "owo": 404000 } |
Ferrari
GTS
404000
|
Awọn anfani Iṣeto JSON
JSON jẹ apẹrẹ lati yipada ni ede eniyan- ati ẹrọ-ṣe kika. Sibẹsibẹ, laisi diẹ ninu awọn atunṣe-itanran, o le jẹ bẹni. JSON Schema ni anfani ti ṣiṣe JSON ni oye diẹ sii fun awọn ẹrọ ati eniyan.
Lilo JSON Schema tun yọ iwulo fun ọpọlọpọ awọn imudojuiwọn ẹgbẹ-alabara kuro. Ṣiṣe atokọ ti awọn koodu HTML ti o wọpọ ati lẹhinna imuse wọn ni ẹgbẹ alabara jẹ ọna aṣoju ṣugbọn ọna ti ko pe lati kọ ẹgbẹ alabara. API awọn ohun elo. Sibẹsibẹ, eyi kii ṣe ilana ti o tobi julọ nitori awọn iyipada lori ẹgbẹ olupin le fa awọn iṣẹ ṣiṣe kan si aiṣedeede.
Anfani akọkọ ti JSON Schema ni ibamu pẹlu ọpọlọpọ awọn ede siseto, bakanna bi deede ati aitasera ti afọwọsi.
Ilana JSON ṣe atilẹyin ọpọlọpọ awọn aṣawakiri ati awọn ọna šišeNítorí náà, àwọn ìṣàfilọ́lẹ̀ tí a kọ sínú JSON kò gba ìsapá púpọ̀ láti jẹ́ kí gbogbo wọn jẹ́ aṣàwákiri báramu. Lakoko idagbasoke, awọn olupilẹṣẹ gbero ọpọlọpọ awọn aṣawakiri, botilẹjẹpe JSON ti ni awọn agbara tẹlẹ.
JSON jẹ ọna ti o munadoko julọ lati pin data ti iwọn eyikeyi, pẹlu ohun, fidio, ati media miiran. Eyi jẹ nitori otitọ pe JSON tọju data ni awọn akojọpọ, eyiti o jẹ ki gbigbe data rọrun. Bi abajade, JSON jẹ ọna kika faili ti o dara julọ fun awọn API ori ayelujara ati idagbasoke.
Bi API ṣe n dagba sii wọpọ, o jẹ ọgbọn lati ro pe ijẹrisi API ati idanwo yoo di pataki pupọ si. O tun jẹ ojulowo lati nireti pe JSON ko ṣeeṣe lati ni irọrun pupọ bi akoko ti nlọ. Eyi tumọ si pe nini ero kan fun data rẹ yoo dagba diẹ sii pataki bi akoko ti n lọ. Nitori JSON jẹ ọna kika faili boṣewa fun ṣiṣẹ pẹlu awọn API, Ilana JSON jẹ aropo to dara fun awọn ti n ṣiṣẹ pẹlu awọn API.
