JSON არის მკაცრი წესების მქონე ჩვეულებრივი ტექსტი. Notepad-ს მისი დაწერა მარტივად შეუძლია. ის, რაშიც ხალხი ცდება, არის სინტაქსი და არა ინსტრუმენტი. სწორად განსაზღვრეთ სტრუქტურა და ფაილის შენახვა უკვე ყველაზე მარტივი ნაწილია.
როგორ შევქმნათ .JSON ფაილი Notepad-ში
რა არის JSON ფაილი?
JSON ნიშნავს JavaScript Object Notation-ს. ის ინახავს მონაცემებს გასაღებ-მნიშვნელობის (key-value) წყვილების სახით ფიგურულ ფრჩხილებში, ჩადგმული ობიექტებისა და მასივების მხარდაჭერით. აპლიკაციები, API-ები და კონფიგურაციის ფაილები მას იმიტომ იყენებენ, რომ ის მსუბუქია და ყველა ძირითად ენას შეუძლია მისი წაკითხვა.
ძირითადი JSON ფაილი ასე გამოიყურება:
{ "name": "John", "age": 28, "isActive": true, "skills": ["writing", "editing"]}ნაბიჯ-ნაბიჯ: შექმენით JSON ფაილი Notepad-ში
ნაბიჯი 1: გახსენით Notepad
გახსენით Notepad თქვენს კომპიუტერში, ან გამოიყენეთ უფასო ონლაინ ნოუთფედი ნებისმიერი ბრაუზერიდან.
ნაბიჯი 2: დაიწყეთ გახსნილი ფრჩხილით
ყველა JSON ფაილი იწყება {-ით ობიექტისთვის ან [-ით მასივისთვის. ფაილების უმეტესობა ობიექტით იწყება.
ნაბიჯი 3: დაამატეთ თქვენი გასაღებები და მნიშვნელობები
დაწერეთ თითოეული გასაღები ბრჭყალებში, რომელსაც მოსდევს ორწერტილი, შემდეგ კი მნიშვნელობა. თითოეული წყვილი ერთმანეთისგან მძიმით გამოჰყავით.
{ "title": "Sample File", "version": 1}ნაბიჯი 4: სწორად დახურეთ ფაილი
თითოეულ გახსნილ ფრჩხილს დაუკავშირეთ დამხური ფრჩხილი. ობიექტის ან მასივის ბოლო გასაღებ-მნიშვნელობის წყვილს ბოლოში მძიმე არ სჭირდება.
ნაბიჯი 5: შეინახეთ .json გაფართოებით
გადადით File-ში, შემდეგ Save As. აირჩიეთ All Files მენიუდან "Save as type". დაარქვით ფაილს .json გაფართოება, მაგალითად data.json. ამ მენიუს შეცვლის გარეშე შენახვისას მიიღებთ .txt ფაილს, რომელიც JSON-ის სახით ვერ წაიკითხება.
ნაბიჯი 6: შეამოწმეთ გამოყენებამდე
ჩასვით ფაილი JSON რედაქტორში, რომ დარწმუნდეთ მის სისწორეში, სანამ სკრიპტში ან აპლიკაციაში გამოიყენებთ. აქ სწრაფი შემოწმება დაგაზოგინებთ დროს შემდგომი დებაგინგისგან.
JSON სინტაქსის წესები, რომლებიც უნდა გახსოვდეთ
მხოლოდ ორმაგი ბრჭყალები. გასაღებებს და სტრიქონულ მნიშვნელობებს სჭირდება ორმაგი ბრჭყალები და არა ერთმაგი.
არანაირი ბოლო მძიმეები. ობიექტის ან მასივის ბოლო ელემენტის შემდეგ არაფერი იწერება.
არანაირი კომენტარები. სტანდარტული JSON არ უჭერს მხარს // ან /* */ შენიშვნებს ფაილის შიგნით.
ბულეინის ტიპები (Booleans) პატარა ასოებით იწერება. გამოიყენეთ true და false, და არა True ან FALSE.
ციფრებს ბრჭყალები არ სჭირდება. დაწერეთ 28 და არა "28", გარდა იმ შემთხვევისა, როდესაც მნიშვნელობა განკუთვნილია ტექსტისთვის.
ხშირი შეცდომები და მათი თავიდან აცილების გზები
პრობლემა: გასაღებ-მნიშვნელობის წყვილებს შორის გამოტოვებული მძიმე. გამოსავალი: ბოლოს გარდა, თითოეულ წყვილს ბოლოში მძიმე სჭირდება.
პრობლემა: არაბალანსირებული ფრჩხილები. გამოსავალი: დათვალეთ თქვენი {} და [] წყვილები. ვალიდატორი მიგითითებთ ზუსტ ხაზზე, სადაც ისინი არ ემთხვევა ერთმანეთს.
პრობლემა: სტრიქონში გაუბრჭყალებელი შიდა ბრჭყალები. გამოსავალი: შიდა ბრჭყალებს წინ დაუწერეთ უკანა დახრილი ხაზი (backslash), მაგალითად \"He said \\\"hello\\\"".
პრობლემა: გასაღები ბრჭყალების გარეშე. გამოსავალი: თითოეული გასაღები უნდა იყოს ჩასმული ორმაგი ბრჭყალებში, თუნდაც ისეთი მარტივი, როგორიცაა id ან name.
დასკვნა
JSON ფაილი არის უბრალოდ ტექსტი, რომელიც მკაცრ ფორმატს მიჰყვება. დაწერეთ თქვენი გასაღებები და მნიშვნელობები ორმაგი ბრჭყალებით, დააკავშირეთ ფრჩხილები, გამოტოვეთ ბოლო მძიმე და შეინახეთ .json გაფართოებით. გამოყენებამდე ერთხელ გაატარეთ ვალიდატორში და მზად ხართ.