Membetulkan dan Mengesahkan JSON dengan Mudah: Panduan Mendalam

Memahami Struktur JSON

JSON (JavaScript Object Notation) ialah format pertukaran data ringan yang mudah dibaca dan ditulis oleh manusia serta mudah dihuraikan dan dijana oleh mesin. Ia terdiri daripada dua struktur asas:

1. Objek: Koleksi pasangan kunci/nilai yang disertakan dalam pendakap kerinting {}.

   • Contoh: { "nama": "John", "umur": 30 }

2. Array: Koleksi tersusun nilai yang disertakan dalam kurungan segi empat sama [].

   • Contoh: ["epal", "pisang", "ceri"]

Ralat JSON Biasa

Sebelum melangkah ke dalam membetulkan dan mengesahkan JSON, mari kita fahami isu biasa yang mungkin anda hadapi dengan JSON dahulu:

1. Koma hilang atau tambahan: Koma mengekor di hujung tatasusunan atau objek atau koma yang hilang boleh membawa kepada JSON tidak sah.

   • JSON tidak sah: { "nama": "John", "umur": 30, }
   • JSON yang betul: { "nama": "John", "umur": 30 }

2. Kunci tidak dipetik: Kunci JSON mesti sentiasa disertakan dalam petikan berganda (").

   • JSON tidak sah: { nama: "John" }
   • JSON yang betul: { "nama": "John" }

3. Jenis data salah: Pastikan penggunaan jenis data yang betul. Contohnya, rentetan hendaklah dipetik, nombor hendaklah dinyahpetik.

   • JSON tidak sah: { "umur": "30" } (umur disebut tetapi mesti nombor)
   • JSON yang betul: { "umur": 30 }

4. Kurungan tidak sepadan: Sentiasa pastikan kurungan kerinting {} dan kurungan segi empat sama [] sepadan dengan betul.

   • JSON tidak sah: { "nama": "John", "umur": 30
   • JSON yang betul: { "nama": "John", "umur": 30 }

5. Aksara tidak sah: Rentetan JSON hanya boleh mengandungi aksara tertentu. Contohnya, garis miring ke belakang () mesti dilepaskan dalam rentetan.

   • JSON tidak sah: { "petikan": "Ini ialah tanda serong ke belakang \" }
   • JSON yang betul: { "petikan": "Ini ialah tanda serong ke belakang \\" }

Bagaimana untuk Membetulkan JSON

Untuk membetulkan JSON yang tidak sah, anda boleh mengikuti langkah berikut:

1. Membetulkan JSON Secara Manual

Jika anda mempunyai sekeping kecil JSON yang tidak sah, mungkin paling mudah untuk membetulkannya secara manual sahaja. Berikut ialah pendekatan mudah:

• Langkah 1: Kenal pasti dan betulkan ralat sintaks (seperti tiada koma, kurungan atau petikan).
• Langkah 2: Pastikan semua kekunci berada dalam petikan berganda dan nilainya adalah dari jenis yang betul (rentetan, nombor, boolean, tatasusunan, objek, nol).
• Langkah 3: Gunakan pengesah JSON (lebih lanjut mengenai perkara di bawah) untuk mengesahkan bahawa JSON anda berstruktur dengan betul.

2. Menggunakan Alat Dalam Talian untuk Membetulkan JSON

Terdapat beberapa alatan dalam talian yang boleh membantu anda membetulkan atau memformat JSON secara automatik:

• JSONLint (https://onlinejsonformatter.com) – Ia menyemak sintaks JSON dan menyerlahkan ralat. Ia juga boleh memformatkan JSON yang tidak kemas menjadi struktur yang boleh dibaca.
• JSON Formatter & Validator (https://jsonformatter.curiousconcept.com/) – Alat ini membantu memformat JSON dan menyediakan penerangan ralat.
• JSON Prettifier – Ia boleh membantu membersihkan dan menjadikan JSON anda lebih mudah dibaca.

Alat ini lazimnya menyerlahkan isu sintaks dan memberikan mesej ralat yang boleh mengarahkan anda ke tempat masalahnya, menjadikannya lebih mudah untuk diselesaikan.

3. Menggunakan Editor Kod dengan Sokongan JSON

Banyak editor kod (cth., Visual Studio Code, Sublime Text atau Atom) menawarkan kefungsian khusus JSON, seperti:

• Penyertaan sintaks: Warna dan pemformatan membantu anda melihat kurungan atau petikan yang tidak padan secara visual.
• Linting: Alat seperti ESLint atau TSLint boleh membantu membenderakan isu dalam fail JSON.
• Autoformat: Editor seperti VSCode mempunyai pemformat terbina dalam yang akan membetulkan lekukan JSON secara automatik dan mengalih keluar ruang kosong tambahan.

Contoh dalam Kod VS:

1. Buka fail JSON anda.
2. Klik Shift Alt F untuk autoformat dan selesaikan isu jarak biasa.
3. Gunakan sambungan seperti Prettier untuk pemformatan JSON selanjutnya.

4. Menggunakan Bahasa Pengaturcaraan untuk Membetulkan JSON

Jika anda mempunyai set data yang besar, menggunakan bahasa pengaturcaraan (seperti Python, JavaScript atau Go) mungkin lebih cekap. Sebagai contoh, dalam Python, anda boleh menggunakan modul json untuk mengesahkan dan membetulkan JSON:

import json

# Read the JSON string from a file or input
input_json = '{"name": "John", "age": 30,}'

# Try to load and fix the JSON
try:
    parsed_json = json.loads(input_json)  # This will raise an error if the JSON is invalid
except json.JSONDecodeError as e:
    print(f"Invalid JSON: {e}")

# Correcting it manually or programmatically and revalidating

Dalam JavaScript, anda boleh menggunakan JSON.parse() untuk menyemak sama ada JSON itu sah dan kemudian mengubah suainya:

const inputJson = '{"name": "John", "age": 30,}';

try {
    const parsedJson = JSON.parse(inputJson); // Throws error if invalid
    console.log('Valid JSON:', parsedJson);
} catch (error) {
    console.log('Invalid JSON:', error.message);
}

Mengesahkan JSON

Pengesahan JSON melibatkan pemeriksaan sama ada rentetan JSON distruktur dan diformat dengan betul. Ini boleh dilakukan dalam beberapa cara:

1. Menggunakan Pengesah JSON

Terdapat beberapa alat pengesahan JSON percuma tersedia dalam talian:

• JSONLint: Tampalkan JSON anda ke dalam kotak dan klik "Sahkan JSON." Ia akan menunjukkan sama ada JSON anda sah atau menyerlahkan jika ia tidak sah.
• JSON Formatter & Validator: Alat ini bukan sahaja mengesahkan tetapi juga memformat JSON dengan cara yang boleh dibaca.

2. Mengesahkan dengan Bahasa Pengaturcaraan

Kebanyakan bahasa pengaturcaraan mempunyai fungsi atau perpustakaan terbina dalam untuk mengesahkan JSON:

• Python:

import json

# Read the JSON string from a file or input
input_json = '{"name": "John", "age": 30,}'

# Try to load and fix the JSON
try:
    parsed_json = json.loads(input_json)  # This will raise an error if the JSON is invalid
except json.JSONDecodeError as e:
    print(f"Invalid JSON: {e}")

# Correcting it manually or programmatically and revalidating

• JavaScript:

const inputJson = '{"name": "John", "age": 30,}';

try {
    const parsedJson = JSON.parse(inputJson); // Throws error if invalid
    console.log('Valid JSON:', parsedJson);
} catch (error) {
    console.log('Invalid JSON:', error.message);
}

• Pergi:

  import json

  try:
      json_object = json.loads('{"name": "John", "age": 30}')
      print("Valid JSON")
  except ValueError as e:
      print("Invalid JSON", e)

3. Menggunakan Pengesahan Skema JSON

Untuk struktur JSON yang lebih kompleks, anda boleh mengesahkan JSON terhadap Skema JSON yang dipratakrifkan. Skema JSON ialah rangka tindakan yang mentakrifkan struktur, sifat yang diperlukan dan jenis data dokumen JSON.

• Skema JSON adalah seperti kontrak yang mentakrifkan rupa JSON yang sah.
• Alat seperti AJV (Satu lagi JSON Schema Validator) dalam JavaScript atau pustaka jsonschema Python boleh membantu anda mengesahkan data JSON terhadap skema.

Contoh Skema JSON:

  try {
      JSON.parse('{"name": "John", "age": 30}');
      console.log("Valid JSON");
  } catch (e) {
      console.log("Invalid JSON");
  }

Mengesahkan JSON dalam Python dengan Skema:

  import (
      "encoding/json"
      "fmt"
  )

  func main() {
      var jsonData = `{"name": "John", "age": 30}`
      var obj map[string]interface{}

      err := json.Unmarshal([]byte(jsonData), &obj)
      if err != nil {
          fmt.Println("Invalid JSON:", err)
      } else {
          fmt.Println("Valid JSON")
      }
  }

Mengautomasikan Pengesahan JSON

Untuk penyepaduan berterusan, ujian automatik atau persekitaran pengeluaran, anda mungkin mahu mengautomasikan pengesahan JSON menggunakan alat binaan atau saluran paip CI (seperti GitHub Actions, Jenkins, dll.).

• Anda boleh menggunakan alatan seperti JSONLint, lebih cantik atau menulis skrip pengesahan tersuai menggunakan bahasa pengaturcaraan dan menyepadukannya ke dalam aliran kerja anda.

Kesimpulan

Membetulkan dan mengesahkan JSON ialah kemahiran kritikal untuk pembangun, terutamanya apabila bekerja dengan API, fail konfigurasi atau pertukaran data antara sistem. Sama ada anda bekerja dengan objek JSON yang kecil atau set data yang besar, memahami perangkap biasa, menggunakan alatan dalam talian, bahasa pengaturcaraan atau pengesahan Skema JSON boleh meningkatkan kebolehpercayaan dan ketepatan data JSON anda dengan ketara.

Dengan menggunakan alat yang betul, seperti pengesah dalam talian, penyunting kod dengan ciri terbina dalam atau mengautomasikan proses dengan skrip, anda boleh memastikan pemformat JSON anda adalah sah dan mudah digunakan .

Atas ialah kandungan terperinci Membetulkan dan Mengesahkan JSON dengan Mudah: Panduan Mendalam. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!