JSON տվյալների կառուցվածքը և վավերացման կարևորությունը
JSON (JavaScript Object Notation) ձևաչափը հանդիսանում է ժամանակակից տվյալների փոխանակման հիմնական միջոցը համակարգչային ծրագրերի և API ծառայությունների միջև: Դրա կառուցվածքը հիմնված է երկու հիմնական տարրերի վրա՝ բանալի-արժեք զույգերից կազմված օբյեկտների և արժեքների կազմված զանգվածների: Չնայած JSON-ը հեշտ է կարդացվում մեքենաների կողմից, մարդու համար անձևաչափ կամ մեկ տողով գրված կոդի ընթերցումը կարող է բարդ լինել:
Տվյալների ճշգրիտ փոխանակման համար չափազանց կարևոր է JSON-ի վավերացումը: Նույնիսկ փոքր սխալը, օրինակ՝ բաց թողնված ստորակետը կամ չակերտը, կարող է խափանել ամբողջ համակարգի աշխատանքը: JSON Ձևաչափիչ գործիքը թույլ է տալիս արագ ստուգել տվյալների կառուցվածքը, հայտնաբերել սխալները և ապահովել դրանց համապատասխանությունը ստանդարտին:
Տվյալների ներմուծման եղանակները և սահմանափակումները
Գործիքն աջակցում է տվյալների ներմուծման մի քանի տարբերակներ: Օգտատերը կարող է տեքստը տեղադրել անմիջապես մուտքագրման դաշտում կամ բացել ֆայլը: Ֆայլերի ներմուծման համար հասանելի է «Բացել ֆայլ» կոճակը, ինչպես նաև ֆայլը քաշելու և գցելու հնարավորությունը՝ «Քաշեք և գցեք.json կամ.txt ֆայլն այստեղ»:
Ֆայլերի բեռնման և մշակման ժամանակ գործում են հետևյալ կանոններն ու սահմանափակումները.
- Ֆայլի տեսակը. Աջակցվում են միայն
.jsonկամ.txtընդլայնմամբ ֆայլերը: Այլ ձևաչափերի դեպքում համակարգը ցուցադրում է «Չաջակցվող ֆայլի տեսակ — ընտրեք.json կամ.txt ֆայլ:» հաղորդագրությունը: - Կոդավորումը. Ֆայլերը պետք է ունենան UTF-8 կոդավորում: Հակառակ դեպքում կցուցադրվի «Այս ֆայլը UTF-8 տեքստ չէ, ուստի այն հնարավոր չէ բացել այստեղ:» նախազգուշացումը:
- Ֆայլի չափի սահմանաչափը. Գոյություն ունի ֆայլի չափի առավելագույն սահմանաչափ: Եթե բեռնվող ֆայլը գերազանցում է այն, օգտատերը կտեսնի «Ֆայլը չափազանց մեծ է — սահմանաչափը
{limit}է:» հաղորդագրությունը: - Մշակման առավելագույն սահմանաչափը. Գործիքի մշակման առավելագույն սահմանաչափը 10 MiB է: Եթե ներմուծված տվյալները գերազանցում են այս չափը, ցուցադրվում է «Մուտքագրված տվյալները գերազանցում են
{limit}-ը, ինչն ավելին է, քան այս գործիքը կարող է մշակել:» հաղորդագրությունը: - Ընթերցման սխալներ. Եթե ֆայլը հնարավոր չէ կարդալ, ցուցադրվում է «Չհաջողվեց կարդալ այս ֆայլը: Փորձեք նորից ընտրել այն:» հաղորդագրությունը:
Հաջող բեռնման դեպքում գործիքը ցուցադրում է «Բեռնվեց {name} ({size}):» կարգավիճակը:
JSON-ի ձևաչափում և մինիմալացում
Գործիքի հիմնական ֆունկցիաներն են ձևաչափումը և մինիմալացումը: Ձևաչափման ժամանակ օգտատերը կարող է ընտրել նախընտրելի նահանջի չափը «Նահանջներ» ընտրացանկից: Գործիքն աջակցում է նաև շարահյուսության ընտրություն «JSON» և «JSONC» տարբերակների միջև «Շարահյուսություն» բաժնում:
«Ձևաչափել» կոճակը սեղմելիս տվյալները դասավորվում են ըստ ընտրված նահանջների՝ ապահովելով առավելագույն ընթեռնելիություն, և ցուցադրվում է «JSON-ը ձևաչափված է:» հաղորդագրությունը: «Մինիմալացնել» կոճակը հեռացնում է բոլոր ավելորդ բացատները, տողադարձերը և նոր տողի նիշերը՝ սեղմելով տվյալները մեկ տողի մեջ, որից հետո հայտնվում է «JSON-ը մինիմալացված է:» հաղորդագրությունը: Խմբագրիչի պարունակությունը մաքրելու համար նախատեսված է «Մաքրել» կոճակը, որը ցուցադրում է «Խմբագրիչը մաքրված է:» կարգավիճակը: Եթե գործողությունը կատարվում է առանց տվյալների առկայության, համակարգը հիշեցնում է՝ «Նախ տեղադրեք կամ բացեք որևէ JSON:»:
Գործիքն ունի նաև օբյեկտների բանալիները դասավորելու հնարավորություն «Դասավորել բանալիները» կոճակի միջոցով: Ինչպես նշված է դրա հուշման մեջ՝ «Ռեկուրսիվ կերպով դասավորում է օբյեկտների բանալիները կոդային կետերի հերթականությամբ։ Զանգվածների հերթականությունը երբեք չի փոխվում։»: Գործողության ավարտին հայտնվում է «Բանալիները դասավորված են — զանգվածների հերթականությունը անփոփոխ է։ Հետարկելու համար սեղմեք Ctrl/Cmd+Z։» հաղորդագրությունը: Գործիքը երաշխավորում է, որ մեծ ամբողջ թվերը պահպանվում են առանց արժեքի կորստի:
Տվյալների վերլուծություն «Կոդ» և «Ծառ» դիտման ռեժիմներում
Օգտատերը կարող է փոխել տվյալների ցուցադրման եղանակը «Դիտում» բաժնում՝ ընտրելով «Կոդ» կամ «Ծառ» տարբերակները: «Կոդ» ռեժիմը ցուցադրում է JSON-ը որպես սովորական տեքստ, մինչդեռ «Ծառ» ռեժիմը թույլ է տալիս ինտերակտիվ կերպով ուսումնասիրել տվյալների կառուցվածքը:
«Ծառ» ռեժիմն ունի հետևյալ առանձնահատկություններն ու սահմանափակումները.
- Վավերության պահանջ. Եթե տեղադրված JSON-ը պարունակում է սխալներ, ծառի տեսքը չի գեներացվի, և կցուցադրվի «Ուղղեք JSON-ը՝ այն ծառի տեսքով դիտելու համար:» հաղորդագրությունը:
- Չափի սահմանափակում. Չափազանց մեծ տվյալների դեպքում ծառի կառուցումը սահմանափակվում է՝ ցուցադրելով «Այս JSON-ը չափազանց մեծ է ծառի տեսքով ցուցադրվելու համար:» կամ «Այս JSON-ն ունի չափազանց շատ արժեքներ՝ ծառի տեսքով ցուցադրվելու համար:» նախազգուշացումները:
- Ծառի ընդարձակում. Ծառի բոլոր հանգույցները միանգամից բացելու համար կիրառվում է «Ընդարձակել բոլորը» կոճակը, իսկ փակելու համար՝ «Ծալել բոլորը»: Մեծ ֆայլերի դեպքում գործում է սահմանափակում՝ «Այս JSON-ը չափազանց մեծ է ամբողջությամբ ընդարձակելու համար — ցուցադրվում են առաջին
{count}տողերը:», որից հետո կարելի է օգտագործել «Ցուցադրել ևս{count}-ը…» կոճակը: - Առանձին հանգույցների կառավարում. Յուրաքանչյուր տարրի համար հասանելի են «Ընդարձակել
{key}-ը» և «Ծալել{key}-ը» կոճակները: Արմատային տարրը կրում է «արմատ» պիտակը:
Ծառի ներսում որոնում կատարելու համար նախատեսված է «Որոնել բանալիներ և արժեքներ» դաշտը: Որոնման արդյունքները նավարկվում են «Նախորդ համընկնումը» և «Հաջորդ համընկնումը» կոճակներով: Համընկնումների քանակը ցուցադրվում է «{current}՝ {total}-ից» կամ սահմանաչափը գերազանցելու դեպքում՝ «{current}՝ {total}+-ից» ձևաչափով: Արդյունք չլինելու դեպքում ցուցադրվում է «Համընկնումներ չկան»:
Տվյալների արտահանում և պատճենում
Մշակված տվյալները կարելի է ներբեռնել համակարգչում «Ներբեռնել» կոճակի միջոցով, որից հետո հայտնվում է «Ներբեռնվեց {name}.» հաղորդագրությունը: Տեքստը պատճենելիս ցուցադրվում է «Պատճենվեց սեղմատախտակին:» կարգավիճակը:
«Ծառ» ռեժիմում յուրաքանչյուր տարրի համար հասանելի է «Պատճենման տարբերակներ {key}-ի համար» մենյուն, որն առաջարկում է տվյալների արտահանման երեք եղանակ: Այս գործիքները թույլ են տալիս հեշտությամբ առանձնացնել և պատճենել տվյալների կոնկրետ հատվածներ:
| Պատճենման տարբերակ | Նկարագրություն |
|---|---|
| Պատճենել արժեքը | Պատճենում է ընտրված հանգույցի բուն արժեքը: |
| Պատճենել JSON Pointer-ը | Ստեղծում և պատճենում է RFC 6901 ստանդարտին համապատասխանող ուղին: |
| Պատճենել JSONPath-ը | Պատճենում է տարրի հասցեն JSONPath հարցումների ձևաչափով: |
Սխալների հայտնաբերում և ինքնաբերաբար ուղղում
Եթե մուտքագրված տվյալները պարունակում են սխալներ, գործիքը ցուցադրում է «Անվավեր JSON» կարգավիճակը և նշում սխալի տեղը՝ «տող {line}, սյունակ {col}» ձևաչափով: Օգտատերը կարող է արագ անցնել խնդրահարույց հատվածին «Անցնել սխալին» կոճակի միջոցով:
Գործիքը հստակորեն տարբերակում է հետևյալ սխալները:
- Տարրերի միջև ստորակետ է բացակայում
- Ավելորդ ստորակետ փակող փակագծից առաջ
- Օբյեկտի բանալիները պետք է լինեն կրկնակի չակերտների մեջ
- Հատկության անունից հետո բացակայում է երկու կետը
- Տողային արժեքի փակող չակերտը բացակայում է
- JSON-ը վաղաժամ ավարտվում է — կարծես կտրված լինի
- Անսպասելի նիշ այնտեղ, որտեղ արժեք պետք է լիներ
- Այս JSON-ի ներդրվածությունը չափազանց խորն է մշակման համար
- Կրկնվող բանալի
{key}— ֆորմատավորումից առաջ հեռացրեք մեկը (ի տարբերություն այլ գործ