En aquest tema, explorarem els diferents tipus que GraphQL ofereix per definir l'esquema de la teva API. Els tipus són fonamentals per estructurar les dades i les operacions que es poden realitzar en una API GraphQL. A continuació, desglossarem els conceptes clau i proporcionarem exemples pràctics per ajudar-te a comprendre com utilitzar-los.

Els tipus d'objecte són els més comuns en GraphQL. Defineixen una estructura de dades amb camps específics.

Exemple:

Explicació:

• User és un tipus d'objecte que té tres camps: id, name i email.
• ID! indica que id és un identificador únic i no pot ser nul.
• String! indica que name i email són cadenes de text i no poden ser nul·les.

Els tipus d'escalar són els tipus de dades primitius en GraphQL. Els tipus d'escalar per defecte són:

• Int: Enter de 32 bits.
• Float: Número de coma flotant de doble precisió.
• String: Cadena de text.
• Boolean: Valor booleà (true o false).
• ID: Identificador únic, sovint utilitzat per identificar recursos.

Exemple:

Els tipus d'enumeració permeten definir un conjunt de valors possibles per un camp.

Exemple:

Explicació:

• Role és un tipus d'enumeració amb tres valors possibles: ADMIN, USER i GUEST.
• El camp role del tipus User ha de ser un dels valors definits en l'enumeració Role.

Els tipus de llista permeten definir camps que contenen una llista d'elements d'un tipus específic.

Exemple:

Explicació:

• users és un camp que retorna una llista de User.
• [User!]! indica que la llista no pot ser nul·la i que cada element de la llista tampoc pot ser nul.

Els tipus d'entrada s'utilitzen per definir els paràmetres d'entrada de les mutacions.

Exemple:

Explicació:

• CreateUserInput és un tipus d'entrada que defineix els paràmetres necessaris per crear un usuari.
• La mutació createUser pren un paràmetre input de tipus CreateUserInput i retorna un User.

Defineix un tipus d'objecte Book amb els següents camps: id (ID), title (String), author (String) i publishedYear (Int).

Solució:

Defineix un tipus d'enumeració Genre amb els valors FICTION, NONFICTION, SCIENCE, i HISTORY. Afegeix un camp genre al tipus Book que utilitzi aquest tipus d'enumeració.

Solució:

Defineix un tipus d'entrada CreateBookInput amb els camps title, author, publishedYear i genre. Afegeix una mutació createBook que prengui aquest tipus d'entrada i retorni un Book.

Solució:

En aquest tema, hem après sobre els diferents tipus que GraphQL ofereix per definir l'esquema de la teva API, incloent-hi els tipus d'objecte, escalar, enumeració, llista i entrada. Aquests tipus són fonamentals per estructurar les dades i les operacions en una API GraphQL. Hem proporcionat exemples pràctics i exercicis per ajudar-te a comprendre com utilitzar aquests tipus en la teva pròpia API.

En el següent tema, explorarem els Escalars de GraphQL, on aprendrem més sobre els tipus de dades primitius i com crear escalar personalitzats.