Giya sa JSON Schema
Sa dili pa kita moadto sa JSON Schema, importante nga mahibal-an ang kalainan tali sa JSON ug JSON Schema.
JSON
Ang JSON mubo alang sa JavaScript Object Notation, ug kini usa ka format sa datos nga independente sa pinulongan nga gigamit sa mga API sa pagpadala sa mga hangyo ug mga tubag. Ang JSON yano nga basahon ug isulat alang sa mga tawo ug mga makina. Ang JSON kay usa ka text-based nga pormat nga wala gigapos sa pinulongan (Language independent).
JSON Schema
Ang JSON Schema usa ka mapuslanon nga himan alang sa pagsusi sa istruktura sa datos sa JSON. Aron matino ang istruktura sa JSON, gamita ang JSON-based nga format. Ang katuyoan niini mao ang pagsiguro nga ang datos sa JSON madawat. Ang kombensiyon alang sa data sa JSON sa among aplikasyon mahimong mapasabot gamit ang schema.
Adunay tulo ka nag-unang mga seksyon sa detalye sa JSON Schema:
JSON Hyper-Schema:
Ang JSON Hyper-Schema usa ka pinulongan sa JSON Schema nga mahimong gamiton sa pag-label sa mga dokumento sa JSON nga adunay mga hyperlink ug mga instruksyon alang sa pagproseso ug pagbag-o sa eksternal nga mga kapanguhaan sa JSON pinaagi sa text-based environment sama sa HTTP. Pag-klik dinhi sa pagkat-on og dugang mahitungod sa JSON Hyper-Schema.
JSON Schema Core:
Kini usa ka hugpong sa mga lagda alang sa pag-label ug pag-validate sa mga dokumento sa JSON.
JSON Schema Core:
- Gihulagway ang format sa datos nga anaa kanimo karon.
- Gipamatud-an ang datos nga magamit sa awtomatiko nga pagsulay.
- Pagsiguro sa katukma sa datos nga gihatag sa mga kliyente.
- Naghatag ug mabasa nga dokumentasyon para sa mga tawo ug mga makina.
Pag-validate sa JSON Schema:
Ang pag-validate base sa JSON Schema nagpahamtang ug mga limitasyon sa istruktura sa datos sa instance. Pagkahuman niana, bisan unsang mga keyword nga adunay dili pagpahayag impormasyon, sama sa deskriptibong metadata ug mga indikasyon sa paggamit, gidugang sa usa ka posisyon sa instance nga nagtagbo sa tanang gideklarar nga mga limitasyon.
Ang JSON Schema Validator nga himan sa Newtonsoft usa ka himan nga magamit nimo direkta sa imong browser, nga wala’y bayad. Mahimo nimong gamiton kini nga himan aron masulayan ang istruktura sa imong JSON schema. Kini nga panid adunay mga kontrol ug pagpatin-aw aron makasugod ka. Nianang paagiha, dali nga makita kung giunsa pagpauswag ang imong istruktura sa JSON.
Atong masusi ang atong JSON Object gamit ang JSON Schema Validation Tool:
Kita adunay edad validation (minimum = 20 ug maximum = 40) sama sa gipakita sa numero sa ibabaw. Walay mga sayop nga nakit-an.
Nagpakita kini og usa ka sayup kung ang pag-validate sa edad sayop nga gisulod.
Ang Paglalang sa usa ka JSON Schema
Atong tan-awon ang usa ka pananglitan sa JSON Schema aron makita kung unsa ang atong gihisgutan. Ang usa ka batakang JSON Object nga naghulagway sa usa ka katalogo sa produkto mao ang mosunod:
Ang JSON Schema niini mahimong isulat sama sa mosunod:
Ang JSON Schema usa ka JSON nga dokumento, ug kana nga dokumento KINAHANGLANG usa ka butang. Ang mga keyword mao ang mga miyembro sa butang/mga hiyas nga gipiho sa JSON Schema. Ang "Keywords" sa JSON Schema nagtumong sa "key" nga bahin sa key/value combination sa usa ka butang. Ang pagsulat sa usa ka JSON Schema naglakip sa pagmapa sa usa ka partikular nga "keyword" sa usa ka bili sulod sa usa ka butang sa kadaghanan.
Atong tan-awon pag-ayo ang mga keyword nga among gigamit sa among pananglitan:
Ang JSON schema diin ang resource's schema nagsunod kay gisulat pinaagi niini nga attribute. Kini nga schema gisulat subay sa drafts v4 standard, nga gipiho sa "$ iskema” keyword. Gipugngan niini ang imong schema nga mahibalik sa kasamtangan nga bersyon, nga mahimong tugma o dili sa mas karaan.
Ang "titulo"Ug"paghulagway” ang mga keyword kay eksplanasyon lang; wala sila magpahamtang ug bisan unsang limitasyon sa datos nga gisusi. Kining duha ka keyword naghulagway sa katuyoan sa schema: naghulagway kini sa usa ka produkto.
Ang "matang” keyword naghubit sa atong JSON data sa unang utlanan kondisyon; kini kinahanglan nga usa ka JSON Object. Kung dili kami magbutang og tipo alang sa tanan nga mga eskema, ang code dili molihok. Ang pipila ka kasagarang mga tipo mao ang "number" "Boolean" "integer" "null" "object" "array" "string".
Ang JSON Schema gisuportahan sa mosunod nga mga librarya:
Pinulongan | Library |
C | WJElement |
Python | jschon |
PHP | Opis Json Schema |
JavaScript | ajv |
Go | gojsonschema |
Kotlin | Medeia-validator |
Ruby | JSONSchemer |
JSON (Syntax)
Atong tan-awon sa mubo ang sukaranang syntax sa JSON. Ang JSON syntax usa ka subset sa JavaScript syntax nga naglakip sa mosunod nga mga elemento:
- Ang mga pares sa ngalan/bili gigamit nga nagrepresentar sa datos.
- Ang mga butang gikuptan sa mga kulot nga brace, ug ang matag ngalan gipangulohan sa usa ka ':' (colon), nga adunay mga pares sa kantidad nga gibulag sa "," (comma).
- Ang mga kantidad gibulag sa "," (comma) ug ang mga array gihuptan sa square bracket.
Ang mosunod nga duha ka mga istruktura sa datos gisuportahan sa JSON:
- Gi-order nga lista sa mga kantidad: Mahimo kini usa ka array, usa ka lista, o usa ka vector.
- Koleksyon sa mga pares sa ngalan/bili: Ang lain-laing mga pinulongan sa kompyuter nagsuporta niini nga Data Structure.
JSON (Buhat)
Ang JSON schema kay JSON object nga naglatid sa tipo ug structure sa lain-laing JSON object. Ang usa ka JavaScript object expression mahimong magrepresentar sa usa ka JSON nga butang sa JavaScript runtime environment. Ang pipila ka mga pananglitan sa balido nga mga butang sa schema mao ang mosunod:
Schema | posporo |
{} | bisan unsang bili |
{matang: 'butang' } | usa ka butang nga JavaScript |
{matang: 'numero'} | usa ka numero sa JavaScript |
{matang: 'kuwerdas'} | usa ka JavaScript string |
Hal:
Paghimo og bag-ong butang nga walay sulod:
var JSON_Obj = {};
Bag-ong Butang nga Paglalang:
var JSON_Obj = bag-ong butang()
JSON (Pagtandi sa XML)
Ang JSON ug XML kay mga format nga mabasa sa tawo nga independente sa pinulongan. Sa tinuod nga kalibutan nga mga senaryo, sila makahimo sa paghimo, pagbasa, ug pag-decode. Base sa mosunod nga criteria, mahimo natong itandi ang JSON sa XML.
Komplikado
Tungod kay ang XML mas komplikado kaysa JSON, mas gusto sa mga programmer ang JSON.
Paggamit sa mga Array
Ang XML gigamit sa pagpahayag sa structured data; bisan pa, ang XML wala nagsuporta sa mga arrays, apan ang JSON nagsuporta.
Pagparpar
Ang JSON gihubad gamit ang eval function sa JavaScript. Gibalik sa eval ang gihulagway nga butang kung gigamit sa JSON.
Panig-ingnan:
JSON | XML |
{ "kompanya": Ferrari, "ngalan": "GTS", "presyo": 404000 } |
Ferrari
GTS
404000
|
Mga Kaayohan sa JSON Schema
Gidisenyo ang JSON nga motipas sa usa ka pinulongan nga mabasa sa tawo ug sa makina. Bisan pa, kung wala’y pag-ayo, mahimo’g dili kini. Ang JSON Schema adunay bentaha sa paghimo sa JSON nga mas masabtan alang sa mga makina ug mga tawo.
Ang paggamit sa JSON Schema nagtangtang usab sa panginahanglan alang sa daghang mga update sa bahin sa kliyente. Ang paghimo sa usa ka lista sa kasagaran nga mga HTML code ug dayon ang pagpatuman niini sa bahin sa kliyente usa ka kasagaran apan dili tukma nga pamaagi sa pagtukod sa bahin sa kliyente. API mga app. Bisan pa, dili kini ang labing kaayo nga estratehiya tungod kay ang mga pagbag-o sa bahin sa server mahimo’g hinungdan nga dili molihok ang pipila nga mga gamit.
Ang nag-unang bentaha sa JSON Schema mao ang pagkaangay niini sa lain-laing mga programming language, ingon man ang katukma ug pagkamakanunayon sa validation.
Ang JSON schema nagsuporta sa usa ka halapad nga mga browser ug sistema sa operasyon, busa ang mga app nga gisulat sa JSON wala magkinahanglan og daghang paningkamot aron mahimo silang tanan nga magkatugma sa browser. Atol sa pag-uswag, gikonsiderar sa mga developer ang daghang mga browser, bisan kung ang JSON adunay mga kapabilidad.
Ang JSON mao ang labing episyente nga paagi sa pagpaambit sa datos sa bisan unsang gidak-on, lakip ang audio, video, ug uban pang media. Kini tungod sa kamatuoran nga ang JSON nagtipig sa datos sa mga arrays, nga naghimo sa data nga mas sayon. Ingon usa ka sangputanan, ang JSON mao ang labing kaayo nga format sa file alang sa mga online nga API ug pag-uswag.
Samtang nagkadaghan ang mga API, makatarunganon nga hunahunaon nga ang pag-validate ug pagsulay sa API mahimong labi ka hinungdanon. Makataronganon usab ang pagpaabut nga ang JSON dili mahimo nga labi ka yano sa paglabay sa panahon. Nagpasabot kini nga ang pagbaton ug schema para sa imong datos modako lang nga mas kritikal sa paglabay sa panahon. Tungod kay ang JSON mao ang sumbanan nga format sa file alang sa pagtrabaho sa mga API, ang JSON Schema usa ka maayong kapuli sa mga nagtrabaho sa mga API.
