Panduan untuk Skema JSON
Sebelum kita pergi ke Skema JSON, adalah penting untuk mengetahui perbezaan antara Skema JSON dan JSON.
JSON
JSON ialah singkatan untuk Notasi Objek JavaScript, dan ia merupakan format data bebas bahasa yang digunakan oleh API untuk menghantar permintaan dan jawapan. JSON mudah dibaca dan ditulis untuk orang dan mesin. JSON ialah format berasaskan teks yang tidak terikat kepada bahasa (Language independent).
Skema JSON
Skema JSON ialah alat yang berguna untuk mengesahkan struktur data JSON. Untuk menentukan struktur JSON, gunakan format berasaskan JSON. Tujuannya adalah untuk memastikan data JSON boleh diterima. Konvensyen untuk data JSON aplikasi kami boleh ditakrifkan menggunakan skema.
Terdapat tiga bahagian utama untuk spesifikasi Skema JSON:
JSON Hyper-Schema:
JSON Hyper-Schema ialah bahasa JSON Schema yang boleh digunakan untuk melabelkan dokumen JSON dengan hiperpautan dan arahan untuk memproses dan menukar sumber JSON luaran melalui persekitaran berasaskan teks seperti HTTP. klik disini untuk mengetahui lebih lanjut tentang JSON Hyper-Schema.
Teras Skema JSON:
Ia ialah satu set peraturan untuk melabel dan mengesahkan dokumen JSON.
Teras Skema JSON:
- Menerangkan format data yang anda miliki pada masa ini.
- Mengesahkan data yang boleh digunakan dalam ujian automatik.
- Memastikan ketepatan data yang diberikan oleh pelanggan.
- Menyediakan dokumentasi yang boleh dibaca untuk kedua-dua manusia dan mesin.
Pengesahan Skema JSON:
Pengesahan berdasarkan Skema JSON mengenakan had pada struktur data contoh. Selepas itu, mana-mana kata kunci yang tidak mempunyai penegasan maklumat, seperti metadata deskriptif dan petunjuk penggunaan, ditambahkan pada kedudukan contoh yang memenuhi semua kekangan yang diisytiharkan.
Alat Pengesah Skema JSON Newtonsoft ialah alat yang anda boleh gunakan terus dalam penyemak imbas anda, secara percuma. Anda boleh menggunakan alat ini untuk menguji struktur skema JSON anda. Halaman ini mengandungi kawalan dan penjelasan untuk membolehkan anda bermula. Dengan cara itu, mudah untuk melihat cara menambah baik struktur JSON anda.
Kami boleh menyemak Objek JSON kami menggunakan Alat Pengesahan Skema JSON:
Kami mempunyai pengesahan umur (minimum = 20 dan maksimum = 40) seperti yang ditunjukkan dalam rajah di atas. Tiada ralat ditemui.
Ia memaparkan ralat jika pengesahan umur telah dimasukkan dengan salah.
Penciptaan Skema JSON
Mari lihat contoh Skema JSON untuk melihat perkara yang kita bincangkan. Objek JSON asas yang menerangkan katalog produk adalah seperti berikut:
Skema JSONnya mungkin ditulis seperti berikut:
Skema JSON ialah dokumen JSON dan dokumen itu MESTI menjadi objek. Kata kunci ialah ahli objek/atribut yang ditentukan oleh Skema JSON. "Kata kunci" dalam Skema JSON merujuk kepada bahagian "kunci" gabungan kunci/nilai dalam objek. Menulis Skema JSON melibatkan pemetaan "kata kunci" tertentu kepada nilai dalam objek untuk sebahagian besar.
Mari kita lihat lebih dekat pada kata kunci yang kami gunakan dalam contoh kami:
Skema JSON yang dipatuhi oleh skema sumber ditulis oleh atribut ini. Skema ini ditulis mengikut piawaian draf v4, seperti yang ditentukan oleh “$ skema” kata kunci. Ini menghalang skema anda daripada kembali kepada versi semasa, yang mungkin serasi atau tidak dengan yang lebih lama.
The "tajuk"Dan"Penerangan” kata kunci hanyalah penerangan; mereka tidak mengenakan sebarang had ke atas data yang disemak. Kedua-dua kata kunci ini menerangkan tujuan skema: ia menerangkan produk.
The "jenis” kata kunci mentakrifkan syarat sempadan pertama data JSON kami; ia mestilah Objek JSON. Jika kami tidak menetapkan jenis untuk semua skema, kod itu tidak akan berfungsi. Beberapa jenis biasa ialah "nombor" "Boolean" "integer" "null" "objek" "tatasusunan" "rentetan".
Skema JSON disokong oleh perpustakaan berikut:
Bahasa | Perpustakaan |
C | WJElement |
Python | jschon |
PHP | Opis Json Schema |
JavaScript | ajv |
Go | gojsonschema |
Kotlin | Medeia-validator |
Ruby | JSONSchemer |
JSON (Sintaks)
Mari kita lihat secara ringkas sintaks asas JSON. Sintaks JSON ialah subset sintaks JavaScript yang merangkumi elemen berikut:
- Pasangan nama/nilai digunakan yang mewakili data.
- Objek dipegang dalam kurungan kerinting, dan setiap nama diketuai oleh ':' (titik bertitik), dengan pasangan nilai dipisahkan dengan “,” (koma).
- Nilai dipisahkan dengan "," (koma) dan tatasusunan disimpan dalam kurungan segi empat sama.
Dua struktur data berikut disokong oleh JSON:
- Senarai nilai tersusun: Ia boleh menjadi tatasusunan, senarai, atau vektor.
- Koleksi pasangan nama/nilai: Bahasa komputer yang berbeza menyokong Struktur Data ini.
JSON (Objek)
Skema JSON ialah objek JSON yang menggariskan jenis dan struktur objek JSON yang berbeza. Ungkapan objek JavaScript boleh mewakili objek JSON dalam persekitaran masa jalan JavaScript. Beberapa contoh objek skema yang sah adalah seperti berikut:
Skema | Perlawanan |
{} | sebarang nilai |
{ jenis: 'objek' } | objek JavaScript |
{ jenis: 'nombor' } | nombor JavaScript |
{ jenis: 'rentetan'} | rentetan JavaScript |
Cth:
Membuat objek baru yang kosong:
var JSON_Obj = {};
Penciptaan Objek Baharu:
var JSON_Obj = objek baharu()
JSON (Perbandingan dengan XML)
JSON dan XML ialah format yang boleh dibaca manusia yang bebas bahasa. Dalam senario dunia sebenar, mereka boleh membuat, membaca dan menyahkod. Berdasarkan kriteria berikut, kami boleh membandingkan JSON dengan XML.
kerumitan
Oleh kerana XML lebih kompleks daripada JSON, pengaturcara lebih suka JSON.
Penggunaan Tatasusunan
XML digunakan untuk menyatakan data berstruktur; walau bagaimanapun, XML tidak menyokong tatasusunan, tetapi JSON menyokongnya.
Parsing
JSON ditafsirkan menggunakan fungsi eval JavaScript. eval mengembalikan objek yang diterangkan apabila digunakan dengan JSON.
Contoh:
JSON | XML |
{ "syarikat": Ferrari, "nama": "GTS", “harga”: 404000 } |
Ferrari
GTS
404000
|
Kelebihan Skema JSON
JSON direka bentuk untuk membelok dalam bahasa yang boleh dibaca oleh manusia dan mesin. Walau bagaimanapun, tanpa beberapa penalaan halus, ia tidak boleh menjadi kedua-duanya. Skema JSON mempunyai kelebihan untuk menjadikan JSON lebih mudah difahami untuk kedua-dua mesin dan manusia.
Menggunakan Skema JSON juga mengalih keluar keperluan untuk beberapa kemas kini sisi pelanggan. Membuat senarai kod HTML biasa dan kemudian melaksanakannya pada bahagian klien adalah kaedah biasa tetapi tidak tepat untuk membina bahagian klien API aplikasi. Walau bagaimanapun, ini bukan strategi terbaik kerana perubahan pada bahagian pelayan mungkin menyebabkan fungsi tertentu tidak berfungsi.
Kelebihan utama Skema JSON ialah keserasiannya dengan pelbagai bahasa pengaturcaraan, serta ketepatan dan ketekalan pengesahan.
Skema JSON menyokong pelbagai jenis pelayar dan sistem operasi, oleh itu apl yang ditulis dalam JSON tidak memerlukan banyak usaha untuk menjadikan semuanya serasi dengan penyemak imbas. Semasa pembangunan, pembangun mempertimbangkan beberapa penyemak imbas, walaupun JSON sudah mempunyai keupayaan.
JSON ialah cara paling berkesan untuk berkongsi data dalam sebarang saiz, termasuk audio, video dan media lain. Ini disebabkan oleh fakta bahawa JSON menyimpan data dalam tatasusunan, yang menjadikan penghantaran data lebih mudah. Akibatnya, JSON ialah format fail terbaik untuk API dan pembangunan dalam talian.
Apabila API semakin biasa, adalah logik untuk menganggap bahawa pengesahan dan ujian API akan menjadi semakin penting. Ia juga realistik untuk menjangkakan bahawa JSON tidak mungkin menjadi lebih mudah apabila masa berlalu. Ini menunjukkan bahawa mempunyai skema untuk data anda hanya akan menjadi lebih kritikal apabila masa berlalu. Oleh kerana JSON ialah format fail standard untuk bekerja dengan API, Skema JSON ialah pengganti yang baik untuk mereka yang bekerja dengan API.
