GraphQL on võimas päringukeel, mis võimaldab klientidel nõuda serverist ainult neid andmeid, mida nad vajavad. See aitab teil suurendada päringu kiirust, kuna saate kohandada päringuid ainult konkreetsete andmete toomiseks.
GraphQL-il on kahte tüüpi toiminguid: päringud ja mutatsioonid. Vaatamata sarnasustele teenivad need üsna erinevaid eesmärke.
Erinevused GraphQL-i päringute ja mutatsioonide vahel
Päringud ja mutatsioonid on sarnased selle poolest, et kasutate neid päringute tegemiseks GraphQL API-d. Kuid need erinevad süntaksi, täitmisrežiimi ja kasutusviisi poolest.
Päringute ja mutatsioonide süntaks
GraphQL-i päringu põhisüntaks on järgmine:
päring getProduct($id: ID!) {
toode (id: $id) {
nimi
hind
}
}
See kood tähistab järgmist:
- päring on märksõna, mis identifitseerib päringu päringuna.
- getProduct on operatsiooni nimi
- $id on muutuja
- ID! on muutuja tüüp.
Kui te ei vaja muutujaid, jätke need välja ja määrake päring järgmiselt:
päring getProducts {
tooted {
nimi
hind
}
}
Mõnes olukorras võite päringu märksõna ja nime välja jätta, kirjutades GraphQL-i päringu järgmiselt:
tooted {
nimi
hind
}
Kuigi see vorming töötab, on päringu märksõna kasutamine loetavuse jaoks parem.
Mutatsioonide süntaks sarnaneb päringutega, välja arvatud mutatsiooni märksõna kasutamine.
mutatsioon AddNewProduct ($nimi: String!, $hind: number!) {
addProduct (nimi: $name, hind: $price) {
nimi
hind
}
}
Erinevad täitmisrežiimid
Teine erinevus päringu ja mutatsiooni vahel on see, et päringud töötavad paralleelselt, mutatsioonid aga sünkroonselt. Kui käivitate kaks mutatsiooni, käivituvad need järjestikku üksteise järel
Päringute ja mutatsioonide kontrastsed kasutusviisid
Peaksite kasutama päringuid ainult READ-toimingute jaoks. Näiteks kasutage päringut API lõpp-punktist toodete toomisel.
Kasutage operatsioonide CREATE, UPDATE ja DELETE jaoks mutatsioone. Need on sisuliselt toimingud, mis muudavad andmebaasis salvestatud andmeid.
Näiteks kasutage mutatsiooni, kui värskendate kliendi nime tellimuste lõpp-punkti kaudu.
Harjutage päringuid ja mutatsioone õigesti kasutama
GraphQL on võimas päringukeel, mis võimaldab teil taotleda ainult vajalikke andmeid. GraphQL-is saate teha kahte toimingut: päringud ja mutatsioonid.
Need toimingud erinevad süntaksi, täitmise ja kavandatud kasutusviiside poolest. Peaksite kasutama päringuid READ-i toimingute jaoks ja mutatsioone operatsioonide CREATE, UPDATE ja DELETE jaoks.