រំលងទៅមាតិកា

អ្នកសរសេរកូដ

ការរៀបចំទម្រង់ និងពិនិត្យ JSON សម្រាប់អ្នកចាប់ផ្តើម

កែប្រែចុងក្រោយ: អាន ៧ នាទី

ការរៀបចំទម្រង់ JSON គឺប្តូរទិន្នន័យដែលជាបន្ទាត់វែងពិបាកអាន ទៅជាអត្ថបទដែលចូលបន្ទាត់យ៉ាងស្អាត ហើយការពិនិត្យ (validation) គឺផ្ទៀងផ្ទាត់ថាអត្ថបទនោះគោរពតាមច្បាប់តឹងរ៉ឹងរបស់ JSON។ វិធីលឿនបំផុតដើម្បីធ្វើទាំងពីរ គឺបិទភ្ជាប់ទិន្នន័យរបស់អ្នកក្នុង រៀបចំកូដ JSON ឥតគិតថ្លៃរបស់ ToolOrca ហើយចុច ទម្រង់ (Format)៖ JSON ដែលត្រឹមត្រូវត្រូវរៀបចំភ្លាមៗ ហើយបើមានអ្វីខុស អ្នកនឹងឃើញបន្ទាត់ និងជួរឈរនៃកំហុសយ៉ាងច្បាស់។ អ្វីៗទាំងអស់ដំណើរការក្នុងកម្មវិធីរុករក ដូច្នេះអ្វីដែលអ្នកបិទភ្ជាប់មិនត្រូវបានផ្ទុកឡើងឡើយ។

មគ្គុទ្ទេសក៍សម្រាប់អ្នកចាប់ផ្តើមនេះ ពន្យល់ថា JSON ជាអ្វី ច្បាប់វាក្យសម្ពន្ធមួយចំនួនតូចដែលបង្កកំហុសស្ទើរតែទាំងអស់ និងរបៀបអាន ជួសជុល និងបំប្លែង JSON។

តើ JSON ជាអ្វី

JSON (JavaScript Object Notation) គឺជាទម្រង់អត្ថបទសាមញ្ញសម្រាប់ទិន្នន័យដែលមានរចនាសម្ព័ន្ធ។ API ផ្ញើទិន្នន័យជា JSON កម្មវិធីរក្សាទុកការកំណត់ជា JSON ហើយមូលដ្ឋានទិន្នន័យក៏នាំចេញជា JSON ដែរ។ វាផ្សំឡើងពីធាតុតែប៉ុន្មានប្រភេទប៉ុណ្ណោះ៖

  • Object ក្នុងវង់ក្រចកកោង៖ { "key": value }
  • Array ក្នុងវង់ក្រចកជ្រុង៖ [ value, value ]
  • String (ខ្សែអក្សរ) ក្នុងសញ្ញាសម្រង់ពីរ៖ "Phnom Penh"
  • លេខ៖ 42, 3.14, -7
  • Boolean៖ true ឬ false
  • null៖ តម្លៃទទេ

នេះជាឧទាហរណ៍តូចមួយដែលត្រឹមត្រូវ៖

{
  "name": "Sokha",
  "age": 28,
  "languages": ["Khmer", "English"],
  "address": { "city": "Siem Reap", "zip": null },
  "active": true
}

