Notepad တွင် .JSON ဖိုင်တစ်ခုကို ဖန်တီးနည်း

JSON ဆိုသည်မှာ တင်းကျပ်သော စည်းမျဉ်းများရှိသည့် ရိုးရိုးစာသား (Plain text) ဖြစ်သည်။ Notepad ဖြင့် ၎င်းကို ကောင်းမွန်စွာ ရေးသားနိုင်သည်။ လူအများစု မှားတတ်သည်မှာ ကိရိယာကြောင့်မဟုတ်ဘဲ Syntax (ရေးသားပုံ စည်းမျဉ်း) ကြောင့်ဖြစ်သည်။ တည်ဆောက်ပုံ မှန်ကန်နေပါက ဖိုင်ကို သိမ်းဆည်းရန်မှာ အလွန်လွယ်ကူပါသည်။

JSON ဖိုင်ဆိုသည်မှာ အဘယ်နည်း။

JSON ဆိုသည်မှာ JavaScript Object Notation ကို ကိုယ်စားပြုသည်။ ၎င်းသည် ကွက်လပ်ပါ ကွင်းစကွင်းပိတ်များအတွင်း Key-Value တွဲများအနေဖြင့် ဒေတာများကို သိမ်းဆည်းပေးပြီး ထည့်သွင်းထားသော အော့ဘ်ဂျက်များ (Nested objects) နှင့် အာရေးများကို ပံ့ပိုးပေးသည်။ ပေါ့ပါးပြီး အဓိက ပရိုဂရမ်းမင်းဘာသာစကားတိုင်းက ဖတ်ရှုနိုင်သောကြောင့် အက်ပ်များ၊ API များနှင့် Config ဖိုင်များတွင် ၎င်းကို အသုံးပြုကြသည်။

အခြေခံ JSON ဖိုင်တစ်ခုသည် ဤကဲ့သို့ ရှိသည် -

{

  "name": "John",

  "age": 28,

  "isActive": true,

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

}

အဆင့်ဆင့်လမ်းညွှန်ချက် - Notepad တွင် JSON ဖိုင်တစ်ခု ဖန်တီးနည်း

အဆင့် ၁ - Notepad ကို ဖွင့်ပါ

သင့်ကွန်ပျူတာပေါ်ရှိ Notepad ကို ဖွင့်ပါ (သို့) မည်သည့် ဘראောင်ဇာမှမဆို အခမဲ့ online notepad ကို အသုံးပြုပါ။

အဆင့် ၂ - ကွင်းစ (Opening brace) ဖြင့် စတင်ပါ

