Ինչպես ձևաչափել և վավերացնել JSON տվյալները

Ինչի համար է պետք JSON-ի ձևաչափումը

JSON Formatter-ը նախատեսված է JSON տեքստը վերլուծելու, դրա շարահյուսական վավերությունը ստուգելու և ավելի ընթեռնելի տեսքով ներկայացնելու համար։ Այն օգտակար է, երբ տվյալները ստացվել են մեկ երկար տողով, երբ անհրաժեշտ է տեսնել օբյեկտների և զանգվածների կառուցվածքը, կամ երբ ուզում եք նվազեցնել ձևաչափման համար օգտագործվող բացատները։ Գործիքը աշխատում է տեքստային JSON մուտքի հետ, իսկ վավեր JSON-ի Unicode նիշերը կարող են պահպանվել ձևաչափված արդյունքի մեջ։

Ձևաչափման նպատակը տվյալների բովանդակությունը մեկնաբանելը չէ։ Արդյունքը նույն JSON տվյալների կազմակերպված տեքստային ներկայացումն է՝ ընտրված ներդրման կարգավորմամբ։ Այդ պատճառով գործիքը հարմար է տեսողական ստուգման, ձեռքով ընթերցման և շարահյուսական սխալների բացահայտման համար։ Բանալիների դասավորումը կարող է փոխել օբյեկտի դաշտերի հերթականությունը, իսկ կոմպակտ ռեժիմը կարող է հեռացնել սովորական բազմատող դասավորությունը։

Ինչպես ձևաչափել և ստուգել JSON-ը

1. Պատրաստեք JSON տեքստը և տեղադրեք այն մուտքագրման դաշտում։ Այն կարող է գրված լինել մեկ տողով կամ մի քանի տողով։ Մուտքագրեք հենց JSON տեքստ, որպեսզի գործիքը կարողանա այն վերլուծել։ Եթե դաշտը դատարկ է կամ պարունակում է միայն բացատներ, այն ընդունվում է որպես JSON մուտքի բացակայություն. այդ դեպքում ձևաչափված բովանդակություն չի ստեղծվում։

2. Ընտրեք ներդրման չափը, եթե ցանկանում եք փոխել բազմատող արդյունքի տեսքը։ Ներդրումը որոշում է, թե հաջորդ մակարդակի տվյալները որքանով կտեղաշարժվեն դեպի աջ։ Լռելյայն արժեքը 2 է, ուստի առանց լրացուցիչ փոփոխության արդյունքը կստանա երկու նիշանոց ներդրում։ Ավելի փոքր արժեքը կարող է հարմար լինել խիտ ներկայացման համար, իսկ ավելի մեծ արժեքը՝ խոր մակարդակներով օբյեկտներ կարդալու ժամանակ։ Այս կարգավորումը փոխում է տեքստի դասավորությունը, ոչ թե JSON-ի տրամաբանական կառուցվածքը։

3. Անհրաժեշտության դեպքում միացրեք բանալիների դասավորումը։ Այն օբյեկտների բանալիները դասավորում է ձևաչափված արդյունքի մեջ, իսկ լռելյայն այդ ընտրանքը անջատված է։ Օգտագործեք այն, երբ ցանկանում եք համեմատել նման կառուցվածք ունեցող տեքստեր կամ ստանալ օբյեկտների դաշտերի ավելի կանխատեսելի հերթականություն։ Հիշեք, որ այդ ընտրանքը կարող է փոխել դաշտերի տեսանելի հերթականությունը, թեև այստեղ նկարագրված գործողությունը տվյալների արժեքների փոփոխություն չի ենթադրում։

4. Եթե առաջնահերթ է կարճ տեքստը, միացրեք կոմպակտ արդյունքի ընտրանքը։ Այդ ռեժիմում JSON-ը շարադրվում է առանց սովորական ներդրման, և օգտագործվում են կոմպակտ ստորակետ ու երկու կետ բաժանիչներ։ Եթե նպատակն ընթերցանությունն է, թողեք կոմպակտ ռեժիմն անջատված և օգտագործեք բազմատող ձևաչափում։ Ներդրման և կոմպակտ արդյունքի կարգավորումները ընտրեք ըստ այն բանի, թե արդյունքը կարդալու՞ եք, թե փոխանցելու եք որպես կարճ տեքստ։

5. Գործարկեք ձևաչափումը կամ ստուգումը և կարդացեք վերադարձված արդյունքը։ Վավեր JSON-ի դեպքում կստանաք ձևաչափված JSON տեքստ։ Եթե վերլուծությունը ձախողվի, գործողությունը կհաղորդի ձախողման մասին, կպահպանի ներկայացված տեքստը որպես վերադարձվող բովանդակություն և կներառի վերլուծման սխալի մանրամասները։ Այդ մանրամասները օգտագործեք խնդրահարույց հատվածը գտնելու համար, ապա ուղղված տեքստը կրկին մուտքագրեք և գործարկեք գործողությունը։

Ինչ է նշանակում արդյունքը

