JSON යනු දැඩි නීති රීති සහිත සාමාන්ය පෙළකි. Notepad මඟින් එය ඉතා පහසුවෙන් ලිවිය හැක. මෙහිදී වැරදෙන එකම දෙය නම් මෙවලම නොව, එහි ව්යාකරණ (syntax) ක්රමයයි. ව්යුහය නිවැරදි කරගන්න, එවිට ගොනුව සුරැකීම ඉතා පහසුය.
Notepad භාවිතයෙන් .JSON ගොනුවක් සාදා ගන්නේ කෙසේද
Jul 3, 20263 min read
JSON ගොනුවක් යනු කුමක්ද?
JSON යනු JavaScript Object Notation යන්නයි. එය දත්ත යතුරු-අගය යුගල (key-value pairs) ලෙස වරහන් තුළ ගබඩා කරන අතර, ෙනස්ටඩ් වස්තු (nested objects) සහ ඇරේ (arrays) සඳහා ද සහය දක්වයි. එය සැහැල්ලු (lightweight) වන අතර ප්රධාන වැඩසටහන් භාෂා සියල්ලටම එය කියවිය හැකි බැවින් යෙදුම් (apps), API සහ වින්යාස ගොනු (config files) සඳහා එය භාවිතා කරයි.
මූලික JSON ගොනුවක් දිස්වන්නේ මෙන්න මේ ආකාරයටයි:
{ "name": "John", "age": 28, "isActive": true, "skills": ["writing", "editing"]}පියවරෙන් පියවර: Notepad හි JSON ගොනුවක් සාදා ගන්නේ කෙසේද
පියවර 1: Notepad විවෘත කරන්න
ඔබගේ පරිගණකයේ Notepad විවෘත කරන්න, නැතහොත් ඕනෑම බ්රව්සරයකින් නොමිලේ ලබා ගත හැකි online notepad එකක් භාවිතා කරන්න.
පියවර 2: ආරම්භක වරහනකින් අරඹන්න
සෑම JSON ගොනුවක්ම වස්තුවක් (object) සඳහා { මඟින් හෝ ඇරේ (array) එකක් සඳහා [ මඟින් ආරම්භ වේ. බොහෝ ගොනු වස්තුවකින් ආරම්භ වේ.
පියවර 3: ඔබේ යතුරු (keys) සහ අගයන් (values) එකතු කරන්න
සෑම යතුරක්ම ද්විත්ව උද්ධෘත (double quotes) තුළ ලියන්න, පසුව කොමාවකින් (colon) අනතුරුව අගය ලියන්න. සෑම යුගලයක්ම කොමාවකින් (comma) වෙන් කරන්න.
{ "title": "Sample File", "version": 1}පියවර 4: ගොනුව නිවැරදිව වසන්න
ආරම්භක වරහනට අනුරූපව අවසාන වරහන යොදන්න. වස්තුවක හෝ ඇරේ එකක අවසාන යතුරු-අගය යුගලය (key-value pair)ට පසුව කොමාවක් (comma) යෙදීම අවශ්ය නොවේ.
පියවර 5: .json දිගුවක් (extension) සමඟ සුරකින්න
File වෙත ගොස්, Save As තෝරන්න. "Save as type" ඩ්රොප්ඩවුන් මෙනුවෙන් All Files තෝරාගන්න. ගොනුවට .json දිගුවක් සමඟ නමක් දෙන්න, උදාහරණයක් ලෙස data.json ලෙස දෙන්න. මෙම ඩ්රොප්ඩවුන් එක වෙනස් නොකර සුරැකුවහොත්, එය JSON ලෙස කියවිය නොහැකි .txt ගොනුවක් බවට පත්වේ.
පියවර 6: භාවිතා කිරීමට පෙර තහවුරු කරගන්න (Validate)
स्क्रिप्ट එකක හෝ යෙදුමක භාවිතා කිරීමට පෙර එය වලංගු (valid) බව තහවුරු කර ගැනීමට JSON editor එකක් වෙත ගොනුව අලවන්න (paste කරන්න). මෙහිදී සිදු කරන ඉක්මන් පරීක්ෂාවක් මඟින් පසුව දෝෂ නිستیවැරුම් (debugging) කිරීමෙන් වැළකී සිටිය හැක.
මතක තබා ගත යුතු JSON ව්යාකරණ නීති
ද්විත්ව උද්ධෘත පමණක් භාවිතා කරන්න. යතුරු සහ අගයන් සඳහා තනි උද්ධෘත (single quotes) නොව ද්විත්ව උද්ධෘත (double quotes) අවශ්ය වේ.
අවසාන කොමා යෙදීමෙන් වළකින්න. වස්තුවක හෝ ඇරේ එකක අවසාන අයිතමයෙන් පසු කිසිවක් නොමැත.
සටහන් (Comments) යෙදීමෙන් වළකින්න. සම්මත JSON ගොනුවක් තුළ // හෝ /* */ සටහන් සඳහා සහය නොදක්වයි.
Booleans අකුරු කුඩා විය යුතුය. True හෝ FALSE ලෙස නොව true සහ false ලෙස භාවිතා කරන්න.
අංක සඳහා උද්ධෘත අවශ්ය නොවේ. අගය පෙළක් (text) වීමට අදහස් කරන්නේ නම් මිጂ, "28" ලෙස නොව 28 ලෙස ලියන්න.
පොදු දෝෂ සහ ඒවා වළක්වා ගන්නේ කෙසේද
ගැටළුව: යතුරු-අගය යුගල අතර කොමාවක් මඟ හැරීම. විසඳුම: අවසාන යුගලය හැර අනෙක් සෑම යුගලයකටම පසුව කොමාවක් අවශ්ය වේ.
ගැටළුව: නොගැලපෙන වරහන්. විසඳුම: ඔබේ {} සහ [] යුගල ගණන පරීක්ෂා කරන්න. වැලිඩේටර් (validator) එකක් මඟින් ඒවා නොගැලපෙන නිශ්චිත රේඛාව පෙන්වා දෙනු ඇත.
ගැටළුව: ස්ට්රින් එකක් ඇතුළේ ඇති උද්ධෘත නිවැරදිව භාවිත නොකිරීම. විසඳුම: බැක්ස්ලෑෂ් (backslash) සමඟ අභ්යන්තර උද්ධෘත ලබා දෙන්න, උදාහරණයක් ලෙස "He said \"hello\"".
ගැටළුව: උද්ධෘත නොමැති යතුරක්. විසඳුම: id හෝ name වැනි සරල ඒවා වුවද, සෑම යතුරක්ම ද්විත්ව උද්ධෘත තුළ ඇතුළත් කළ යුතුය.
නිගමනය
JSON ගොනුවක් යනු දැඩි ආකෘතියක් අනුගමනය කරන සරල පෙළකි. ද්විත්ව උද්ධෘත භාවිතයෙන් ඔබේ යතුරු සහ අගයන් ලියන්න, වරහන් సరి කරන්න, අවසාන කොමාව ඉවත් කරන්න, සහ .json දිගුවකින් එය සුරකින්න. එය භාවිතා කිරීමට පෙර එක් වරක් වැලිඩේටර් (validator) එකක් හරහා ධාවනය කරන්න, එවිට ඔබ සම්පූර්ණයෙන්ම සූදානම්.