JSON ဖိုင်တိုင်းသည် အော့ဘ်ဂျက်တစ်ခုအတွက် { ဖြင့် (သို့) အာရေးတစ်ခုအတွက် [ ဖြင့် စတင်သည်။ ဖိုင်အများစုသည် အော့ဘ်ဂျက်တစ်ခုဖြင့် စတင်လေ့ရှိသည်။

အဆင့်၃ - သင့်၏ Key နှင့် Valueများကို ထည့်ပါ

Key တစ်ခုချင်းစီကို ဒယ်ဘယ်ကော်ပတ်စ (Double quotes) အတွင်းရေးပါ၊ ထို့နောက် အူကိုလွန် (Colon) ခံပြီး Value ကို ရေးပါ။ တွဲတစ်ခုချင်းစီကို ကော်မာ (Comma) ဖြင့် ခြားပါ။

{

  "title": "Sample File",

  "version": 1

}

အဆင့် ၄ - ဖိုင်ကို စနစ်တကျ ပိတ်ပါ

ဖွင့်ထားသော ကွင်းစကွင်းပိတ်တိုင်းအတွက် ပိတ်မည့်ကွင်းစကွင်းပိတ်ဖြင့် ပြန်ပိတ်ပါ။ အော့ဘ်ဂျက် သို့မဟုတ် အာရေးတစ်ခုအတွင်းရှိ နောက်ဆုံး Key-Value တွဲ၏ အနောက်တွင် ကော်မာ (Comma) ထည့်ရန် မလိုပါ။

အဆင့် ၅ - .json ဖိုင်တိုးချဲ့ဖိုင်အမည်ဖြင့် သိမ်းဆည်းပါ

File သို့သွားပြီး Save As ကို နှိပ်ပါ။ "Save as type" ဒေါ့ဒေါင်း မီနူးမှ All Files ကို ရွေးချယ်ပါ။ ဖိုင်အမည်ကို .json တိုးချဲ့ဖိုင်အမည်ဖြင့် ပေးပါ (ဥပမာ- data.json)။ ဤဒေါ့ဒေါင်း မီနူးကို မပြောင်းဘဲ သိမ်းဆည်းမိပါက JSON အဖြစ် ဖတ်၍မရသော .txt ဖိုင်တစ်ခုသာ ကျန်ရစ်မည်ဖြစ်သည်။

အဆင့် ၆ - မသုံးစွဲမီ စစ်ဆေးပါ (Validate လုပ်ပါ)

ស្គ្រစ်ပ် သို့မဟုတ် အက်ပ်တစ်ခုတွင် အသုံးမပြုမီ ၎င်းသည် မှန်ကန်မှုရှိမရှိ အတည်ပြုရန် ဖိုင်ကို JSON editor တစ်ခုထဲသို့ ကူးထည့်ပါ (Paste လုပ်ပါ)။ ဤနေရာတွင် အမြန်စစ်ဆေးခြင်းဖြင့် နောက်ပိုင်းတွင် အမှားရှာရခြင်း (Debugging) မှ ကင်းဝေးစေမည်ဖြစ်သည်။

သတိထားရမည့် JSON Syntax စည်းမျဉ်းများ

• ဒယ်ဘယ်ကော်ပတ်စ (Double quotes) ကိုသာ သုံးပါ။ Key များနှင့် စာသားတန်ဖိုးများ (String values) အတွက် စင်ဂယ်ကော်ပတ်စ မဟုတ်ဘဲ ဒယ်ဘယ်ကော်ပတ်စ လိုအပ်ပါသည်။

• နောက်ဆုံးတွင် ကော်မာ (Comma) မပါစေရပါ။ အော့ဘ်ဂျက် သို့မဟုတ် အာရေးတစ်ခု၏ နောက်ဆုံးအရာနောက်တွင် မည်သည့်အရာမှ မလိုက်ရပါ။

• မှတ်ချက်များ (Comments) မပါရပါ။ ပုံမှန် JSON သည် ဖိုင်တွင်း၌ // သို့မဟုတ် /* */ မှတ်ချက်များကို မပံ့ပိုးပါ။

• Booleans များသည် စာလုံးသေး (Lowercase) ဖြစ်ရမည်။ True သို့မဟုတ် FALSE အစား true နှင့် false ကို သုံးပါ။

• နံပါတ်များအတွက် ကော်ပတ်စ မလိုပါ။ တန်ဖိုးသည် စာသားဖြစ်ရန် ရည်ရွယ်ခြင်းမဟုတ်ပါက "28" ဟု မရေးဘဲ 28 ဟုသာ ရေးပါ။

အဖြစ်များသော အမှားများနှင့် ၎င်းတို့ကို မည်သို့ ရှောင်ရှားရမည်နည်း

ပြဿနာ - Key-Value တွဲများကြားတွင် ကော်မာ ပျောက်နေခြင်း။ ဖြေရှင်းချက် - နောက်ဆုံးတွဲမှလွဲ၍ တွဲတိုင်း၏နောက်တွင် ကော်မာ ပါရှိရပါမည်။

ပြဿနာ - ကွင်းစကွင်းပိတ်များ မကိုက်ညီခြင်း။ ဖြေရှင်းချက် - သင်၏ {} နှင့် [] တွဲများကို ရေတွက်ပါ။ ဗယ်လီဒေတာ (Validator) တစ်ခုက မကိုက်ညီသည့် တိကျသော လိုင်းနံပါတ်ကို ညွှန်ပြပေးပါလိမ့်မည်။

ပြဿနာ - စာသားအတွင်း ကော်ပတ်စများကို Backslash မခံထားခြင်း။ ဖြေရှင်းချက် - အတွင်းပိုင်း ကော်ပတ်စများရှေ့တွင် Backslash ခံပါ (ဥပမာ- \"He said \\\"hello\\\"")။

ပြဿနာ - ကော်ပတ်စ မပါသော Key တစ်ခု။ ဖြေရှင်းချက် - id သို့မဟုတ် name ကဲ့သို့ ရိုးရှင်းသော Key များပင်လျှင် Key တိုင်းသည် ဒယ်ဘယ်ကော်ပတ်စအတွင်း ရှိရပါမည်။

နိဂုံး

JSON ဖိုင်ဆိုသည်မှာ တင်းကျပ်သော ပုံစံကို လိုက်နာသည့် စာသားသက်သက်သာ ဖြစ်သည်။ သင့်၏ Key များနှင့် Valueများကို ဒယ်ဘယ်ကော်ပတ်စဖြင့် ရေးပါ၊ ကွင်းစကွင်းပိတ်များကို ကိုက်ညီအောင် လုပ်ပါ၊ နောက်ဆုံး ကော်မာကို ဖြုတ်ပါ၊ ပြီးလျှင် .json တိုးချဲ့ဖိုင်အမည်ဖြင့် သိမ်းဆည်းပါ။ မသုံးစွဲမီ ဗယ်လီဒေတာ (Validator) ဖြင့် တစ်ကြိမ် စစ်ဆေးလိုက်ပါက သင်အဆင်သင့် ဖြစ်ပါပြီ။