Il secondo passo per implementare la libreria retrofit nella nostra applicazione è creare l'interfaccia del servizio.
È necessario creare un'interfaccia per definire i metodi che verranno utilizzati
per le transazioni di rete, nota anche come interfaccia API.
Nel retrofit, un'interfaccia di servizio è essenziale perché definisce la struttura
e il comportamento delle richieste di rete che l'applicazione farà all'API.
Agisce come un contratto tra l'applicazione e l'API, specificando come devono
essere formulate le richieste e quali risposte ci si aspetta.
L'interfaccia del servizio separa chiaramente la definizione delle operazioni di rete dalla loro implementazione.
Questo aiuta a mantenere il codice pulito e modulare, facilitando la
gestione e la scalabilità e definendo gli endpoint delle API.
Retrofit garantisce che le richieste e le risposte siano di tipo sicuro.
Ciò significa che i tipi di dati dei parametri e dei valori di ritorno vengono
controllati in fase di compilazione, riducendo la probabilità di errori in fase di esecuzione.
Entriamo in Android Studio e iniziamo a creare l'interfaccia del servizio.
All'interno del pacchetto retrofit, creare una nuova interfaccia, denominata retrofit o servizio API.
All'interno di questa interfaccia, definirò i metodi di cui abbiamo bisogno per creare un'interfaccia.
Dobbiamo definire i metodi da eseguire sul server.
Per prima cosa, dobbiamo annotarlo con il tipo di richiesta Get o post o qualsiasi altro tipo di richiesta HTTP.
In questo caso, dobbiamo usare il metodo get e dobbiamo specificare un endpoint che ci riporti al nostro sito web.
Qui, il segnaposto JSON è del tipo code.com.
Questo è l'URL di base e questo è l'endpoint.
Il punto di arrivo sono i messaggi.
Se lo cambio in album, si può vedere che l'endpoint è cambiato.
Quindi all'interno dell'interfaccia del servizio API dobbiamo definire gli endpoint.
Quindi qui copierò i post.
Occorre poi creare una funzione di sospensione, denominata get posts, che restituisca un elenco di messaggi.
Cominciamo con l'annotazione get.
Questa annotazione è stata fornita da Retrofit.
Specifica che il metodo eseguirà una richiesta HTTP get.
Messaggi.
L'endpoint è il percorso URL relativo aggiunto all'URL di base definito nell'istanza di retrofit? Quindi qui
abbiamo il segnaposto JSON dell'URL di base, tipo typecode.com, e l'endpoint è il post suspend.
Questa parola chiave indica che la funzione è una funzione di sospensione
che può essere messa in pausa e ripresa in un momento successivo.
Le funzioni di sospensione sono una caratteristica fondamentale delle coroutine di Kotlin,
che consentono di eseguire operazioni asincrone senza bloccare il thread principale.
Abbiamo imparato a conoscere le funzioni di sospensione nei video precedenti e abbiamo un corso
o una sezione sulle coroutine, quindi tornate alla sezione sulle coroutine per saperne di più.
Getposts.
È il nome della funzione.
Non accetta alcun parametro, in questo caso l'elenco.
È il tipo di ritorno della funzione.
Specifica che la funzione restituirà un elenco di oggetti post.
Post.
Si tratta di una classe di dati definita nel video
precedente che contiene tre parametri ID, titolo e corpo.
Ecco come si crea l'interfaccia e perché si usa l'interfaccia del servizio API