ኣብ notepad ፋይል .JSON ከመይ ገይርካ ክትፈጥር ትኽእል

JSON ማለት ብጽኑዕ ደርቢ ዝምርሐ ቀሊል ጽሑፍ እዩ። Notepad ብግቡእ ክጽሕፎ ይኽእል እዩ። ሰባት ዝጋገዩሉ መሳርሒ ብዘይምጽሓፍ ዘይኮነስ፡ ሲንታክስ (syntax) ብዘይምፍላጥ እዩ። ቅርጺ ብግቡእ ሓዝ፣ ፋይል ምዕቃብ ድማ እቲ ቀሊል ክፋል እዩ።

ፋይል JSON ማለት እንታይ ማለት እዩ?

JSON ማለት JavaScript Object Notation ማለት እዩ። ዳታ ብቁልፊ-ዋጋ (key-value) መልክዕ ኣብ ውሽጢ ጠምጠምቲ (curly braces) ይሕዝ፣ ነዚ ድማ ኣብ ውሽጢ ሕድሕዶም ዝተተኽሉ ኦብጀክታትን ኣርራይን (arrays) ይድግፍ። መተግበሪታት፣ ኤፒኣይ (APIs) ከምኡውን ናይ ምቅንጻር (config) ፋይላት ፈفيفቲ ስለ ዝኾኑን ኩሎም ቀንዲ ፊደላት ከንብብዎ ስለ ዝኽእሉን ይጥቀምሉ እዮም።

መሰረታዊ ፋይል JSON ከምዚ ይመስል:

{

  "name": "John",

  "age": 28,

  "isActive": true,

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

}

ብእግረ-መገዲ: ኣብ Notepad ፋይል JSON ምፍጣር

ስትብ 1: Notepad ክፈት

ኣብ ኮምፒተርካ Notepad ክፈት፣ ወይ ድማ ካብ ዝኾነ መርበብ ሓበሬታ (browser) ነጻ ዝኾነ ኦንላይን ኖትፓድ (online notepad) ተጠቀም።

ስትብ 2: ብመኽፈቲ ጠምጠምቲ ጀምር