របៀបរៀបចំទម្រង់ និងពិនិត្យ JSON មួយជំហានម្តងៗ

  1. បិទភ្ជាប់ JSON របស់អ្នកក្នុង រៀបចំកូដ JSON។ អ្នកក៏អាចទម្លាក់ឯកសារ .json លើប្រអប់ ឬចុច បើកឯកសារ ផងដែរ។ បើធីក ធ្វើទ្រង់ទ្រាយពេលបិទភ្ជាប់ JSON ដែលបិទភ្ជាប់នឹងត្រូវរៀបចំដោយស្វ័យប្រវត្តិ។
  2. ជ្រើសការចូលបន្ទាត់។ នៅត្រង់ ចន្លោះបន្ទាត់ចូល (Indent) ជ្រើស ដកឃ្លា 2 ដកឃ្លា 4 ឬ Tab ហើយធីក តម្រៀប keys A→Z បើអ្នកចង់ឱ្យ key តម្រៀបតាមលំដាប់អក្សរ។
  3. ចុច ទម្រង់ ឬ បង្រួម។ ទម្រង់ (Format, Ctrl/⌘ + Enter) ធ្វើឱ្យ JSON ងាយអាន ចំណែក បង្រួម (Minify) លុបដកឃ្លាដែលមិនចាំបាច់ទាំងអស់។
  4. ជួសជុលកំហុស។ បើ JSON មិនត្រឹមត្រូវ សូមអានបន្ទាត់ និងជួរឈរក្នុងសារពណ៌ក្រហម ឬចុច ជួសជុល JSON ដើម្បីជួសជុលបញ្ហាទូទៅដោយស្វ័យប្រវត្តិ។
  5. រុករក និងចម្លង។ បើកផ្ទាំង មែកធាង (Tree) ដើម្បីបត់ទិន្នន័យជាន់គ្នា និងចម្លង path ពិនិត្យផ្ទាំង ស្ថិតិ សម្រាប់ជម្រៅ ចំនួន key និងទំហំ រួចចុច ចម្លង ឬ Download .json។

គន្លឹះ៖ ចុច គំរូ ដើម្បីផ្ទុក JSON ឧទាហរណ៍ បើអ្នកគ្រាន់តែចង់សាកល្បងឧបករណ៍ និងមើលថាទិដ្ឋភាពមែកធាងដំណើរការយ៉ាងណា។

ច្បាប់វាក្យសម្ពន្ធដែលនាំឱ្យមានកំហុស JSON ភាគច្រើន

JSON មើលទៅដូច JavaScript ប៉ុន្តែតឹងរ៉ឹងជាងច្រើន។ ខាងក្រោមនេះជាកំហុសដែលអ្នកចាប់ផ្តើមជួបញឹកញាប់ជាងគេ។

សញ្ញាក្បៀសនៅចុង។ មិនអនុញ្ញាតឱ្យមានសញ្ញាក្បៀសក្រោយធាតុចុងក្រោយទេ៖

{ "a": 1, "b": 2, }

សូមលុបសញ្ញាក្បៀសក្រោយលេខ 2។

សញ្ញាសម្រង់តែមួយ។ Key និង string ត្រូវប្រើសញ្ញាសម្រង់ពីរ៖

{ 'name': 'Dara' }

ទម្រង់ត្រឹមត្រូវ៖ { "name": "Dara" }។

Key គ្មានសញ្ញាសម្រង់។ JavaScript ទទួលយក { name: "Dara" } ប៉ុន្តែ JSON ត្រូវការ { "name": "Dara" }។

Comment។ JSON គ្មាន comment ទាល់តែសោះ ដូច្នេះ // note ឬ /* note */ ធ្វើឱ្យវាមិនត្រឹមត្រូវ។

តម្លៃរបស់ Python។ True False និង None ជារបស់ Python មិនមែន JSON ទេ។ JSON ប្រើ true false និង null។

លេខពិសេស។ NaN Infinity និង undefined មិនមែនជាតម្លៃ JSON ត្រឹមត្រូវទេ។ សូមប្រើ null ឬលេខពិតប្រាកដ។

តួអក្សរមិនបាន escape។ ការចុះបន្ទាត់ tab ឬសញ្ញាសម្រង់ពីរ នៅក្នុង string ត្រូវសរសេរជា \n \t ឬ \"។ ការចុះបន្ទាត់ផ្ទាល់នៅក្នុងសញ្ញាសម្រង់ ជាមូលហេតុទូទៅដែលបន្ទាត់ log ដែលចម្លងមក មិនអាច parse បាន។

អ្វីដែល ជួសជុល JSON អាចជួសជុលបាន

