Taiala ile JSON Schema
Ae tatou te le'i alu i le JSON Schema, e taua le iloa o le eseesega i le va o le JSON ma le JSON Schema.
JSON
O le JSON e fa'apuupuu mo le JavaScript Object Notation, ma o se fa'amaumauga tuto'atasi o le gagana e fa'aoga e API e lafo ai talosaga ma tali. JSON e faigofie e faitau ma tusitusi mo tagata ma masini tutusa. O le JSON o se fa'asologa o tusitusiga e le o noatia i le gagana (Language independent).
JSON Fuafuaga
O le JSON Schema o se meafaigaluega aoga mo le faʻamaonia o faʻamaumauga a le JSON. Ina ia faʻamaonia le fausaga o le JSON, faʻaaoga se faʻavae faʻavae JSON. O lona faʻamoemoe o le faʻamautinoaina o faʻamaumauga a le JSON e talia. E mafai ona fa'auigaina le fa'atonuga mo fa'amaumauga a le matou talosaga i le fa'aogaina o le schema.
E tolu vaega autu i le JSON Schema specification:
JSON Hyper-Schema:
O le JSON Hyper-Schema o se gagana JSON Schema e mafai ona fa'aoga e fa'aigoaina ai pepa a le JSON ma hyperlinks ma fa'atonuga mo le fa'agaioiina ma le suia o punaoa a le JSON i fafo e ala i si'osi'omaga fa'avae e pei o le HTTP. Kiliki iinei e aoao atili e uiga i le JSON Hyper-Schema.
JSON Schema Core:
O se seti o tulafono mo le faʻailoga ma faʻamaonia pepa JSON.
JSON Schema Core:
- Fa'amatala le fa'asologa o fa'amaumauga o lo'o ia te oe i le taimi nei.
- Fa'amaonia fa'amaumauga e mafai ona fa'aoga i su'ega fa'a otometi.
- Faʻamautinoaina le saʻo o faʻamatalaga na tuʻuina atu e tagata faʻatau.
- Tuuina atu faʻamaumauga e mafai ona faitau mo tagata ma masini.
Fa'amaoniga o le JSON Schema:
Fa'amaoniga e fa'avae i luga ole JSON Schema e tu'uina atu tapula'a ile fausaga o fa'amatalaga fa'ata'ita'iga. A maeʻa lena, soʻo se upu autu e leai se faʻamatalaga faʻamatalaga, e pei o fa'amatalaga metadata ma fa'amatalaga fa'aoga, ua fa'aopoopoina i se tulaga fa'ata'ita'i e fa'amalieina fa'agata uma.
Newtonsoft's JSON Schema Validator tool o se meafaigaluega e mafai ona e faʻaogaina saʻo i lau suʻega, e leai se totogi. E mafai ona e faʻaogaina lenei meafaigaluega e suʻe ai le fausaga o lau JSON schema. O lenei itulau o lo'o iai fa'atonuga ma fa'amatalaga e te amata ai. I lena auala, e faigofie ona iloa pe faʻafefea ona faʻaleleia lau fausaga JSON.
E mafai ona matou siakiina a matou JSON Object e faʻaaoga ai le JSON Schema Validation Tool:
E iai a matou faʻamaoniga o tausaga (laʻititi = 20 ma le maualuga = 40) e pei ona faʻaalia i le ata o loʻo i luga. E leai ni mea sese na maua.
Na fa'aalia se mea sese pe a sese le fa'amauina o tausaga.
Le Faia o se JSON Schema
Se'i o tatou va'ai i se fa'ata'ita'iga o le JSON Schema e va'ai i mea o lo'o tatou talanoa ai. O se mea autu a le JSON e fa'amatala ai se fa'amaumauga o oloa e fa'apea:
O lana JSON Schema e mafai ona tusia faʻapea:
O le JSON Schema o se JSON pepa, ma o lena pepa e tatau ona avea ma mea faitino. O upu autu o sui o mea faitino / uiga faʻamaonia e le JSON Schema. "Keywords" i le JSON Schema e faasino i le "ki" vaega o se ki/taua tu'ufa'atasia i totonu o se mea. O le tusiaina o se JSON Schema e aofia ai le faʻatulagaina o se "upu autu" faapitoa i se tau i totonu o se mea mo le tele o vaega.
Se'i o tatou va'ai toto'a i fa'aupuga na fa'aaogaina i la tatou fa'ata'ita'iga:
O le JSON schema o lo'o fa'atatau i ai le puna'oa schema o lo'o tusia i lalo e lenei uiga. O lenei fuafuaga ua tusia e mulimuli i ata faataitai v4 tulaga, e pei ona faamaoti mai e le "$ schema” upu autu. O lea e taofia ai lau fuafuaga mai le toe fo'i i tua i le lomiga o lo'o iai nei, e ono fetaui pe le fetaui ma mea tuai.
O le "Igoa"Ma le"faʻamatalaga” keywords ua na o le faamalamalamaga; latou te le tu'uina atu so'o se tapula'a i fa'amaumauga o lo'o siaki. O upu nei e lua o lo'o fa'amatala ai le fa'amoemoega o le fuafuaga: e fa'amatala ai se oloa.
O le "ituaiga” upu autu e fa'amatala ai le tulaga muamua o le tuaoi o fa'amaumauga a le JSON; e tatau ona avea ma JSON Object. Afai tatou te le setiina ituaiga mo fuafuaga uma, e le aoga le code. O nisi o ituaiga masani o le "numera" "Boolean" "integer" "null" "mea" "faasologa" " manoa".
JSON Schema e lagolagoina e faletusi nei:
gagana | fale faitautusi |
C | WJElement |
Python | jschon |
PHP | Opis Json Schema |
JavaScript | ajv |
Go | gojsonschema |
Kotlin | Medeia-fa'amaonia |
maʻa mū | JSONSchemer |
JSON (Syntax)
Sei o tatou vaʻavaʻai i le faʻasologa autu a JSON. JSON syntax o se vaega o le JavaScript syntax e aofia ai elemene nei:
- Igoa/taua paiga o lo'o fa'aogaina e fa'atusa ai fa'amaumauga.
- O meafaitino o lo'o taofia i fusi fa'a'umi'umi, ma o igoa ta'itasi e ta'ita'iina i se ':' (colon), fa'atasi ai ma pa'aga taua e va'aia e le “,” (koma).
- O fa'atauga e tu'u 'ese'ese i le "," (koma) ma fa'asologa o lo'o taofia i puipui sikuea.
O faʻamaumauga nei e lua o loʻo lagolagoina e JSON:
- Fa'atonu lisi o tau: E mafai ona avea ma se laina, lisi, poʻo se vector.
- Aoina o igoa/taua paga: E lagolagoina e gagana komepiuta ese'ese lenei Fa'atulagaga o Fa'amaumauga.
JSON (mea)
O le JSON schema o se mea JSON o loʻo faʻamatalaina ai le ituaiga ma le fausaga o se mea JSON ese. O se fa'amatalaga mea faitino JavaScript e mafai ona fa'atusalia se mea JSON i si'osi'omaga taimi ta'avale JavaScript. O nisi fa'ata'ita'iga o mea fa'ata'ita'i fa'atino e fa'apea:
Fuafuaga | afitusi |
{} | so'o se tau |
{ituaiga: 'meafaitino'} | se mea JavaScript |
{ituaiga: 'numera'} | se numera JavaScript |
{ituaiga: ' manoa'} | se manoa JavaScript |
Faʻapea:
Faia o se mea fou e gaogao:
var JSON_Obj = {};
Foafoaga Mea Fou:
var JSON_Obj = mea fou ()
JSON (Fa'atusatusaga ma le XML)
JSON ma XML o gagana-tuto'atasi-tuto'atasi tagata-faitauina formats. I fa'aaliga moni o le lalolagi, e mafai uma ona latou fatuina, faitau, ma fa'avasega. Faʻavae i luga o taʻiala o loʻo mulimuli mai, e mafai ona tatou faʻatusatusa JSON ma XML.
Faʻalavelave
Ona o le XML e sili atu le lavelave nai lo JSON, e sili atu le au fai polokalame i le JSON.
Fa'aaogaina o Fa'asologa
XML e faʻaaogaina e faʻaalia ai faʻamaumauga faʻatulagaina; ae ui i lea, XML e le lagolagoina arrays, ae JSON faia.
Faʻamauga
O le JSON o loʻo faʻamatalaina i le faʻaaogaina o le Javascript's eval function. eval toe faʻafoʻi le mea faʻamatalaina pe a faʻaaogaina ma JSON.
faataitaiga:
JSON | XML |
{ "kamupani": Ferrari, “igoa”: “GTS”, “tau”: 404000 } |
Ferrari
GTS
404000
|
JSON Schema Advantages
Ua mamanuina le JSON e fa'afefe i se gagana e mafai ona faitau e tagata ma masini. Ae ui i lea, a aunoa ma se faʻaleleia lelei, e le mafai. O le JSON Schema o loʻo i ai le avanoa e faʻamalamalama atili ai le JSON mo masini ma tagata.
O le fa'aaogaina o le JSON Schema e aveese ai fo'i le mana'oga mo nisi fa'afouga a le tagata o tausia. O le faia o se lisi o tulafono masani HTML ona fa'atinoina lea i le itu o le kalani o se auala masani ae le sa'o i le fausiaina o le itu o tagata o tausia. API polokalame. Ae ui i lea, e le o le fuafuaga sili lea ona o suiga ile itu-aumau e ono mafua ai ona faʻaletonu nisi o galuega.
O le aoga autu o le JSON Schema o lona fetaui ma le tele o gagana polokalame, faʻapea foʻi ma le saʻo ma le tumau o le faʻamaonia.
JSON schema e lagolagoina le tele o su'esu'ega ma faiga faʻaauau, o le mea lea e le manaʻomia ai se taumafaiga tele e faʻaoga uma i latou i le suʻesuʻega. I le taimi o le atinaʻe, e mafaufau le au atinaʻe i le tele o suʻesuʻega, e ui o le JSON ua i ai le gafatia.
O le JSON o le auala sili lea e faʻasoa ai faʻamatalaga o soʻo se tele, e aofia ai leo, vitio, ma isi faʻasalalauga. E mafua lenei mea i le mea moni o loʻo teuina e JSON faʻamaumauga i faʻasologa, lea e faʻafaigofie ai le faʻasalalauina o faʻamatalaga. O se taunuuga, o le JSON o le faila faila sili ona lelei mo API i luga ole laiga ma atinaʻe.
A'o fa'atupula'ia APIs, e talafeagai le fa'apea o le fa'amaoniaina ma le su'ega API o le a fa'ateleina le taua. E moni foi le faʻamoemoe o le JSON e le mafai ona sili atu ona faigofie pe a faʻaauau le taimi. O lona uiga o le i ai o se fuafuaga mo au faʻamatalaga o le a naʻo le faʻateleina o le taua aʻo alu le taimi. Ona o le JSON o le faila faila masani mo le galue ma API, o le JSON Schema o se sui lelei mo i latou o loʻo galulue ma API.
