Водич за ЈСОН шему
Пре него што пређемо на ЈСОН шему, важно је знати разлику између ЈСОН и ЈСОН шеме.
ЈСОН
ЈСОН је скраћеница од ЈаваСцрипт Објецт Нотатион, и то је формат података независан од језика који АПИ-ји користе за слање захтева и одговора. ЈСОН је једноставан за читање и писање и за људе и за машине. ЈСОН је формат заснован на тексту који није везан за језик (независан од језика).
ЈСОН шема
ЈСОН шема је користан алат за верификацију ЈСОН структуре података. Да бисте навели структуру ЈСОН-а, користите формат заснован на ЈСОН-у. Његова сврха је да осигура да су ЈСОН подаци прихватљиви. Конвенција за ЈСОН податке наше апликације може се дефинисати помоћу шеме.
Постоје три главна одељка спецификације ЈСОН шеме:
ЈСОН хипер-шема:
ЈСОН Хипер-Сцхема је језик ЈСОН шеме који се може користити за означавање ЈСОН докумената хиперлинковима и упутствима за обраду и промену спољних ЈСОН ресурса путем окружења заснованих на тексту као што је ХТТП. Кликните ovde да бисте сазнали више о ЈСОН хипер-шеми.
Језгро ЈСОН шеме:
То је скуп правила за означавање и валидацију ЈСОН докумената.
Језгро ЈСОН шеме:
- Описује формат података који тренутно имате.
- Потврђује податке који се могу користити у аутоматском тестирању.
- Обезбеђивање тачности података које дају клијенти.
- Пружа читљиву документацију и за људе и за машине.
Провера ЈСОН шеме:
Валидација заснована на ЈСОН шеми намеће ограничења на структуру података инстанце. Након тога, све кључне речи које немају тврдњу информација, као што су дескриптивни метаподаци и индикације употребе, додају се позицији инстанце која испуњава сва декларисана ограничења.
Невтонсофтова алатка за валидацију ЈСОН шеме је алатка коју можете бесплатно користити директно у свом претраживачу. Можете користити овај алат за тестирање структуре ваше ЈСОН шеме. Ова страница садржи контроле и објашњења за почетак. На тај начин је лако видети како да побољшате своју ЈСОН структуру.
Можемо да проверимо наш ЈСОН објекат користећи алатку за проверу ЈСОН шеме:
Имамо валидацију старости (минимум = 20 и максимум = 40) као што је приказано на слици изнад. Нису пронађене грешке.
Приказује грешку ако је провера старости погрешно унета.
Креирање ЈСОН шеме
Хајде да погледамо пример ЈСОН шеме да видимо о чему говоримо. Основни ЈСОН објекат који описује каталог производа је следећи:
Његова ЈСОН шема се може написати на следећи начин:
ЈСОН шема је ЈСОН документ и тај документ МОРА да буде објекат. Кључне речи су чланови/атрибути објекта специфицирани ЈСОН шемом. „Кључне речи“ у ЈСОН шеми односе се на део „кључ“ комбинације кључ/вредност у објекту. Писање ЈСОН шеме углавном укључује мапирање одређене „кључне речи“ у вредност унутар објекта.
Хајде да ближе погледамо кључне речи које смо користили у нашем примеру:
ЈСОН шема са којом је усклађена шема ресурса је записана овим атрибутом. Ова шема је написана у складу са нацртима в4 стандарда, како је наведено у „$ сцхема” кључна реч. Ово спречава да се ваша шема врати на тренутну верзију, која може или не мора бити компатибилна са старијом.
"наслов"И"опис” кључне речи су само објашњење; не намећу никаква ограничења за податке који се проверавају. Ове две кључне речи описују сврху шеме: она описује производ.
"тип” кључна реч дефинише први гранични услов наших ЈСОН података; мора бити ЈСОН објекат. Ако не поставимо тип за све шеме, код не би функционисао. Неки уобичајени типови су „број” „Боолеан” „цео број” „нулл” „објекат” „низ” „стринг”.
ЈСОН шему подржавају следеће библиотеке:
Језик | Library (Библиотека) |
C | ВЈЕлемент |
Питон | јсцхон |
PHP | Опис Јсон шеме |
JavaScript | ајв |
Go | гојсонсцхема |
Котлин | Медеја-валидатор |
рубин | ЈСОНСцхемер |
ЈСОН (синтакса)
Хајде да укратко погледамо основну синтаксу ЈСОН-а. ЈСОН синтакса је подскуп ЈаваСцрипт синтаксе која укључује следеће елементе:
- Користе се парови име/вредност који представљају податке.
- Објекти се држе у витичастим заградама, а свако име води знаком ':' (двотачком), са паровима вредности раздвојеним са "," (зарезом).
- Вредности су одвојене са „,“ (зарезом), а низови се држе у угластим заградама.
ЈСОН подржава следеће две структуре података:
- Наређена листа вредности: То може бити низ, листа или вектор.
- Колекција парова име/вредност: Различити рачунарски језици подржавају ову структуру података.
ЈСОН (објекат)
ЈСОН шема је ЈСОН објекат који описује тип и структуру другог ЈСОН објекта. Израз ЈаваСцрипт објекта може представљати ЈСОН објекат у ЈаваСцрипт окружењима за извршавање. Неки примери валидних објеката шеме су следећи:
Схема | Шибице |
{} | било које вредности |
{ типе: 'објецт' } | ЈаваСцрипт објекат |
{ тип: 'број' } | ЈаваСцрипт број |
{ типе: 'стринг'} | ЈаваСцрипт стринг |
На пример:
Прављење новог објекта који је празан:
вар ЈСОН_Обј = {};
Креирање новог објекта:
вар ЈСОН_Обј = нови објекат()
ЈСОН (поређење са КСМЛ-ом)
ЈСОН и КСМЛ су формати који су читљиви људима независни од језика. У сценаријима из стварног света, они могу и да креирају, читају и декодирају. На основу следећих критеријума, можемо да упоредимо ЈСОН са КСМЛ-ом.
Сложеност
Пошто је КСМЛ сложенији од ЈСОН-а, програмери преферирају ЈСОН.
Употреба низова
КСМЛ се користи за изражавање структурираних података; међутим, КСМЛ не подржава низове, али ЈСОН подржава.
Разгледавање
ЈСОН се тумачи помоћу ЈаваСцрипт функције евал. евал враћа описани објекат када се користи са ЈСОН-ом.
primer:
ЈСОН | КСМЛ |
{ „компанија“: Феррари, „име“: „ГТС“, “цена”: 404000 } |
Феррари
ГТС
404000
|
Предности ЈСОН шеме
ЈСОН је дизајниран да скретање на људском и машински читљивом језику. Међутим, без финог подешавања, не може бити ни једно ни друго. ЈСОН шема има предност што ЈСОН чини разумљивијим и за машине и за људе.
Коришћење ЈСОН шеме такође уклања потребу за неколико ажурирања на страни клијента. Прављење листе уобичајених ХТМЛ кодова и њихова примена на страни клијента је типичан, али нетачан метод за конструисање на страни клијента. АПИ за апликације. Међутим, ово није најбоља стратегија јер промене на страни сервера могу довести до квара одређених функција.
Главна предност ЈСОН шеме је њена компатибилност са различитим програмским језицима, као и тачност и доследност валидације.
ЈСОН шема подржава широк спектар претраживача и оперативни системи, стога апликације написане у ЈСОН-у не захтевају много труда да би све биле компатибилне са прегледачем. Током развоја, програмери узимају у обзир неколико претраживача, иако ЈСОН већ има могућности.
ЈСОН је најефикаснији начин за дељење података било које величине, укључујући аудио, видео и друге медије. То је због чињенице да ЈСОН чува податке у низовима, што олакшава пренос података. Као резултат тога, ЈСОН је најбољи формат датотеке за онлајн АПИ-је и развој.
Како АПИ-ји постају све чешћи, логично је претпоставити да ће валидација и тестирање АПИ-ја постати све важнији. Такође је реално очекивати да ЈСОН вероватно неће постати много једноставнији како време одмиче. Ово имплицира да ће поседовање шеме за ваше податке само постати критичније како време одмиче. Пошто је ЈСОН стандардни формат датотеке за рад са АПИ-јима, ЈСОН шема је добра замена за оне који раде са АПИ-јима.