ឯកសារកំណត់រចនាសម្ព័ន្ធ object របស់ JavaScript និង dictionary របស់ Python ច្រើនតែមើលទៅដូច JSON តែតាមពិតមិនមែនទេ។ ជួសជុល JSON អានទិន្នន័យទាំងនោះដោយបត់បែន ហើយសរសេរចេញជា JSON តឹងរ៉ឹង។ វាលុប comment និងសញ្ញាក្បៀសនៅចុង ប្តូរសញ្ញាសម្រង់តែមួយទៅជាសញ្ញាសម្រង់ពីរ ដាក់សញ្ញាសម្រង់លើ key ដែលគ្មាន ប្តូរ True False និង None របស់ Python ទៅជា true false និង null ជំនួស NaN Infinity និង undefined ដោយ null ហើយបន្ថែមសញ្ញាក្បៀសដែលខ្វះរវាងតម្លៃពីរ។

ឧទាហរណ៍ ទិន្នន័យបញ្ចូលនេះ៖

{ name: 'Dara', active: True, tags: ['a', 'b',], // test
}

ក្លាយជា JSON ត្រឹមត្រូវ៖

{
  "name": "Dara",
  "active": true,
  "tags": [
    "a",
    "b"
  ]
}

សាររាយបញ្ជីគ្រប់ប្រភេទនៃការកែប្រែដែលបានធ្វើ ដូច្នេះអ្នកអាចពិនិត្យលទ្ធផលបាន។ បើទិន្នន័យខូចខ្លាំងពេកមិនអាចទាយបាន ដូចជាខ្វះវង់ក្រចកបិទនៅកណ្តាល ឧបករណ៍ពិនិត្យនៅតែបង្ហាញទីតាំងពិតប្រាកដនៃបញ្ហា។

JSON ស្អាត និង JSON បង្រួម

JSON ស្អាត (រៀបចំទម្រង់) បន្ថែមការចុះបន្ទាត់ និងការចូលបន្ទាត់ ដើម្បីឱ្យមនុស្សអាន និងប្រៀបធៀបបានងាយ។ JSON បង្រួមលុបដកឃ្លាដែលមិនចាំបាច់ទាំងអស់ ទិន្នន័យនៅដដែល តែឯកសារតូចជាង ដែលជាអ្វីដែលអ្នកត្រូវការសម្រាប់ API និងឯកសារកំណត់រចនាសម្ព័ន្ធពេលដំណើរការពិត។ ផ្ទាំង ស្ថិតិ បង្ហាញទាំងទំហំស្អាត និងទំហំក្រោយ Minify។

ទិដ្ឋភាពមែកធាង path និងលេខធំៗ

API response ធំៗ ងាយអានជាងច្រើននៅក្នុងផ្ទាំង មែកធាង (Tree)។ អ្នកអាចបត់ និងពន្លាត object ដោយ ពន្លាតទាំងអស់ និង បង្រួមទាំងអស់ ហើយស្វែងរក key និងតម្លៃបាន។ ចុចលើ key ឬតម្លៃណាមួយ នោះ path របស់វានឹងលេចឡើង ជាមួយប៊ូតុង ចម្លងផ្លូវ និង ចម្លងតម្លៃ។ ជ្រើសទម្រង់សរសេរដែលអ្នកត្រូវការ៖

  • JSONPath៖ $.reviews[0].user (ឧបករណ៍តេស្ត និង Postman)
  • JavaScript៖ data.reviews[0].user (ក្នុងកូដ)
  • jq៖ .reviews[0].user (បន្ទាត់ពាក្យបញ្ជា)
  • JSON Pointer៖ /reviews/0/user (JSON Patch និង OpenAPI)

លេខធំៗ ត្រូវប្រុងប្រយ័ត្ន។ JavaScript រក្សាទុកលេខជាប្រភេទ float ៦៤ ប៊ីត ដូច្នេះ JSON.parse បង្គត់ចំនួនគត់ដែលធំជាង 9,007,199,254,740,991 ដោយស្ងាត់ៗ។ ID ដូចជា 9007199254740993123 នឹងត្រលប់មកវិញខុសពីដើម នៅក្នុងឧបករណ៍ជាច្រើន។ ឧបករណ៍រៀបចំកូដ JSON រក្សាលេខបែបនេះដូចដែលបានសរសេរដើម ហើយប្រាប់អ្នកថារកឃើញប៉ុន្មាន ដែលជាសញ្ញាថាកូដរបស់អ្នកប្រហែលត្រូវអានវាជា string ឬ BigInt។

