WEBVTT

1
00:00.980 --> 00:07.760
Il secondo passo per implementare la
libreria retrofit nella nostra
applicazione è creare l'interfaccia del
servizio.

2
00:07.760 --> 00:15.230
È necessario creare un'interfaccia per
definire i metodi che verranno utilizzati

3
00:15.230 --> 00:17.480
per le transazioni di rete, nota anche
come interfaccia API.

4
00:17.480 --> 00:24.530
Nel retrofit, un'interfaccia di servizio è
essenziale perché definisce la struttura

5
00:24.530 --> 00:29.510
e il comportamento delle richieste di rete
che l'applicazione farà all'API.

6
00:29.540 --> 00:37.880
Agisce come un contratto tra
l'applicazione e l'API, specificando come
devono

7
00:37.880 --> 00:40.130
essere formulate le richieste e quali
risposte ci si aspetta.

8
00:40.160 --> 00:47.510
L'interfaccia del servizio separa
chiaramente la definizione delle
operazioni di rete dalla loro
implementazione.

9
00:47.510 --> 00:54.350
Questo aiuta a mantenere il codice pulito
e modulare, facilitando la

10
00:54.350 --> 00:56.150
gestione e la scalabilità e definendo gli
endpoint delle API.

11
00:56.180 --> 01:00.890
Retrofit garantisce che le richieste e le
risposte siano di tipo sicuro.

12
01:00.890 --> 01:08.730
Ciò significa che i tipi di dati dei
parametri e dei valori di ritorno vengono

13
01:08.730 --> 01:11.850
controllati in fase di compilazione,
riducendo la probabilità di errori in fase
di esecuzione.

14
01:11.880 --> 01:15.690
Entriamo in Android Studio e iniziamo a
creare l'interfaccia del servizio.

15
01:15.690 --> 01:23.610
All'interno del pacchetto retrofit, creare
una nuova interfaccia, denominata retrofit
o servizio API.

16
01:24.960 --> 01:32.550
All'interno di questa interfaccia,
definirò i metodi di cui abbiamo bisogno
per creare un'interfaccia.

17
01:32.550 --> 01:38.760
Dobbiamo definire i metodi da eseguire sul
server.

18
01:38.760 --> 01:47.610
Per prima cosa, dobbiamo annotarlo con il
tipo di richiesta Get o post o qualsiasi
altro tipo di richiesta HTTP.

19
01:47.610 --> 01:57.780
In questo caso, dobbiamo usare il metodo
get e dobbiamo specificare un endpoint che
ci riporti al nostro sito web.

20
01:57.780 --> 02:02.640
Qui, il segnaposto JSON è del tipo
code.com.

21
02:02.640 --> 02:06.190
Questo è l'URL di base e questo è
l'endpoint.

22
02:06.220 --> 02:08.350
Il punto di arrivo sono i messaggi.

23
02:08.350 --> 02:13.870
Se lo cambio in album, si può vedere che
l'endpoint è cambiato.

24
02:13.870 --> 02:20.050
Quindi all'interno dell'interfaccia del
servizio API dobbiamo definire gli
endpoint.

25
02:20.050 --> 02:22.990
Quindi qui copierò i post.

26
02:22.990 --> 02:32.230
Occorre poi creare una funzione di
sospensione, denominata get posts, che
restituisca un elenco di messaggi.

27
02:32.230 --> 02:35.260
Cominciamo con l'annotazione get.

28
02:35.260 --> 02:38.080
Questa annotazione è stata fornita da
Retrofit.

29
02:38.080 --> 02:43.690
Specifica che il metodo eseguirà una
richiesta HTTP get.

30
02:43.690 --> 02:44.320
Messaggi.

31
02:44.320 --> 02:52.510
L'endpoint è il percorso URL relativo
aggiunto all'URL di base definito
nell'istanza di retrofit? Quindi qui

32
02:52.510 --> 03:03.580
abbiamo il segnaposto JSON dell'URL di
base, tipo typecode.com, e l'endpoint è il
post suspend.

33
03:03.610 --> 03:11.490
Questa parola chiave indica che la
funzione è una funzione di sospensione

34
03:11.490 --> 03:12.630
che può essere messa in pausa e ripresa in
un momento successivo.

35
03:12.660 --> 03:20.130
Le funzioni di sospensione sono una
caratteristica fondamentale delle
coroutine di Kotlin,

36
03:20.130 --> 03:22.980
che consentono di eseguire operazioni
asincrone senza bloccare il thread
principale.

37
03:23.010 --> 03:29.910
Abbiamo imparato a conoscere le funzioni
di sospensione nei video precedenti e
abbiamo un corso

38
03:29.910 --> 03:35.070
o una sezione sulle coroutine, quindi
tornate alla sezione sulle coroutine per
saperne di più.

39
03:35.100 --> 03:36.120
Getposts.

40
03:36.120 --> 03:37.650
È il nome della funzione.

41
03:37.650 --> 03:41.670
Non accetta alcun parametro, in questo
caso l'elenco.

42
03:41.670 --> 03:43.980
È il tipo di ritorno della funzione.

43
03:43.980 --> 03:48.300
Specifica che la funzione restituirà un
elenco di oggetti post.

44
03:48.300 --> 03:48.810
Post.

45
03:48.810 --> 03:56.580
Si tratta di una classe di dati definita
nel video

46
03:56.580 --> 03:57.690
precedente che contiene tre parametri ID,
titolo e corpo.

47
03:57.690 --> 04:04.410
Ecco come si crea l'interfaccia e perché
si usa l'interfaccia del servizio API