ነፍሲ ወከፍ ፋይል JSON ንኦብጀክት ብ { ወይ ድማ ንኣርራይ ብ [ ይጅምር። መብዛሕትኡ ፋይላት ብኦብጀክት እዩ ዝጅምር።

ስትብ 3: ቁልፍታትን ዋጋታትን (keys and values) ወስኽ

ነፍሲ ወከፍ ቁልፊ ኣብ ውሽጢ ድርብ ምልክት ጥቕስታ (double quotes) ጽሓፍ፣ ስዒቡ ድማ ኮሎን (colon)፣ ቀጺሉውን እቲ ዋጋ ኣቐመጥ። ነፍሲ ወከፍ ጽምዲ ብኮማ (comma) ኣፋልዮም።

{

  "title": "Sample File",

  "version": 1

}

ስትብ 4: ፋይል ብግቡእ ዕጸዎ

ነፍሲ ወከፍ መኽፈቲ ጠምጠምቲ ወይ ድማ መትሓዚ ብዝሰማማዕ መዕጸዊ ኣዛምዶ። እቲ ናይ መወዳእታ ቁልፊ-ዋጋ ጽምዲ ኣብ ውሽጢ ኦብጀክት ወይ ኣርራይ ድሕሪኡ ኮማ የብሉን።

ስትብ 5: ብምርካብ .json ዕቀቦ

ናብ File ኪድ፣ ቀጺሉ Save As ንካ። ኣብቲ "Save as type" ዝብል መምረጺ All Files ዝብል ሕረ። ነቲ ፋይል ብ .json ኤክስተንሽን ስመዮ፣ ንኣብነት data.json። ነዚ መምረጺ እዚ ከይቀየርካ እንተ ኣዕቂብካዮ ግና ከም .txt ፋይል ኮይኑ ክተርፍ እዩ እሞ ከም JSON ክንበብ አይክእልን እዩ።

ስትብ 6: ቅድሚ ምጥቃምካ ኣረጋግጽ (Validate)

ኣብ ስክሪፕት ወይ መተግበሪ ቅድሚ ምጥቃምካ ትኽክለኛነቱ ንምርግጋጽ ነቲ ፋይል ናብ JSON ኣስተካካሊ (editor) ለጥፎ። ኣብዚ ቅልጡፍ ምርግጋጽ ምግባር ድሒርካ ጌጋታት ንምእራም (debugging) ካብ ዝግበር ጻዕሪ የድሕነካ።

ክשደሱ ዘለዎም ሕግታት ሲንታክስ JSON

• ድርብ ጥቕስታ (Double quotes) ጥራይ። ቁልፍታትን ዋጋታት ጽሑፍን ንጽል ጥቕስታ ዘይኮነስ ድርብ ጥቕስታ የድልይዎም።

• ድሕሪ መወዳእታ ኮማ የብሉን። ኣብ መወዳእታ ናይቲ ዝሓለፈ ንብረት ኣብ ውሽጢ ኦብጀክት ወይ ኣርራይ ዝኾነ ነገር ክስዕብ የብሉም።

• ርእይቶታት (Comments) የለዉን። ስታንዳርድ JSON ኣብ ውሽጢ ፋይል ን // ወይ /* */ መዘኻኸሪታት ኣይድግፍን እዩ።

• ቦልያን (Booleans) ብንኡሳን ፊደላት (lowercase) ይጽሓፉ። true ከምኡውን false ተጠቀም፣ True ወይ FALSE ኣይትጥቀም።

• ቁጽሪ ጥቕስታ ኣየድልዮምን እዩ። እቲ ዋጋ ከም ጽሑፍ ክኸውን እንተዘይኮይኑ፣ "28" ኢልካ ዘይኮነስ 28 ኢልካ ጽሓፍ።

ልሙዳት ጌጋታትን ከመይ ገይርካ ክትሓልፎም ትኽእልን

ጸገም: ኣብ መንጎ ቁልፊ-ዋጋ ጽምዲ ኮማ ስኢኑ። መፍትሒ: ካብቲ ናይ መወዳእታ ወጻኢ ነፍሲ ወከፍ ጽምዲ ድሕሪኡ ኮማ ክህልዎ ይግባእ።

ጸገም: ዘይተሰማማዕ መትሓዝቲ ወይ ጠምጠምቲ። መፍትሒ: ነቶም {} ከምኡውን [] ጥምርቲ ቁጸሮም። ቫሊዳተር (validator) ኣብቲ ዘይሰማማዕሉ ትኽክለኛ መስመር የርእየካ እዩ።

ጸገም: ኣብ ውሽጢ ጽሑፍ ዘይተሓለዉ ጥቕስታ (Unescaped quotes)። መፍትሒ: ነቶም ናይ ውሽጢ ጥቕስታታት ብባክስላሽ (backslash) ሕለፎም፣ ንኣብነት \"He said \\\"hello\\\"\"።

ጸገም: ጥቕስታ ዘይብሉ ቁልፊ። መፍትሒ: ነፍሲ ወከፍ ቁልፊ፡ ከም id ወይ name ዝበሉ ቀለልቲ እኳ እንተኾኑ፡ ብድርብ ጥቕስታ ክባለሉ ኣለዎም።

መደምደምታ

ሓደ JSON ፋይል ማለት ንጽኑዕ ቅርጺ ዝስዕብ ቀሊል ጽሑፍ ጥራይ እዩ። ቁልፍታትካን ዋጋታትካን ብድርብ ጥቕስታ ጽሓፍ፣ መትሓዝትኻ ኣዛምድ፣ ነቲ ናይ መወዳእታ ኮማ ሕደጎ፣ ከምኡውን ብ .json ኤክስተንሽን ዕቀቦ። ቅድሚ ምጥቃምካ ሓንሳብ ብቫሊዳተር ኣካንዲዎ፣ ንስኻ ድማ ድሉው ኢኻ።