បំប្លែង JSON ទៅ CSV ទៅ YAML និងត្រលប់មកវិញ

  • បំប្លែង JSON ទៅ CSV ប្តូរ array នៃ object ទៅជាឯកសារតារាង។ Key នីមួយៗក្លាយជាជួរឈរ object ជាន់គ្នាត្រូវពន្លាតជាឈ្មោះដូចជា address.city ហើយអ្នកអាចជ្រើសសញ្ញាក្បៀស សញ្ញាចុចក្បៀស tab ឬ pipe ជាសញ្ញាកំណត់ព្រំដែន មុនពេលចុចទាញយក .csv។
  • បំប្លែង CSV ទៅ JSON ធ្វើផ្ទុយមកវិញ គឺប្តូរឯកសារនាំចេញពីតារាង ទៅជា JSON array។
  • បំប្លែង JSON ទៅ YAML សរសេរទិន្នន័យដដែលជា YAML សម្រាប់ឯកសារ Kubernetes, Docker Compose ឬ CI ហើយទិសដៅ YAML → JSON របស់វាអាន YAML ត្រលប់មកជា JSON វិញ។

ដើម្បីមើល JSON ផ្ទាល់ពី API ឧបករណ៍ REST API Client ផ្ញើសំណើពីកម្មវិធីរុករករបស់អ្នក ហើយបង្ហាញ response body ដែលរៀបចំឱ្យស្អាត ហើយប៊ូតុង រៀបចំទម្រង់ JSON របស់វា រៀបចំ និងពិនិត្យ request body មុនពេលអ្នកចុច ផ្ញើ។

កំហុសទូទៅដែលគួរជៀសវាង

  • ចម្លង JSON ពីកម្មវិធីជជែក ឬឯកសារ។ កម្មវិធីខ្លះប្តូរសញ្ញាសម្រង់ត្រង់ " ទៅជាសញ្ញាសម្រង់កោង ដែល JSON មិនទទួលយក។ បើអាច សូមចម្លងពីប្រភពអត្ថបទសុទ្ធ។
  • គិតថាច្បាប់ JavaScript ប្រើបានដូចគ្នា។ សញ្ញាក្បៀសនៅចុង សញ្ញាសម្រង់តែមួយ និង comment ប្រើបានក្នុង JavaScript ប៉ុន្តែធ្វើឱ្យ JSON ខូច។
  • មិនអើពើនឹង key ស្ទួន។ JSON អនុញ្ញាតឱ្យមាន key ដដែលពីរដងក្នុង object តែមួយ ប៉ុន្តែ parser ភាគច្រើនរក្សាតែតម្លៃចុងក្រោយ។ ឧបករណ៍នឹងព្រមានអ្នក ព្រោះវាច្រើនតែជាសញ្ញានៃកំហុសក្នុងកូដ។
  • បាត់បង់ ID វែងៗ។ បើឧបករណ៍ ឬកូដរបស់អ្នកបង្គត់លេខធំៗ ID និងចំនួនទឹកប្រាក់អាចប្រែប្រួលដោយស្ងាត់ៗ។ សូមរក្សាទុកវាជា string។
  • បិទភ្ជាប់ទិន្នន័យសម្ងាត់ក្នុងឧបករណ៍ដែលផ្ទុកទិន្នន័យឡើង។ សម្រាប់ response ដែលមាន token ឬទិន្នន័យផ្ទាល់ខ្លួន សូមប្រើឧបករណ៍ដែលដំណើរការក្នុងកម្មវិធីរុករក។

សេចក្តីសង្ខេប

JSON សាមញ្ញណាស់ ពេលអ្នកស្គាល់ច្បាប់តឹងរ៉ឹងរបស់វា៖ ប្រើសញ្ញាសម្រង់ពីរគ្រប់កន្លែង គ្មានសញ្ញាក្បៀសនៅចុង គ្មាន comment ហើយតម្លៃពិសេសមានតែ true false និង null ប៉ុណ្ណោះ។ បិទភ្ជាប់ទិន្នន័យរបស់អ្នកក្នុង រៀបចំកូដ JSON ដើម្បីរៀបចំទម្រង់ និងពិនិត្យ ប្រើ ជួសជុល JSON សម្រាប់ទិន្នន័យដែលស្ទើរជា JSON ពីកូដ ឬឯកសារកំណត់ រុករកទិន្នន័យធំៗក្នុងទិដ្ឋភាពមែកធាង ហើយបំប្លែងទៅ CSV ឬ YAML ពេលឧបករណ៍ផ្សេងត្រូវការទម្រង់ផ្សេង។

