Mais avant…

Les Threads

• Les appels ne doivent pas être fait dans le Thread UI.
• Le traitement de l'affichage doit être fait sur le Thread UI.

Les librairies

• OkHttp
• GSON
• Retrofit
• CoRoutines Kotlin

Les CoRoutines Kotlin

• Quelques explications…
• Asynchrone, vous connaissez ?
• Un mot magique… suspend

implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.3.9'
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.8'

OkHttp (3)

• RestClient
• Http2
• Gestion du cache
• Intercepteur de requête

implementation 'com.squareup.okhttp3:okhttp:4.7.2'
implementation 'com.squareup.okhttp3:logging-interceptor:4.7.2'

GSON

• Sérialisation / Deserialisation automatique entre un JSON et un Objet Java / Kotlin

implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

Retrofit

• Une API Http qui s'utilise comme une « Interface Java ».
• Conversion de données (mapping automatique des objets 🚀).
• Utilise des annotations (@GET, @POST, @PUT, @DELETE, @HEAD, …)
• Compatible CoRoutine (mais également sans)

implementation 'com.squareup.okhttp3:okhttp:4.7.2'
implementation 'com.squareup.okhttp3:logging-interceptor:4.7.2'

Les annotations

@GET("/status")
suspend fun readStatus(@Query("identifier") identifier: String): LedStatus

@POST("/status")
suspend fun writeStatus(@Body status: LedStatus): LedStatus

Bon… Et maintenant !

Deux fichiers

• Le ApiService.kt (l'interface et le builder pour la partie HTTP)
• La classe / un modèle LedStatus

L'interface (et le builder)

Deux méthodes

• ReadStatus
• WriteStatus

L'objet de retour et d'action

LedStatus

Le model : LedStatus

• Construit par vous pour interagir.
• Construit automatiquement par GSON pour avoir le Status.

Télécharger le fichier LedStatus.java (À ranger dans le package ….data.modele.

Le ApiService

• Définition du « connecteur » HTTP.
• Définition des méthodes.

Télécharge le fichier ApiService.kt (À ranger dans le package ….data.service)

BuildConfig.URI_REMOTE_SERVER ?

Externaliser la conf c'est bien !

defaultConfig {
    buildConfigField "String", "URI_REMOTE_SERVER", "\"http://IP.DE.VOTRE.ESP\""
…
}

C'est à vous

Configurer votre projet

Faire un appel réseau

1 - Obtenir l'APIService

ApiService.Builder.getInstance();

2 - L'appel réseau

CoroutineScope(Dispatchers.IO).launch {
    runCatching {
        val readStatus = ApiService.instance.readStatus(ledStatus.identifier)
        ledStatus.setStatus(readStatus.status)
        setVisualState()
    }
}

On en parle non ?

3 - Profit !