በኖትፓድ (Notepad) ውስጥ የ .JSON ፋይልን እንዴት መፍጠር እንደሚቻል

JSON ጥብቅ ደንቦች ያሉት ቀለል ያለ ጽሑፍ (plain text) ነው። ኖትፓድ (Notepad) በቀላሉ ሊጽፈው ይችላል። ሰዎች የሚሳሳቱበት መሣሪያውን በመጠቀም ሳይሆን በሰዋስው (syntax) ሕጎች ላይ ነው። አወቃቀሩን በትክክል ከሠሩት ፋይሉን ማስቀመጥ ቀላሉ ክፍል ነው።

የ JSON ፋይል ምንድን ነው?

JSON ማለት የጃቫስክሪፕት ኦብጀክት ኖቴሽን (JavaScript Object Notation) ማሳጠር ነው። መረጃዎችን በቁልፍ-እሴት (key-value) ጥንዶች መልክ በተጠማዘዙ ማሰሪያዎች (curly braces) ውስጥ ያከማቻል፣ በተጨማሪም ተያያዥ ኦብጀክቶችን እና አርሬዎችን (arrays) ይደግፋል። አፕሊኬሽኖች፣ ኤፒአይዎች (APIs) እና የውቅረት (config) ፋይሎች ቀላል እና ሁሉም ዋና ዋና የፕሮግራሚንግ ቋንቋዎች ሊያነቡት ስለሚችሉ ይጠቀሙበታል።

መሰረታዊ የ JSON ፋይል የሚከተለውን ይመስላል፡

{

  "name": "John",

  "age": 28,

  "isActive": true,

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

}

ደረጃ በደረጃ፡ በኖትፓድ ውስጥ የ JSON ፋይል ይፍጠሩ

ደረጃ 1፡ ኖትፓድ (Notepad) ይክፈቱ

በኮምፒተርዎ ላይ ኖትፓድን ይክፈቱ፣ ወይም ከማንኛውም አሳሽ ነፃ የሆነ የኦንላይን ኖትፓድ ይጠቀሙ።

ደረጃ 2፡ በሚከፈት ማሰሪያ ይጀምሩ

እያንዳንዱ የ JSON ፋይል ለኦብጀክት በ { ወይም ለአርሬ (array) በ [ ይጀምራል። አብዛኛዎቹ ፋይሎች የሚጀምሩት በኦብጀክት ነው።

ደረጃ 3፡ ቁልፎችዎን (Keys) እና እሴቶችዎን (Values) ያክሉ

እያንዳንዱን ቁልፍ ორ ድርብ ጥቅስ ምልክቶች (double quotes) ውስጥ ይፃፉ፣ በመቀጠል ኮሎን (:) ያስገቡ፣ ከዚያም እሴቱን ይፃፉ። እያንዳንዱን ጥንድ በኮማ (,) ይለዩዋቸው።

{

  "title": "Sample File",

  "version": 1

}

ደረጃ 4፡ ፋይሉን በትክክል ይዝጉ

እያንዳንዱን የሚከፈት ማሰሪያ ወይም বন্ধን በሚዘጋው ጋር ያዛምዱት። በኦብጀክት ወይም አርሬ ውስጥ ያለው የመጨረሻው የቁልፍ-እሴት ጥንድ ማጠናቀቂያ ላይ ኮማ አያስፈልገውም።

ደረጃ 5፡ በ .json ቅጥያ (extension) ያስቀምጡ

ወደ ፋይል (File) ይሂዱ፣ ከዚያ አስቀምጥ እንደ (Save As) የሚለውን ይጫኑ። "Save as type" ከሚለው ተቆልቋይ ምናሌ ውስጥ All Files የሚለውን ይምረጡ። ፋይሉን በ .json ቅጥያ ይሰይሙት፣ ለምሳሌ data.json። ይህንን ተቆልቋይ ምናሌ ሳይቀይሩ ካስቀመጡት እንደ JSON የማይነበብ የ .txt ፋይል ሆኖ ይቀራል።

ደረጃ 6፡ ከመጠቀምዎ በፊት ያረጋግጡ (Validate)

በስክሪፕት ወይም አፕሊኬሽን ውስጥ ከመጠቀምዎ በፊት ትክክል መሆኑን ለማረጋገጥ ፋይሉን ወደ JSON ኤዲተር ለጥፈው ያረጋግጡ። እዚህ ላይ ፈጣን ምርመራ ማድረግ ከባለ በኋለ መሠረታዊ ስህተቶችን (debugging) ከመፈለግ ያድንዎታል።

ሊታወስ የሚገባቸው የ JSON ሰዋስው ሕጎች

• ድርብ ጥቅስ (Double quotes) ብቻ። ቁልፎች እና የጽሑፍ እሴቶች ነጠላ ጥቅሶችን ሳይሆን ድርብ ጥቅሶችን ይፈልጋሉ።

• የማያበቃ ኮማ የለም። በኦብጀክት ወይም በአርሬ ውስጥ ካለው የመጨረሻው ንጥል በኋላ ምንም ነገር አይከተልም።

• አስተያየቶች (Comments) የሉም። መደበኛ JSON በፋይሉ ውስጥ የ // ወይም /* */ ማስታወሻዎችን አይደግፍም።

• ቦሊየንስ (Booleans) በትንሽ ሆሄ (lowercase) ናቸው። True ወይም FALSE ሳይሆን true እና false ይጠቀሙ።

• ቁጥሮች ጥቅስ አያስፈልጋቸውም። እሴቱ ጽሑፍ እንዲሆን ካልተፈለገ በስተቀር "28" ሳይሆን 28 ብለው ይፃፉ።

የተለመዱ ስህተቶች እና እንዴት ማስወገድ እንደሚቻል።

ችግር፡ በቁልፍ-እሴት ጥንድ መካከል ኮማ መጥፋት። መፍትሄ፡ ከመጨረሻው ጥንድ በስተቀር እያንዳንዱ ጥንድ በኋላ ኮማ ይፈልጋል።

ችግር፡ የማይዛመዱ ማሰሪያዎች ወይም বন্ধኖች። መፍትሄ፡ የ {} እና [] ጥንዶችዎን ይቁጠሩ። ማረጋገጫ (validator) የማይዛመዱበትን ትክክለኛ መስመር ያሳየዎታል።

ችግር፡ በጽሑፍ (string) ውስጥ ያልተጠበቁ ጥቅሶች። መፍትሄ፡ የውስጥ ጥቅሶችን በኋልማርክ (backslash) ያምልጡ, ለምሳሌ \"He said \\\"hello\\\"".

ችግር፡ ጥቅስ የሌለው ቁልፍ። መፍትሄ፡ እንደ id ወይም name ያሉ ቀላል ቁልፎችም ቢሆኑ እያንዳንዱ ቁልፍ በድርብ ጥቅስ ውስጥ መጠቅለል አለበት።

ማጠቃለያ

የ JSON ፋይል ጥብቅ ቅርጸትን የሚከተል ጽሑፍ ብቻ ነው። ቁልፎችዎን እና እሴቶችዎን በድርብ ጥቅሶች ይፃፉ፣ ማሰሪያዎችዎን ያዛምዱ፣ የመጨረሻውን ኮማ ይዝለሉ እና በ .json ቅጥያ ያስቀምጡት። ከመጠቀምዎ በፊት በአንድ ማረጋገጫ (validator) ውስጥ ያስኬዱት፣ እና ጨርሰዋል።