GraphQLtyypeissä

GraphQL-tyypit ovat GraphQL-skeeman perusta ja määrittelevät, millaista dataa kyselyillä voidaan hakea sekä millaisia syötteitä mutaatioille annetaan. Tyyppijärjestelmä on vahva ja mahdollistaa skeeman validoinnin sekä hyvän työkalutuen introspektiolle ja kehityksen aikaiselle auttamiselle.

GraphQL-tyyppejä voidaan luokitella useisiin kategorioihin. Skalaarityypit kattavat perusarvot kuten Int, Float, String, Boolean ja ID, sekä mahdollisuuden määritellä mukautettuja skalaarityyppejä. Objektityypit kuvaavat konkreettisia dataobjekteja ja niiden kenttiä; kenttien tyypit voivat olla toisia tyyppejä tai listoja. Rajapinnat (interface) määrittelevät yhteiset kentät, joita useat objektityypit voivat toteuttaa, mahdollistaen polymorfisen kyselyn. Yhdistetyypit (union) sallivat palauttaa useamman kuin yhden objektityypin. Enum-tyypit ovat kiinteä arvojoukko, kuten status-tyypit, ja syöte-objektityypit (input objects) käytetään mutaatioiden ja muiden syötteiden kuvaamiseen.

Kenttien tyypit voivat olla ei-null-tyyppejä (esim. ID!) sekä listat (esim. [Post]). Skeema tukee introspectionia, joten asiakkaat voivat kysyä skeeman rakennetta sekä sen käytettävissä olevia kenttiä ja arvoja. Allokoinnin ja kyselyjen validointi perustuvat skeemaan, ja vanhentuneille arvoille voidaan merkitä @deprecated-direktiivillä. GraphQL-tyypit sijaitsevat osana kieliä ja toteutuksia, ja niiden ymmärtäminen helpottaa sekä palvelimen että asiakkaan kehitystä.

Esimerkki: type User { id: ID! name: String posts: [Post] } type Post { id: ID! title: String author: User }