Վավեր արդյունքը նշանակում է, որ մուտքագրված տեքստը հնարավոր է եղել վերլուծել որպես JSON, և դրա համար ստեղծվել է ձևաչափված տեքստ։ Բազմատող արդյունքը օգնում է տեսնել փակագծերի, զանգվածների և ներդրված օբյեկտների հարաբերությունը։ Ներդրման ընտրված չափը որոշում է տեսողական բացվածքը, իսկ կոմպակտ ռեժիմը նվազեցնում է ձևաչափման բացատներն ու բաժանիչների շուրջ սովորական բացվածքը։

Բանալիների դասավորումը դիտարկեք որպես ներկայացման կարգավորում։ Այն կարող է փոխել օբյեկտի դաշտերի հերթականությունը, ուստի արդյունքը համեմատելիս պետք է հաշվի առնել այդ ընտրանքի միացված լինելը։ Unicode նիշերի պահպանման հնարավորությունը կարևոր է, երբ JSON-ում կան հայերեն անուններ, շեշտադրումներ կամ այլ ոչ լատինատառ արժեքներ։ Այդ նիշերը վավեր JSON-ի դեպքում կարող են մնալ ձևաչափված տեքստում՝ առանց դրանց ընթեռնելիությունը կորցնելու։

Դատարկ կամ միայն բացատներից կազմված մուտքի հաջող ընթացքը այլ նշանակություն ունի։ Այն ցույց է տալիս, որ JSON մուտք չի տրամադրվել, բայց չի նշանակում, որ ստացվել է ձևաչափված JSON արդյունք։ Այդ իրավիճակում լրացրեք մուտքագրման դաշտը վավեր JSON տեքստով և նորից գործարկեք գործողությունը։

Վերլուծման ձախողման դեպքում վերադարձված տեքստի պահպանումը թույլ է տալիս տեսնել ուղարկված բովանդակությունը, իսկ սխալի մանրամասները ուղղություն են տալիս շարահյուսական ստուգմանը։ Ստուգեք համապատասխան փակագծերի զույգերը, ստորակետների տեղադրումը, տողային արժեքների չակերտները և JSON-ի արժեքների գրությունը։ Այս գործիքը հաստատում է JSON-ի վերլուծելիությունն ու ձևաչափում է տեքստը. այն չի ստուգում տվյալների սխեմայի համապատասխանությունը և չի կատարում JSONPath-ով ընտրություն։

Գործնական օրինակ

Ծրագրավորողը ցանկանում է ծառայությունից ստացված կարճ JSON պատասխանը դարձնել ընթեռնելի և ստուգել դրա շարահյուսական վավերությունը։

Ծրագրավորողը մուտքագրման դաշտում տեղադրում է մեկ տողով գրված {"name":"Անի","age":30} JSON օբյեկտը, պահում է լռելյայն 2 նիշանոց ներդրումը և գործարկում ձևաչափումը։ Վերադարձված բովանդակությունը դառնում է բազմատող, իսկ անվան Unicode արժեքը մնում է տեքստում։

Արդյունքը JSON տեքստ է՝ առանձին տողերով, ընտրված ներդրման չափով և, անհրաժեշտության դեպքում, օբյեկտի բանալիները դասավորված հերթականությամբ։ Unicode արժեքը պահպանվում է ձևաչափված տեքստում։

Սահմանափակումներ

• Գործիքը ստուգում է JSON-ի վերլուծելիությունն ու ձևաչափում է տեքստը, սակայն այստեղ նկարագրված հնարավորությունները չեն ներառում տվյալների սխեմայի ստուգում կամ JSONPath-ով ընտրություն։

Հաճախակի սխալներ

• Եթե գործողությունը ձախողվում է, մուտքագրված JSON-ը կարող է ունենալ շարահյուսական սխալ, օրինակ՝ բացակայող ստորակետ, չփակված չակերտ կամ անհամապատասխան փակագիծ։ Ուսումնասիրեք վերադարձված վերլուծման մանրամասները, ուղղեք նշված հատվածը և կրկին գործարկեք գործողությունը։

Հաճախ տրվող հարցեր

Կարո՞ղ եմ ստուգել՝ JSON-ը վավեր է, թե ոչ։

Այո, եթե մուտքագրված տեքստը հնարավոր է վերլուծել որպես JSON։ Այդ դեպքում գործիքը ստեղծում է ձևաչափված JSON տեքստ, իսկ վերլուծման ձախողման դեպքում վերադարձնում է ձախողման տեղեկությունն ու սխալի մանրամասները։

Unicode նիշերը պահպանվո՞ւմ են։

Վավեր JSON-ի դեպքում Unicode նիշերը կարող են պահպանվել ձևաչափված տեքստում։ Սա վերաբերում է նաև հայերեն և այլ ոչ լատինատառ նիշեր պարունակող արժեքներին։

Ի՞նչ է տեղի ունենում դատարկ մուտքի դեպքում։

Եթե մուտքը դատարկ է կամ կազմված է միայն բացատներից, այն ընդունվում է որպես JSON մուտքի բացակայություն, և ձևաչափված բովանդակություն չի ստեղծվում։