សំណួរដែលសួរញឹកញាប់

តើពិនិត្យដោយរបៀបណាថា JSON របស់ខ្ញុំត្រឹមត្រូវ?

បិទភ្ជាប់វាក្នុង រៀបចំកូដ JSON ហើយចុច ទម្រង់ (Format)។ JSON ដែលត្រឹមត្រូវនឹងត្រូវរៀបចំឱ្យស្អាត និងបញ្ជាក់ថាត្រឹមត្រូវ ចំណែក JSON ដែលខុសនឹងបង្ហាញសារពណ៌ក្រហម ប្រាប់បន្ទាត់ និងជួរឈរនៃកំហុសទីមួយ ហើយទស្សន៍ទ្រនិចលោតទៅកន្លែងនោះតែម្តង។

ហេតុអ្វីសញ្ញាក្បៀសនៅចុងជាកំហុសក្នុង JSON?

ស្តង់ដារ JSON មិនអនុញ្ញាតឱ្យមានសញ្ញាក្បៀសក្រោយធាតុចុងក្រោយនៃ array ឬ object ទេ ដូច្នេះ [1, 2, 3,] មិនត្រឹមត្រូវ ទោះបី JavaScript ទទួលយកក៏ដោយ។ សូមលុបសញ្ញាក្បៀសចុងក្រោយចេញ ឬចុច ជួសជុល JSON ដើម្បីឱ្យវាលុបជូន។

តើ JSON អាចមាន comment បានទេ?

មិនបានទេ។ JSON ស្តង់ដារគ្មាន comment ទេ។ ទម្រង់ដូចជា JSONC ឬ JSON5 អនុញ្ញាត ប៉ុន្តែ parser តឹងរ៉ឹងនឹងបដិសេធ។ ជួសជុល JSON លុប comment //, /* */ និង # ហើយផ្តល់ឱ្យអ្នកនូវ JSON ស្តង់ដារ។

តើ JSON ស្អាត និង JSON បង្រួម ខុសគ្នាដូចម្តេច?

ទាំងពីរមានទិន្នន័យដូចគ្នាបេះបិទ។ JSON ស្អាត (រៀបចំទម្រង់) បន្ថែមការចុះបន្ទាត់ និងការចូលបន្ទាត់ ដើម្បីឱ្យមនុស្សអានងាយ។ JSON បង្រួម (minify) លុបដកឃ្លាដែលមិនចាំបាច់ទាំងអស់ ដើម្បីឱ្យឯកសារតូច ដែលសមសម្រាប់ API និងឯកសារកំណត់រចនាសម្ព័ន្ធពេលដំណើរការពិត។

តើបិទភ្ជាប់ API response ដែលមាន token ក្នុងឧបករណ៍នេះ មានសុវត្ថិភាពទេ?

ឧបករណ៍រៀបចំកូដ JSON វិភាគទិន្នន័យនៅក្នុងកម្មវិធីរុករករបស់អ្នក ហើយមិនផ្ទុកឡើងទៅណាទេ ដូច្នេះ token និងទិន្នន័យផ្ទាល់ខ្លួននៅតែលើឧបករណ៍របស់អ្នក។

តើបំប្លែង JSON ទៅជាតារាង Excel ដោយរបៀបណា?

ប្រើ បំប្លែង JSON ទៅ CSV។ បិទភ្ជាប់ JSON array នៃ object ជ្រើសសញ្ញាកំណត់ព្រំដែន (Delimiter) ពិនិត្យមើលតារាងជាមុន រួចចុចទាញយក .csv។ ឯកសារនេះបើកបានក្នុង Excel ឬ Google Sheets ហើយ object ជាន់គ្នាក្លាយជាជួរឈរដូចជា address.city។