GraphQLtyypit

GraphQLtyypit muodostavat GraphQL-skeeman keskeisen osan. Ne määrittelevät, millaista dataa asiakas voi kysyä tai muokata, ja millaisen muodon vastaukset saavat. Tyyppijärjestelmä on vahvasti tyypitetty: jokainen arvo palautetaan tietyllä tyypillä, ja tyyppejä voidaan yhdistellä skeemassa.

Perus-tyyppejä ovat scalaarityypit kuten Int, Float, String, Boolean ja ID. Lisäksi skeemaan voidaan määrittää omia scalaarityyppejä, esimerkiksi DateTime.

Objektityypit kuvaavat dataa ja niiden kentät määräävät vastauksien rakennetta. Esimerkkinä User-tyyppi, jolla voi olla kenttiä id: ID, name: String ja posts: [Post]. Kenttien palautustyypit sekä mahdolliset argumentit tarkentavat, mitä kyselyllä voidaan pyytää. Kenttiä voidaan määritellä sekä listamuodossa että ei-null -arvona, esimerkin vuoksi [User!]!.

Input-tyypit määrittävät mutaatioiden tai muiden operaatioiden syötteet. Ne toimivat kuin objektityypit, mutta niitä voidaan käyttää vain syötteinä.

Enum-tyypit rajoittavat arvot yhdelle ennalta määrätylle joukkoarvolle, esimerkiksi Status: PENDING, ACTIVE, DONE.

Interfaces ja Unions tarjoavat joustavuutta. Interface määrää yhteiset kentät, joita useampi object-tyyppi toteuttaa. Union puolestaan voi olla vain yksi useammasta object-tyypistä.

Skeeman ominaisuudet ovat root-tyypit Query, Mutation ja Subscription, jotka määrittävät, miten data kysytään, muokataan tai tilauksia seurataan. GraphQL-tyypit voidaan määritellä SQL:ää vastaavan SDL:n avulla: type, interface, enum, input, union ja scalar.

Lisäksi skeema tukee introspection-kyselyjä, joiden avulla asiakkaat voivat tutkia skeeman rakennetta dynaamisesti. Resolverit määrittävät, miten kunkin kentän arvo lasketaan operaation aikana.