Ինչպես ստուգել JSON տվյալները JSON Schema-ով

Ինչի համար է պետք ստուգիչը

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

Աշխատելու համար անհրաժեշտ են երկու առանձին տեքստային մուտքեր՝ JSON տվյալները և JSON Schema-ն։ Երկու դաշտերն էլ ընտրովի են և դատարկ լինելու դեպքում դիտարկվում են որպես դատարկ տեքստ։ Ստուգման արդյունքը ցույց է տալիս տվյալների վավերականությունը և, երբ առկա է խնդիր, տալիս է համապատասխան մանրամասներ։

Ինչպես կատարել ստուգումը

1. Պատրաստեք JSON տվյալների տեքստը։ Այն կարող է պարունակել օբյեկտ, զանգված կամ այլ JSON արժեք, սակայն պետք է ճիշտ վերլուծվող JSON լինի։

2. Առանձին դաշտում տեղադրեք JSON Schema փաստաթուղթը։ Սխեմայում կարող եք նկարագրել այնպիսի ստուգումներ, ինչպիսիք են string, number, integer, boolean, object և array տիպերը։ Ներկառուցված արժեքների համար տիպային ստուգումները կատարվում են նաև խորացված մակարդակներում։

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

4. Եթե տեքստերից մեկը ճիշտ JSON չէ, ուղղեք վերլուծության սխալը և կրկին գործարկեք ստուգումը։ Միայն դրանից հետո է իմաստավոր ստուգել սխեմային համապատասխանությունը։

5. Անհրաժեշտության դեպքում հստակեցրեք սխեմայի սահմանափակումները։ Օրինակ՝ կարող եք նշել պարտադիր հատկություններ, արգելել չհայտարարված հատկությունները, սահմանել զանգվածի տարրերի սխեմա, ինչպես նաև կիրառել enum, թվային նվազագույն կամ առավելագույն արժեք և տողի նվազագույն կամ առավելագույն երկարություն։

Ինչպես կարդալ արդյունքը

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

«Ոչ վավեր» արդյունքը կարող է նշանակել, որ JSON կամ սխեմա չի տրամադրվել, տեքստը չի վերլուծվել որպես JSON, կամ տվյալները չեն անցել սահմանված կանոնները։ Մանրամասները կարդալիս ստուգեք խնդրի մակարդակը. օրինակ՝ կարող է բացակայել պարտադիր հատկություն, արժեքը ունենալ սխալ տիպ, թիվը չբավարարել նվազագույն պայմանին կամ օբյեկտը պարունակել չհայտարարված հատկություն, երբ դա արգելված է։

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

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

Պատվերի քանակը պետք է ստուգվի այնպես, որ բացասական ամբողջ թիվը չհամապատասխանի սահմանված նվազագույն արժեքին։

Պատվերի JSON-ում quantity հատկությանը տվեք բացասական ամբողջ թիվ, իսկ JSON Schema-ում սահմանեք դրա ամբողջ թվի տիպը և նվազագույն արժեքը, ապա գործարկեք ստուգումը։

Արդյունքը պետք է ցույց տա ոչ վավեր տվյալների վիճակ և նկարագրի նվազագույն արժեքի կանոնի խախտումը։

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

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

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

• Պատճառը. JSON-ի կամ սխեմայի դաշտը դատարկ է, պարունակում է միայն բացատներ կամ վերլուծվող JSON չէ։ Ուղղում. տեղադրեք երկու ամբողջական JSON տեքստերը և ստուգեք փակագծերի, չակերտների ու ստորակետերի ճիշտ դասավորությունը։

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

Կարո՞ղ է գործողությունը հաջող լինել, երբ JSON-ը վավեր չէ։

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

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

Եթե JSON տվյալների կամ JSON Schema-ի դաշտը դատարկ է կամ պարունակում է միայն բացատներ, արդյունքը ոչ վավեր է, և նշվում է բացակայող մուտքը։

Ի՞նչ անել, եթե ստացվում է վերլուծության սխալ։

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

Ո՞ր կանոնները կարող են ազդել վավերականության վրա։

Ստուգեք պարտադիր հատկությունները, արժեքների տիպերը, զանգվածի տարրերի կանոնները, թվային սահմանները և տողերի երկարության սահմանները։ Օբյեկտի համար կարող է նաև արգելված լինել չհայտարարված հատկությունների օգտագործումը։