Panduan untuk Skema JSON
Sebelum kita masuk ke Skema JSON, penting untuk mengetahui perbedaan antara Skema JSON dan JSON.
JSON
JSON adalah kependekan dari JavaScript Object Notation, dan merupakan format data bebas bahasa yang digunakan API untuk mengirim permintaan dan jawaban. JSON mudah dibaca dan ditulis untuk orang dan mesin. JSON adalah format berbasis teks yang tidak terikat pada bahasa (Language independent).
Skema JSON
Skema JSON adalah alat yang berguna untuk memverifikasi struktur data JSON. Untuk menentukan struktur JSON, gunakan format berbasis JSON. Tujuannya adalah untuk memastikan bahwa data JSON dapat diterima. Konvensi untuk data JSON aplikasi kita dapat ditentukan menggunakan skema.
Ada tiga bagian utama untuk spesifikasi Skema JSON:
JSON Hyper-Skema:
JSON Hyper-Schema adalah bahasa Skema JSON yang dapat digunakan untuk melabeli dokumen JSON dengan hyperlink dan instruksi untuk memproses dan mengubah sumber daya JSON eksternal melalui lingkungan berbasis teks seperti HTTP. Klik di sini untuk mempelajari lebih lanjut tentang JSON Hyper-Schema.
Inti Skema JSON:
Ini adalah seperangkat aturan untuk memberi label dan memvalidasi dokumen JSON.
Inti Skema JSON:
- Menjelaskan format data yang Anda miliki saat ini.
- Memvalidasi data yang dapat digunakan dalam pengujian otomatis.
- Menjamin keakuratan data yang diberikan oleh klien.
- Menyediakan dokumentasi yang dapat dibaca untuk manusia dan mesin.
Validasi Skema JSON:
Validasi berdasarkan Skema JSON memberlakukan batasan pada struktur data instance. Setelah itu, kata kunci apa pun yang tidak memiliki pernyataan informasi, seperti metadata deskriptif dan indikasi penggunaan, ditambahkan ke posisi instance yang memenuhi semua batasan yang dinyatakan.
Alat Validator Skema JSON Newtonsoft adalah alat yang dapat Anda gunakan langsung di browser Anda, gratis. Anda dapat menggunakan alat ini untuk menguji struktur skema JSON Anda. Halaman ini berisi kontrol dan penjelasan untuk Anda mulai. Dengan begitu, mudah untuk melihat cara meningkatkan struktur JSON Anda.
Kita dapat memeriksa Objek JSON kita menggunakan Alat Validasi Skema JSON:
Kami memiliki validasi usia (minimal = 20 dan maksimal = 40) seperti yang ditunjukkan pada gambar di atas. Tidak ada kesalahan yang ditemukan.
Itu menampilkan kesalahan jika validasi usia dimasukkan dengan tidak benar.
Pembuatan Skema JSON
Mari kita lihat contoh Skema JSON untuk melihat apa yang sedang kita bicarakan. Objek JSON dasar yang menjelaskan katalog produk adalah sebagai berikut:
Skema JSON-nya dapat ditulis sebagai berikut:
Skema JSON adalah dokumen JSON, dan dokumen itu HARUS berupa objek. Kata kunci adalah anggota/atribut objek yang ditentukan oleh Skema JSON. "Kata Kunci" dalam Skema JSON mengacu pada bagian "kunci" dari kombinasi kunci/nilai dalam suatu objek. Menulis Skema JSON melibatkan pemetaan "kata kunci" tertentu ke nilai di dalam objek untuk sebagian besar.
Mari kita lihat lebih dekat kata kunci yang kami gunakan dalam contoh kami:
Skema JSON yang dipatuhi oleh skema sumber daya dituliskan oleh atribut ini. Skema ini ditulis mengikuti standar draf v4, seperti yang ditentukan oleh “$ schema” kata kunci. Ini mencegah skema Anda kembali ke versi saat ini, yang mungkin kompatibel atau tidak dengan yang lebih lama.
The "judul"Dan"deskripsi” kata kunci hanyalah penjelasan; mereka tidak memaksakan batasan apa pun pada data yang diperiksa. Kedua kata kunci ini menjelaskan tujuan skema: ini menjelaskan suatu produk.
The "mengetik” kata kunci menentukan kondisi batas pertama data JSON kami; itu harus menjadi Objek JSON. Jika kami tidak menyetel tipe untuk semua skema, kode tidak akan berfungsi. Beberapa jenis yang umum adalah "nomor" "Boolean" "bilangan bulat" "null" "objek" "array" "string".
Skema JSON didukung oleh pustaka berikut:
Bahasa | Perpustakaan |
C | Elemen WJ |
Ular sanca | jschon |
PHP | Penjabaran dari Skema Json |
JavaScript | ajv |
Go | gojsonschema |
Kotlin | Media-validator |
Rubi | JSONSchemer |
JSON (Sintaks)
Mari kita lihat sekilas sintaks dasar JSON. Sintaks JSON adalah subset dari sintaks JavaScript yang mencakup elemen-elemen berikut:
- Pasangan nama/nilai digunakan untuk mewakili data.
- Objek disimpan dalam kurung kurawal, dan setiap nama dipimpin oleh ':' (titik dua), dengan pasangan nilai dipisahkan oleh "," (koma).
- Nilai dipisahkan dengan “,” (koma) dan array disimpan dalam tanda kurung siku.
Dua struktur data berikut ini didukung oleh JSON:
- Daftar nilai yang dipesan: Itu bisa berupa array, daftar, atau vektor.
- Kumpulan pasangan nama/nilai: Bahasa komputer yang berbeda mendukung Struktur Data ini.
JSON (Objek)
Skema JSON adalah objek JSON yang menguraikan jenis dan struktur objek JSON yang berbeda. Ekspresi objek JavaScript dapat mewakili objek JSON di lingkungan runtime JavaScript. Beberapa contoh objek skema yang valid adalah sebagai berikut:
Skema | Korek api |
{} | nilai apapun |
{ ketik: 'objek' } | objek JavaScript |
{ ketik: 'angka' } | nomor JavaScript |
{ ketik: 'tali'} | string JavaScript |
Misalnya:
Membuat objek baru yang kosong:
var JSON_Obj = {};
Pembuatan Objek Baru:
var JSON_Obj = objek baru()
JSON (Perbandingan dengan XML)
JSON dan XML adalah format yang dapat dibaca manusia yang bebas bahasa. Dalam skenario dunia nyata, keduanya dapat membuat, membaca, dan mendekode. Berdasarkan kriteria berikut, kita dapat membandingkan JSON dengan XML.
Kompleksitas
Karena XML lebih kompleks daripada JSON, pemrogram lebih memilih JSON.
Penggunaan Array
XML digunakan untuk mengekspresikan data terstruktur; namun, XML tidak mendukung array, tetapi JSON mendukungnya.
Penguraian
JSON ditafsirkan menggunakan fungsi eval JavaScript. eval mengembalikan objek yang dijelaskan saat digunakan dengan JSON.
Contoh:
JSON | XML |
{ "perusahaan": Ferrari, "nama": "GTS", "harga": 404000 } |
Ferrari
GTS
404000
|
Keuntungan Skema JSON
JSON dirancang untuk membelokkan bahasa yang dapat dibaca manusia dan mesin. Namun, tanpa beberapa penyesuaian, itu tidak akan terjadi. Skema JSON memiliki keuntungan membuat JSON lebih mudah dipahami baik untuk mesin maupun manusia.
Menggunakan Skema JSON juga menghilangkan kebutuhan akan beberapa pembaruan sisi klien. Membuat daftar kode HTML umum dan kemudian mengimplementasikannya di sisi klien adalah metode yang khas tetapi tidak akurat untuk membangun sisi klien API aplikasi. Namun, ini bukan strategi terbaik karena perubahan pada sisi server dapat menyebabkan kegagalan fungsi tertentu.
Keuntungan utama Skema JSON adalah kompatibilitasnya dengan berbagai bahasa pemrograman, serta keakuratan dan konsistensi validasi.
Skema JSON mendukung berbagai browser dan sistem operasi, oleh karena itu aplikasi yang ditulis dalam JSON tidak membutuhkan banyak usaha untuk membuat semuanya kompatibel dengan browser. Selama pengembangan, pengembang mempertimbangkan beberapa browser, meskipun JSON sudah memiliki kemampuannya.
JSON adalah cara paling efisien untuk berbagi data dalam berbagai ukuran, termasuk audio, video, dan media lainnya. Ini karena JSON menyimpan data dalam array, yang membuat transmisi data lebih mudah. Hasilnya, JSON adalah format file terbaik untuk API dan pengembangan online.
Karena API semakin umum, masuk akal untuk mengasumsikan bahwa validasi dan pengujian API akan menjadi semakin penting. Juga realistis untuk berharap bahwa JSON tidak akan menjadi lebih sederhana seiring berjalannya waktu. Ini menyiratkan bahwa memiliki skema untuk data Anda hanya akan menjadi lebih kritis seiring berjalannya waktu. Karena JSON adalah format file standar untuk bekerja dengan API, Skema JSON adalah pengganti yang baik untuk mereka yang bekerja dengan API.
