GraphQLrajapintojen

GraphQL-rajapinnat ovat GraphQL-skeeman abstrakteja tyyppejä, jotka määrittelevät kokoelman kenttiä, joihin kaikkien niiden toteuttavien tyyppejen on sitouduttava. Rajapinta ei sisällä konkreettista toteutusta itsessään, vaan sen avulla voidaan kuvata useiden, toisistaan poikkeavien tyylien yhteisiä ominaisuuksia. Rajapinnat mahdollistavat polymorfisen kyselyn, jossa samaan kenttänimeen voi palautua erilaisia toteuttavia tyyppejä.

Skeemassa rajapinta määritellään nimettynä rakenteena, jota seuraavat tyypit voivat toteuttaa. Esimerkki: interface Character { id: ID! name: String! } type Human implements Character { id: ID! name: String! homePlanet: String } type Droid implements Character { id: ID! name: String! primaryFunction: String }. Kun kyseltyä dataa palautetaan, resolverin on määritettävä, mikä konkreettinen tyypin toteutus on kyseessä, tyypin palauttamisen jälkeen käytetään esimerkiksi __resolveType -resolveria oikean tyypin ratkaisemiseksi.

Rajapinnat eroavat unioneista siten, että rajapinta vaatii yhteiset kentät kaikille toteuttaville tyypeille, kun taas unioni voi palvella täysin erilaisia tyyppejä ilman yhteisiä kenttiä. Rajapintoja kannattaa käyttää silloin, kun halutaan tarjota yhteinen näkymä useille tyypeille ja säilyttää tyyppitason turvallisuus sekä konsistentit kyselymallit. Rajapintojen käyttö auttaa myös tekemään API:n asiakkaalle joustavammaksi, kun samaan kyselyyn voi sisällyttää monenlaisia toteutuksia.