JSON схемасы боюнча жол
JSON схемасына кирээрден мурун, JSON менен JSON схемасынын ортосундагы айырманы билүү маанилүү.
JSON
JSON JavaScript Object Notation үчүн кыска жана бул API'лер сурамдарды жана жоопторду жөнөтүү үчүн колдонгон тилден көз карандысыз маалымат форматы. JSON адамдар жана машиналар үчүн окууга жана жазууга оңой. JSON тилге байланбаган текстке негизделген формат (тилге көз каранды эмес).
JSON схемасы
JSON схемасы JSON берилиштеринин структурасын текшерүү үчүн пайдалуу курал. JSON түзүмүн көрсөтүү үчүн JSON негизиндеги форматты колдонуңуз. Анын максаты JSON маалыматтары алгылыктуу экенин камсыз кылуу болуп саналат. Колдонмобуздун JSON берилиштери үчүн конвенция схеманы колдонуу менен аныкталышы мүмкүн.
JSON схемасынын спецификациясында үч негизги бөлүм бар:
JSON гипер-схемасы:
JSON Hyper-Schema бул JSON схемасынын тили, ал JSON документтерин гипершилтемелер жана HTTP сыяктуу текстке негизделген чөйрөлөр аркылуу тышкы JSON ресурстарын иштетүү жана өзгөртүү боюнча нускамалар менен белгилөө үчүн колдонулушу мүмкүн. Click бул жерде JSON Hyper-Schema жөнүндө көбүрөөк билүү үчүн.
JSON схемасынын өзөгү:
Бул JSON документтерин белгилөө жана текшерүү эрежелеринин жыйындысы.
JSON схемасынын өзөгү:
- Учурдагы маалымат форматыңызды сүрөттөйт.
- Автоматташтырылган тестирлөөдө колдонула турган маалыматтарды ырастайт.
- Кардарлар тарабынан берилген маалыматтардын тактыгын камсыз кылуу.
- Адамдар жана машиналар үчүн окула турган документтерди камсыз кылат.
JSON схемасын текшерүү:
JSON схемасынын негизинде валидация инстанция маалыматтарынын структурасына чектөөлөрдү киргизет. Андан кийин, ырасталбаган ар кандай ачкыч сөздөр маалымат, мисалы, сүрөттөмө метадайындар жана колдонуу көрсөткүчтөрү бардык жарыяланган чектөөлөргө жооп берген инстанциянын абалына кошулат.
Newtonsoft'тун JSON Schema Validator куралы - бул сиз түздөн-түз браузериңизде бекер колдоно турган курал. Сиз бул куралды JSON схемаңыздын түзүмүн текшерүү үчүн колдоно аласыз. Бул барак сизди баштоо үчүн башкаруу элементтерин жана түшүндүрмөлөрдү камтыйт. Ошентип, JSON түзүмүңүздү кантип жакшыртууну оңой эле көрө аласыз.
JSON Schema Validation Tool аркылуу JSON объектисин текшере алабыз:
Жогорудагы сүрөттө көрсөтүлгөндөй, бизде жашты текшерүү (минималдуу = 20 жана максималдуу = 40) бар. Эч кандай ката табылган жок.
Жашты текшерүү туура эмес киргизилген болсо, анда ката көрсөтүлдү.
JSON схемасын түзүү
Эмне жөнүндө сөз болуп жатканын көрүү үчүн JSON схемасынын мисалын карап көрөлү. Продукт каталогун сүрөттөгөн негизги JSON объектиси төмөнкүдөй:
Анын JSON схемасы төмөнкүчө жазылышы мүмкүн:
JSON схемасы JSON документи жана ал документ объект болушу КЕРЕК. Ачкыч сөздөр JSON схемасы тарабынан аныкталган объект мүчөлөрү/атрибуттары. JSON схемасындагы "ачкыч сөздөр" объекттеги ачкыч/маанилик айкалыштын "ачкыч" бөлүгүн билдирет. JSON схемасын жазуу көпчүлүк учурда белгилүү бир "ачкыч сөздү" объекттин ичиндеги мааниге түшүрүүнү камтыйт.
Келгиле, биздин мисалда колдонгон ачкыч сөздөрдү кененирээк карап көрөлү:
Ресурстун схемасы дал келген JSON схемасы ушул атрибут тарабынан жазылган. Бул схема V4 стандартынын долбоорлоруна ылайык жазылган.$ схема” ачкыч сөзү. Бул сиздин схемаңыздын эски версияга туура келбеген же шайкеш келбеген учурдагы версияга кайра түшүшүнө жол бербейт.
"наам«Жана»баяндоо” ачкыч сөздөр жөн гана түшүндүрмө болуп саналат; алар текшерилип жаткан маалыматтарга эч кандай чектөөлөрдү киргизишпейт. Бул эки ачкыч сөз схеманын максатын сүрөттөйт: ал продуктту сүрөттөйт.
"түрү” ачкыч сөзү биздин JSON берилиштерибиздин биринчи чектик шартын аныктайт; ал JSON объекти болушу керек. Эгерде биз бардык схемалар үчүн типти койбосок, код иштебейт. Кээ бир кеңири таралган түрлөрү "сан" "Буль" "бүтүн" "нөл" "объект" "массив" "сап".
JSON схемасы төмөнкү китепканалар тарабынан колдоого алынат:
тил | китепкана |
C | WJElement |
Python | jschon |
PHP | Opis Json Schema |
JavaScript | ajv |
Go | gojsonschema |
Kotlin | Medeia-validator |
лаал | JSONSchemer |
JSON (синтаксис)
JSON'дун негизги синтаксисин кыскача карап көрөлү. JSON синтаксиси төмөнкү элементтерди камтыган JavaScript синтаксисинин чакан жыйындысы:
- Аты/баа жуптары дайындарды чагылдырган колдонулат.
- Объекттер тармал кашаанын ичинде кармалып, ар бир аталыш ':' (кош чекит) менен башталып, маани жуптары “,” (үтүр) менен ажыратылат.
- Маанилер “,” (үтүр) менен бөлүнөт жана массивдер чарчы кашаанын ичинде кармалат.
Төмөнкү эки маалымат структурасы JSON тарабынан колдоого алынат:
- Нарктардын иреттелген тизмеси: Бул массив, тизме же вектор болушу мүмкүн.
- Аты/баа жуптарынын жыйнагы: Ар кандай компьютер тилдери бул Маалымат структурасын колдойт.
JSON (объект)
JSON схемасы башка JSON объектинин түрүн жана түзүмүн көрсөткөн JSON объекти. JavaScript объектинин туюнтмасы JavaScript иштөө чөйрөлөрүндө JSON объектисин көрсөтө алат. Жарактуу схема объекттеринин кээ бир мисалдары төмөнкүдөй:
схема | дан |
{} | кандайдыр бир баалуулук |
{тип: 'объект'} | JavaScript объекти |
{тип: 'сан'} | JavaScript саны |
{тип: 'сап'} | JavaScript сап |
мисалы:
Бош болгон жаңы объектти жасоо:
var JSON_Obj = {};
Жаңы объект түзүү:
var JSON_Obj = new object()
JSON (XML менен салыштыруу)
JSON жана XML тилден көз карандысыз адам окуй турган форматтар. Чыныгы сценарийлерде алар экөө тең түзүп, окуй жана чечмелей алышат. Төмөнкү критерийлердин негизинде биз JSON менен XMLди салыштырсак болот.
комплекстүүлүк
XML JSONга караганда татаалыраак болгондуктан, программисттер JSONга артыкчылык беришет.
Массивдерди колдонуу
XML структураланган маалыматтарды билдирүү үчүн колдонулат; бирок, XML массивдерди колдобойт, бирок JSON колдойт.
Талдоо
JSON JavaScript'тин баалоо функциясы менен чечмеленет. eval JSON менен колдонулганда сүрөттөлгөн объектти кайтарат.
мисал:
JSON | XML |
{ "компания": Ferrari, "аты-жөнү": "GTS", "баасы": 404000 } |
Ferrari
GTS
404000
|
JSON схемасынын артыкчылыктары
JSON адам жана машина окуй турган тилде бурмалоо үчүн иштелип чыккан. Бирок, кандайдыр бир тыкыр баптоосуз, экөө тең боло албайт. JSON схемасы JSON машиналарга да, адамдарга да түшүнүктүү кылуу артыкчылыгына ээ.
JSON схемасын колдонуу, ошондой эле бир нече кардар тарабынан жаңыртуулардын зарылдыгын жок кылат. Жалпы HTML коддорунун тизмесин түзүп, андан кийин аларды кардар тарабында ишке ашыруу кардар тарабын куруунун типтүү, бирок так эмес ыкмасы болуп саналат. API колдонмолор. Бирок, бул эң сонун стратегия эмес, анткени сервер тарабындагы өзгөрүүлөр айрым функциялардын иштебей калышына алып келиши мүмкүн.
JSON схемасынын негизги артыкчылыгы - анын ар кандай программалоо тилдерине шайкештиги, ошондой эле текшерүүнүн тактыгы жана ырааттуулугу.
JSON схемасы браузерлердин кеңири спектрин колдойт жана иштетүү тутумдары, ошондуктан JSONде жазылган колдонмолор алардын баарын браузерге шайкеш келтирүү үчүн көп күч-аракетти талап кылбайт. Иштеп чыгуу учурунда иштеп чыгуучулар бир нече браузерлерди карашат, бирок JSON буга чейин эле мүмкүнчүлүктөрү бар.
JSON - аудио, видео жана башка медианы кошо алганда, каалаган өлчөмдөгү маалыматтарды бөлүшүүнүн эң натыйжалуу жолу. Бул JSON берилиштерди массивдерде сактаганына байланыштуу, бул маалыматтарды берүүнү жеңилдетет. Натыйжада, JSON онлайн API жана иштеп чыгуу үчүн мыкты файл форматы болуп саналат.
API'лер кеңири таралган сайын, API текшерүү жана тестирлөө барган сайын маанилүү болуп калат деп ойлошубуз логикалык. JSON убакыттын өтүшү менен жөнөкөйлөштүрүлбөйт деп күтүү да реалдуу. Бул сиздин маалыматтарыңыз үчүн схемага ээ болуу убакыттын өтүшү менен ого бетер маанилүү болоорун билдирет. JSON API менен иштөө үчүн стандарттуу файл форматы болгондуктан, JSON схемасы API менен иштегендер үчүн жакшы алмаштыруучу болуп саналат.
