របៀបបង្កើតឯកសារ .JSON ក្នុងកម្មវិធី Notepad

JSON គឺជាអត្ថបទធម្មតាដែលមានច្បាប់តឹងរ៉ឹង។ កម្មវិធី Notepad អាចសរសេរវាបានយ៉ាងងាយស្រួល។ អ្វីដែលមនុស្សភាគច្រើនយល់ច្រឡំគឺរចនាសម្ព័ន្ធ (Syntax) មិនមែនឧបករណ៍នោះទេ។ ប្រសិនបើអ្នកកំណត់រចនាសម្ព័ន្ធបានត្រឹមត្រូវ ការរក្សាទុកឯកសារគឺជាផ្នែកដែលងាយស្រួលបំផុត។

តើឯកសារ JSON ជាអ្វី?

JSON គឺមកពីពាក្យថា JavaScript Object Notation។ វាផ្ទុកទិន្នន័យជាគូនៃសោ-តម្លៃ (key-value pairs) នៅខាងក្នុងវង់ក្រចកអង្កាញ់ ដោយមានការគាំទ្រសម្រាប់ Object និង Array ដែលស្ថិតនៅខាងក្នុងគ្នា។ កម្មវិធី, APIs និងឯកសារកំណត់រចនាសម្ព័ន្ធ (config files) ប្រើប្រាស់វាដោយសារតែវាមានទំហំស្រាល ហើយគ្រប់ភាសាកម្មវិធីធំៗទាំងអស់សុទ្ធតែអាចអានវាបាន។

ឯកសារ JSON មូលដ្ឋានមានទម្រង់ដូចខាងក្រោម៖

{

  "name": "John",

  "age": 28,

  "isActive": true,

  "skills": ["writing", "editing"]

}

ជំហានបន្ទាប់ពីជំហាន៖ ការបង្កើតឯកសារ JSON ក្នុង Notepad

ជំហានទី ១៖ បើកកម្មវិធី Notepad

បើកកម្មវិធី Notepad នៅលើកុំព្យូទ័ររបស់អ្នក ឬប្រើ Notepad អនឡាញ ដោយឥតគិតថ្លៃពីកម្មវិធីរុករក (browser) ណាមួយក៏បាន។

ជំហានទី ២៖ ចាប់ផ្តើមដោយវង់ក្រចកបើក

