JSONPath on võimas päringukeel JSON-struktuuridest andmete otsimiseks ja filtreerimiseks. JSONPath testija võimaldab sisestada oma JSON-andmed ja JSONPath avaldise, et näha reaalajas, millised väärtused teie päringule vastavad ning kus need algses andmestruktuuris asuvad. Tööriist on loodud API arendajatele, testijatele, andmeinseneridele ja tugipersonalile, kes vajavad kiiret viisi keeruliste päringute kontrollimiseks või konkreetsete andmepunktide asukoha tuvastamiseks.
JSONPath süntaks ja andmete valimine
JSONPath avaldised võimaldavad navigeerida läbi keeruliste ja sügavalt pesastatud JSON-objektide. Päring algab alati juurelemendiga, mida tähistab sümbol $. Sealt edasi saab liikuda alamobjektide juurde, kasutades kas punktnotatsiooni või nurgasulge.
Tööriist toetab kõiki levinud JSONPath mustreid, mis teeb sellest mitmekülgse vahendi erinevate andmevaliku strateegiate testimiseks:
- Otseteed ja alamobjektid: Täpsete teede määramine, näiteks
$.store.book[*].title. - Rekursiivne laskumine (recursive descent): Kasutades mustrit
$..price, otsib süsteem üles kõik võtmed nimegapriceolenemata sellest, kui sügaval struktuuris need asuvad. - Massiivi viilud (array slices): Võimalus valida massiivist konkreetseid vahemikke või elemente.
- Filtrid: Tingimuslikud avaldised nagu
[?@.price < 10], mis tagastavad ainult need objektid, mille omadused vastavad määratud kriteeriumile.
Sisendid ja nende piirangud
Tööriista kasutamiseks on vajalik täita kaks peamist sisendvälja, millele kehtivad järgmised tehnilised piirangud:
- JSON sisend: Tekstiväli, kuhu kopeeritakse analüüsitavad JSON-andmed. Sisendi maksimaalne lubatud maht on 500 000 märki. Kui sisestatud andmed ületavad selle piiri, kuvatakse veateade "See JSON on siin testimiseks liiga suur. Proovige väiksemat näidist.".
- JSONPath avaldis: Tekstiväli, kuhu sisestatakse testitav päring. Avaldise maksimaalne lubatud pikkus on 4000 märki. Piirangu ületamisel kuvatakse teade "See JSONPath avaldis on siin testimiseks liiga pikk.".
Nupp "Tühjenda" võimaldab mõlemad väljad kiiresti puhastada, misjärel kuvatakse olekuteade "Tühjendatud.".
Väljundid ja tulemuste kuvamine
Pärast andmete ja avaldise sisestamist kuvab tööriist jaotises "Kattuvad väärtused" leitud vasteid. Iga tulemuse juures on välja toodud selle täpne asukohatee algses JSON-struktuuris, mis võimaldab väärtusi kopeerida nii, et nende kontekst ja päritolu säilivad.
Tulemuste kuvamisel kehtivad järgmised reeglid:
- Tööriist kuvab maksimaalselt 200 tulemust.
- Kui vasteid on rohkem kui 200, kuvatakse koguarvuna "Vasteid: 200+" ja lisatakse märkus "Kuvatakse esimesed
{max}vastet.". - Iga üksiku vaste detailsemaks vaatlemiseks on mõeldud vaade pealkirjaga "Üksikasjad".
- Kui ühtegi vastet ei leita, kuvatakse teade "Vasteid ei leitud.".
Vigade käsitlemine ja jõudluspiirangud
JSON-andmete ja päringute valideerimine on vigade vältimiseks hädavajalik. Tööriist kontrollib reaalajas nii andmete struktuuri kui ka avaldise korrektsust ning reageerib järgmiselt:
- Vigane JSON: Kui sisestatud andmed ei vasta JSON-vormingule, kuvatakse veateade "See JSON ei ole korrektne.".
- Vigane JSONPath: Kui päringu süntaks on vale, kuvatakse teade "See JSONPath avaldis ei ole korrektne.".
- Hindamise tõrge: Kui avaldist ei ole võimalik sisestatud andmete põhjal käivitada, kuvatakse teade "Seda JSONPathi ei saanud hinnata.".
- Ajalõpp: Keerulised rekursiivsed päringud või mahukad andmevektorid võivad süsteemi koormata. Tööriistal on lühike käitusaeg, mille ületamisel hindamine peatatakse ja kuvatakse hoiatus "Selle JSONPathi käitamine võttis liiga kaua aega. Täpsustage avaldist või kasutage väiksemat näidist.".
Privaatsus ja andmetöötlus
Andmete turvalisus on tagatud kohaliku töötlusega. Teie sisestatud JSON-andmeid ja JSONPath avaldisi testitakse otse teie veebibrauseris. Midagi ei laadita BroBroGo serverisse.
Korduma kippuvad küsimused
Millist JSONPath süntaksit saan kasutada?
Saate kasutada levinud JSONPath mustreid nagu $.store.book[*].title, rekursiivset otsingut kujul $..price, filtreid nagu [?@.price < 10] ja massiivi viile (slices).
Miks kuvatakse iga tulemuse juures selle asukohatee?
Tee näitab, kust kohast väärtus algses JSON-is pärineb, et saaksite vaste kopeerida ilma selle asukohta kaotamata.
Miks võib päring aeguda?
Väga laiad rekursiivsed päringud või hiiglaslikud andmemahtud võivad võtta liiga kaua aega. Testija peatab need lühikese aja möödudes, et saaksite avaldist täpsustada või kasutada väiksemat näidist.