Ciao, e benvenuto nella sesta puntata della quarantaquattresima stagione. Finora abbiamo parlato quasi sempre di chiedere dati: leggere il grafo. Ma un'API seria non serve solo a leggere: serve anche a cambiare le cose, e a volte a restare aggiornati mentre cambiano. Oggi vediamo le operazioni di GraphQL, i tre modi di interagire con il grafo: leggere, cambiare, e restare in ascolto. Sono tre gesti distinti, tenuti apposta separati, e in quella separazione c'è una piccola saggezza.
Partiamo dal primo gesto, il più comune, perché lo conosciamo già. Il primo modo di interagire è leggere: chiedere dati, esattamente ciò di cui abbiamo parlato fino ad ora. Descrivi la forma del grafo che ti serve, e la ricevi. È l'operazione di gran lunga più frequente, quella che riempie le schermate: mostrami questo utente e i suoi articoli, dammi questo prodotto con le sue recensioni. Leggere è guardare il grafo senza toccarlo: chiedi, ricevi, e nulla è cambiato. La stragrande maggioranza di ciò che un'applicazione fa è, in fondo, leggere.
Voglio darti il secondo gesto, il cambiare, perché è l'altra faccia. Il secondo modo è cambiare le cose: creare qualcosa di nuovo, modificare qualcosa che esiste, o cancellarlo. Iscrivere un nuovo utente, aggiornare un indirizzo, eliminare un commento. E qui GraphQL fa una scelta pulita: tiene il cambiare esplicitamente separato dal leggere. C'è un modo apposta per dire sto per modificare qualcosa, distinto dal modo per dire sto solo guardando. Non si confondono mai: da come formuli l'operazione, è sempre chiarissimo se stai semplicemente osservando o se stai davvero alterando lo stato delle cose. Leggere e scrivere non si mescolano.
Voglio darti il terzo gesto, il più affascinante, perché cambia il ritmo. Il terzo modo è restare in ascolto. Invece di chiedere una volta e ricevere una risposta, dici al servizio: tienimi aggiornato ogni volta che questa cosa cambia. E il servizio, da quel momento, ti manda i nuovi dati appena accadono, senza che tu debba richiederli. È il dato dal vivo: arriva un nuovo messaggio in chat, e compare sul tuo schermo; cambia un prezzo, e si aggiorna da solo; si segna un punto, e il tabellone si muove. Non più chiedere e attendere, ma iscriversi e ricevere, mano a mano che le cose succedono. Un flusso vivo, invece di una singola domanda.
Voglio farti apprezzare perché tenere questi gesti distinti sia saggio, perché non è ovvio. C'è una piccola saggezza nel separare nettamente leggere, cambiare e restare in ascolto. Rende le intenzioni esplicite. Chi guarda un'operazione sa subito di che tipo è: sta solo leggendo, e allora è innocua, si può ripetere senza timore; sta cambiando qualcosa, e allora va trattata con più attenzione; sta aprendo un flusso dal vivo, e allora è un'altra cosa ancora. Non mescolare questi tre significati rende il sistema più chiaro, più sicuro, più facile da ragionare. Sapere sempre se stai guardando o toccando è una forma di igiene mentale, prima ancora che tecnica.
Voglio collegare l'ascolto a un mondo che conosciamo, perché è un filo che torna. Quel terzo gesto, restare in ascolto, ti ricorda qualcosa? È lo stesso spirito del pensare per eventi, di cui parlammo con il registro degli eventi: il passaggio dal chiedere ripetutamente all'essere avvisati quando qualcosa cambia. Invece di bussare in continuazione per domandare c'è qualcosa di nuovo?, ti metti in ascolto una volta, e sei tu a essere chiamato quando succede. È un aggiornamento ricorrente nel modo in cui i sistemi si scambiano notizie: reagire agli eventi, invece di interrogare senza sosta. Un tema che, in forme diverse, incontriamo di continuo.
Voglio darti l'immagine che rende chiara questa idea, e la lezione. Pensa a tre modi di trattare una bacheca di avvisi. Puoi leggere ciò che è appeso: è la lettura. Puoi appendere un nuovo avviso, o toglierne uno: è il cambiare. Oppure puoi chiedere che ti diano un colpetto sulla spalla ogni volta che la bacheca cambia: è il restare in ascolto. Tre gesti chiaramente diversi, e sai sempre quale stai facendo. La lezione è questa: separare il leggere dallo scrivere dall'osservare, rendere esplicito il tipo di interazione, è una piccola chiarezza di progettazione che ripaga in sicurezza e comprensione. E il passaggio dal chiedere in continuazione all'essere avvisati è un miglioramento che ritorna, ovunque i sistemi si scambino notizie.
Per oggi ci fermiamo qui. Un'API non serve solo a leggere, e GraphQL ha tre modi di interagire con il grafo, tenuti apposta distinti. Leggere: chiedere dati, guardare il grafo senza toccarlo, il gesto più comune. Cambiare: creare, modificare, cancellare, tenuto esplicitamente separato dal leggere, così è sempre chiaro se stai osservando o alterando. E restare in ascolto: iscriversi agli aggiornamenti e ricevere i dati dal vivo appena accadono, come il pensare per eventi che già conosciamo. La lezione: rendere esplicito il tipo di interazione è una chiarezza che ripaga, e farsi avvisare batte l'interrogare senza sosta. Nella prossima puntata guardiamo dietro il grafo: uno sportello per tanti magazzini. Nelle note trovi qualche spunto. Se ti è utile, condividila. Grazie per l'ascolto, e ci sentiamo alla prossima.