Pituduh ka JSON Schema
Sateuacan urang lebet kana JSON Schema, penting pikeun terang bédana antara JSON sareng JSON Schema.
JSON
JSON pondok pikeun JavaScript Objék Notasi, sareng éta mangrupikeun format data anu mandiri basa anu dianggo ku API pikeun ngirim pamundut sareng jawaban. JSON basajan maca sareng nyerat pikeun jalma sareng mesin sami. JSON nyaéta format dumasar-téks anu henteu kaiket kana basa (Basa mandiri).
Skéma JSON
JSON Schema mangrupakeun alat mangpaat pikeun verifying struktur data JSON. Pikeun nangtukeun struktur JSON, make format basis JSON. Tujuanana nyaéta pikeun mastikeun yén data JSON tiasa ditampi. Konvénsi pikeun data JSON aplikasi urang bisa dihartikeun maké skéma.
Aya tilu bagian utama pikeun spésifikasi JSON Schema:
JSON Hyper-Skéma:
JSON Hyper-Schema mangrupikeun basa JSON Schema anu tiasa dianggo pikeun labél dokumén JSON kalayan hyperlink sareng petunjuk pikeun ngolah sareng ngarobih sumber JSON éksternal ngalangkungan lingkungan dumasar téks sapertos HTTP. Pencét Ieuh pikeun leuwih jéntré ngeunaan JSON Hyper-Schema.
JSON Skéma Inti:
Éta mangrupikeun sakumpulan aturan pikeun panyiri sareng validasi dokumén JSON.
JSON Skéma Inti:
- Ngajelaskeun format data anjeun ayeuna gaduh.
- Validates data nu bisa dipaké dina nguji otomatis.
- Assuring katepatan data dibikeun ku klien.
- Nyayogikeun dokuméntasi anu tiasa dibaca pikeun manusa sareng mesin.
Validasi Skema JSON:
Validasi dumasar kana JSON Schema maksakeun wates dina struktur data conto. Sanggeus éta, sagala kecap konci ngabogaan non-assertion inpormasi, sapertos metadata deskriptif sareng indikasi pamakean, ditambahkeun kana posisi instance anu nyumponan sadaya konstrain anu dinyatakeun.
Alat JSON Schema Validator Newtonsoft mangrupikeun alat anu anjeun tiasa dianggo langsung dina panyungsi anjeun, gratis. Anjeun tiasa nganggo alat ieu pikeun nguji struktur skéma JSON anjeun. Kaca ieu ngandung kadali sareng katerangan pikeun ngamimitian anjeun. Ku cara éta, gampang pikeun ningali kumaha ningkatkeun struktur JSON anjeun.
Urang tiasa pariksa Objék JSON kami nganggo Alat Validasi Skema JSON:
Simkuring gaduh validasi umur (minimum = 20 jeung maksimum = 40) ditémbongkeun saperti dina gambar di luhur. Teu aya kasalahan anu kapanggih.
Ieu ditampilkeun kasalahan lamun validasi umur salah diasupkeun.
Penciptaan Skéma JSON
Hayu urang tingali conto JSON Schema pikeun ningali naon anu urang bahas. Objék JSON dasar anu ngajelaskeun katalog produk nyaéta kieu:
Skema JSON na tiasa ditulis sapertos kieu:
Skema JSON mangrupikeun dokumen JSON, sareng dokumen éta kedah janten obyék. Konci mangrupakeun anggota obyék / atribut dieusian ku JSON Schema. "Keyword" dina JSON Schema nujul kana "konci" bagian tina kombinasi konci / nilai dina hiji obyék. Nulis skéma JSON ngalibatkeun pemetaan "kecap konci" tinangtu kana nilai dina hiji obyék pikeun sabagéan ageung.
Hayu urang tingali langkung caket kana kecap konci anu kami dianggo dina conto urang:
Skéma JSON anu skéma sumberna patuh ditulis ku atribut ieu. Skéma ieu ditulis nuturkeun draf v4 standar, sakumaha dieusian ku "$ skéma” kecap konci. Ieu nyegah skéma anjeun tina ragrag deui ka versi ayeuna, nu bisa atawa teu cocog jeung heubeul.
The "gelar"Jeung"gambaran” kecap konci téh ngan explanatory; aranjeunna henteu maksakeun watesan dina data anu dipariksa. Dua kecap konci ieu ngajelaskeun tujuan skéma: éta ngajelaskeun produk.
The "ngetik” keyword ngahartikeun kaayaan wates kahiji data JSON urang; eta kudu JSON Objék. Upami urang henteu nyetél jinis pikeun sadaya skéma, kodeu moal jalan. Sababaraha jenis umum nyaéta "angka" "Boolean" "integer" "null" "obyek" "array" "string".
Skema JSON dirojong ku perpustakaan ieu:
basa | taman pustaka |
C | WJElement |
Python | jschon |
PHP | Pedaran Json Schema |
JavaScript | ajv |
Go | gojsonschema |
Kotlin | Média-validator |
inten beureum | JSONSchemer |
JSON (Sintaksis)
Hayu urang nyandak katingal pondok dina sintaksis fundamental JSON urang. Sintaksis JSON mangrupikeun sawaréh tina sintaksis JavaScript anu kalebet unsur-unsur ieu:
- Pasangan ngaran/nilai dipaké nu ngagambarkeun data.
- Objék disimpen dina braces Curly, sarta unggal ngaran dipingpin ku ':' (titik dua), kalawan pasangan nilai dipisahkeun ku "," (koma).
- Nilai dipisahkeun ku "," (koma) jeung arrays disimpen dina kurung kuadrat.
Dua struktur data di handap ieu dirojong ku JSON:
- Daptar nilai urutan: Bisa mangrupa array, daptar, atawa vektor.
- Kumpulan pasangan ngaran/nilai: Basa komputer anu béda ngadukung Struktur Data ieu.
JSON (Objék)
Skéma JSON mangrupikeun obyék JSON anu ngagariskeun jinis sareng struktur objék JSON anu béda. Ekspresi obyék JavaScript tiasa ngagambarkeun obyék JSON dina lingkungan runtime JavaScript. Sababaraha conto objék skéma valid nyaéta kieu:
Schema | patandingan |
{} | sagala nilai |
{tipe: 'obyek'} | obyék JavaScript |
{tipe: 'nomer'} | angka JavaScript |
{tipe: 'string'} | string JavaScript |
Misalna:
Nyieun objék anyar nu kosong:
var JSON_Obj = {};
Nyiptakeun Obyék Anyar:
var JSON_Obj = objék anyar ()
JSON (Bandingan sareng XML)
JSON sareng XML mangrupikeun format anu tiasa dibaca manusa anu mandiri basa. Dina skenario dunya nyata, aranjeunna tiasa ngadamel, maca, sareng decode. Dumasar kana kriteria ieu, urang tiasa ngabandingkeun JSON sareng XML.
pajeulitna
Kusabab XML langkung kompleks tibatan JSON, programer langkung milih JSON.
Pamakéan Arrays
XML dipaké pikeun nganyatakeun data terstruktur; kumaha oge, XML teu ngarojong arrays, tapi JSON teu.
Parsing
JSON diinterpretasi nganggo fungsi eval JavaScript. eval mulih obyék anu dijelaskeun nalika dianggo sareng JSON.
contona:
JSON | XML |
{ "Pausahaan": Ferrari, "Ngaran": "GTS", "Harga": 404000 } |
Ferrari
GTS
404000
|
Keunggulan Skema JSON
JSON dirancang pikeun deflect dina basa manusa- jeung mesin-bisa dibaca. Sanajan kitu, tanpa sababaraha fine-tuning, éta bisa henteu. Skema JSON ngagaduhan kauntungan pikeun ngajantenkeun JSON langkung kaharti pikeun mesin sareng manusa.
Ngagunakeun JSON Schema ogé ngaleungitkeun kabutuhan sababaraha apdet sisi klien. Nyieun daptar kode HTML umum lajeng nerapkeun aranjeunna dina sisi klien mangrupakeun metoda has tapi taliti pikeun ngawangun klien-sisi. API aplikasi. Nanging, ieu sanés strategi anu paling hébat sabab parobihan dina sisi server tiasa nyababkeun sababaraha fungsi teu tiasa dianggo.
Kauntungan utama JSON Schema nyaéta kasaluyuanna sareng rupa-rupa basa pamrograman, ogé akurasi sareng konsistensi validasi.
JSON skéma ngarojong rupa-rupa browser jeung sistem operasi, ku kituna aplikasi anu ditulis dina JSON henteu peryogi seueur usaha pikeun ngajantenkeun browser cocog. Salila pamekaran, pamekar nganggap sababaraha panyungsi, sanaos JSON parantos ngagaduhan kamampuan.
JSON mangrupikeun cara anu paling éfisién pikeun ngabagi data tina ukuran naon waé, kalebet audio, pidéo, sareng média sanés. Ieu alatan kanyataan yén JSON nyimpen data dina arrays, nu ngajadikeun pangiriman data gampang. Hasilna, JSON mangrupikeun format file anu pangsaéna pikeun API sareng pamekaran online.
Nalika API beuki umum, éta logis pikeun nganggap yén validasi sareng uji API bakal janten langkung penting. Éta ogé realistis pikeun nyangka yén JSON sigana moal langkung saderhana nalika waktosna. Ieu nunjukkeun yén gaduh skéma pikeun data anjeun ngan ukur bakal langkung kritis nalika waktosna. Kusabab JSON mangrupikeun format file standar pikeun damel sareng API, JSON Schema mangrupikeun pengganti anu saé pikeun anu damel sareng API.