ឯកសារ JSON គ្រប់ប្រភេទចាប់ផ្តើមដោយ { សម្រាប់ Object ឬ [ សម្រាប់ Array។ ឯកសារភាគច្រើនចាប់ផ្តើមដោយ Object។

ជំហានទី ៣៖ បន្ថែមសោ (Keys) និងតម្លៃ (Values) របស់អ្នក

សរសេរសោ (key) នីមួយៗនៅក្នុងសញ្ញាសម្រង់ទ្វេ (double quotes) តាមពីក្រោយដោយសញ្ញាពុចចុច (colon) រួចតាមពីក្រោយដោយតម្លៃ។ ញែកគូនីមួយៗដោយសញ្ញាក្បៀស (comma)។

{

  "title": "Sample File",

  "version": 1

}

ជំហានទី ៤៖ បិទឯកសារឱ្យបានត្រឹមត្រូវ

ផ្គូផ្គងវង់ក្រចកបើកគ្រប់ប្រភេទជាមួយនឹងវង់ក្រចកបិទ។ គូសោ-តម្លៃចុងក្រោយនៅក្នុង Object ឬ Array មិនត្រូវការសញ្ញាក្បៀសនៅខាងក្រោយឡើយ។

ជំហានទី ៥៖ រក្សាទុកដោយប្រើកន្ទុយ .json

ចូលទៅកាន់ File បន្ទាប់មក Save As។ ជ្រើសរើស All Files នៅក្នុងប្រអប់ "Save as type"។ ដាក់ឈ្មោះឯកសារដោយប្រើកន្ទុយ .json ឧទាហរណ៍ data.json។ ការរក្សាទុកដោយមិនផ្លាស់ប្តូរជម្រើសនេះនឹងធ្វើឱ្យអ្នកទទួលបានឯកសារប្រភេទ .txt ដែលមិនអាចអានជា JSON បានឡើយ។

ជំហានទី ៦៖ ធ្វើការត្រួតពិនិត្យ (Validate) មុនពេលប្រើប្រាស់

ចម្លងឯកសាររបស់អ្នកទៅក្នុង JSON editor ដើម្បីបញ្ជាក់ថាវាត្រឹមត្រូវមុនពេលអ្នកប្រើវាក្នុងស្គ្រីប ឬកម្មវិធី។ ការពិនិត្យរហ័សនៅទីនេះនឹងជួយសន្សំសំចៃពេលវេលាក្នុងការកែកំហុសនៅពេលក្រោយ។

ច្បាប់ Syntax របស់ JSON ដែលត្រូវចងចាំ

• ប្រើសញ្ញាសម្រង់ទ្វេតែប៉ុណ្ណោះ។ សោ (Keys) និងតម្លៃអត្ថបទត្រូវការសញ្ញាសម្រង់ទ្វេ មិនមែនសញ្ញាសម្រង់ឯកទេ។

• គ្មានសញ្ញាក្បៀសនៅចុងក្រោយ។ គ្មានអ្វីអាចនៅក្រោយធាតុចុងក្រោយនៃ Object ឬ Array បានទេ។

• គ្មានមតិយោបល់ (Comments)។ JSON ស្តង់ដារមិនគាំទ្រការសរសេរចំណាំបែប // ឬ /* */ នៅខាងក្នុងឯកសារទេ។

• Booleans ត្រូវតែជាអក្សរតូច។ ប្រើ true និង false មិនមែន True ឬ FALSE ទេ។

• លេខមិនត្រូវការសញ្ញាសម្រង់ទេ។ សរសេរ 28 មិនមែន "28" ទេ លើកលែងតែតម្លៃនោះត្រូវកំណត់ជាអត្ថបទ។

កំហុសទូទៅ និងវិធីជៀសវាង

បញ្ហា៖ ខ្វះសញ្ញាក្បៀសរវាងគូសោ-តម្លៃ។ ដំណោះស្រាយ៖ គ្រប់គូទាំងអស់លើកលែងតែគូចុងក្រោយត្រូវមានសញ្ញាក្បៀសនៅខាងក្រោយ។

បញ្ហា៖ វង់ក្រចកមិនផ្គូផ្គងគ្នា។ ដំណោះស្រាយ៖ រាប់ចំនួន {} និង [] របស់អ្នក។ កម្មវិធីត្រួតពិនិត្យនឹងចង្អុលបង្ហាញបន្ទាត់ដែលមិនផ្គូផ្គងគ្នានោះ។

បញ្ហា៖ សញ្ញាសម្រង់នៅខាងក្នុងអត្ថបទមិនត្រូវបាន Escape។ ដំណោះស្រាយ៖ ប្រើសញ្ញា backslash នៅពីមុខសញ្ញាសម្រង់ខាងក្នុង ឧទាហរណ៍ "He said \"hello\"".

បញ្ហា៖ សោ (key) គ្មានសញ្ញាសម្រង់។ ដំណោះស្រាយ៖ សោគ្រប់ប្រភេទត្រូវតែដាក់ក្នុងសញ្ញាសម្រង់ទ្វេ ទោះបីវាជាពាក្យសាមញ្ញដូចជា id ឬ name ក៏ដោយ។

សេចក្តីសន្និដ្ឋាន

ឯកសារ JSON គឺជាអត្ថបទដែលគោរពតាមទម្រង់តឹងរ៉ឹងមួយ។ ចូរចងចាំសរសេរសោ និងតម្លៃរបស់អ្នកដោយប្រើសញ្ញាសម្រង់ទ្វេ, ផ្គូផ្គងវង់ក្រចកឱ្យបានត្រឹមត្រូវ, ជៀសវាងសញ្ញាក្បៀសនៅចុងក្រោយ, និងរក្សាទុកវាដោយកន្ទុយ .json។ សូមធ្វើការត្រួតពិនិត្យម្តងតាមរយៈប្រព័ន្ធ Validate មុនពេលអ្នកប្រើប្រាស់វា នោះអ្នកនឹងទទួលបានលទ្ធផលល្អ។