#Appel réseaux et JSON

#Les bonnes pratiques

On pourrait simplement faire une requête réseau, transformer le JSON en un objet anonyme assez basique comme une Map<String, Any>, et afficher les données. Sauf qu’on ne va pas faire ça, c’est vraiment le pire choix de développement possible.

#Pourquoi c’est nul

A l’inverse, comment faire pour que ce soit bien ? Et bien, on va utiliser une architecture avancée pour nous permettre d’être le plus type-safe et productif possible.

#Pourquoi c’est bien

Pour faire des requêtes réseaux il y a pléhtore de librairies disponibles. Contrairement à iOS, sur Android il n’y a pas de librairie officielle pour faire des requêtes réseaux.

Aussi OkHTTP est une des librairies les plus utilisées pour faire des requêtes réseaux. OkHTTP est développé par Square, et est utilisé par de nombreuses applications Android.

Square développe également Retrofit et Moshi aussi connus pour leur simplicité d’utilisation et leur inter-compatibilité.

#Rappel de notre objectif

Ici on va installer les éléments pour que cette architecture fonctionne.

#📦 Installer Retrofit

Lisez la documentation de Retrofit pour savoir comment l’installer.

Gradle Attention à utiliser Gradle correctement avec libs.versions.toml

#Ressources

• Retrofit - Installation

#🧠 Un peu de culture - Moshi

#Qu’est-ce que Moshi ?

• Moshi vous permet de convertir les données JSON en objets Kotlin, et vice-versa.
• Moshi peut se combiner avec Retrofit pour simplifier la conversion des données.

#Comment ça marche ?

• Moshi va générer des JsonAdapter pour chaque type de données que vous souhaitez convertir.
• Vous pouvez soit les générer manuellement, soit utiliser le KSP pour les générer automatiquement.

#Les “JsonAdapter”

• Les JsonAdapter sont des classes qui permettent de convertir les données JSON en objets Kotlin, et vice-versa.
• On peut en développer manuellement, mais c’est fastidieux.
• On peut utiliser le KSP pour les générer automatiquement.

#Utilisation de KSP pour générer les adapters

Moshi est une librairie qui permet de convertir des données JSON en objets Kotlin, et vice-versa. Pour simplifier la conversion des données, nous allons utiliser le KSP pour générer automatiquement les JsonAdapter pour chaque type de données que nous souhaitons convertir.

Dans cette partie vous allez sûrement maudire le développement Android / Java / Kotlin, car il y a beaucoup de configurations à faire pour que tout fonctionne correctement. Mais une fois que tout est en place, vous verrez que c’est très pratique, et surtout, on s’approche de ce que vous allez vivre en entreprise.

#📦 Installer Moshi

#1. Installation de Moshi

Lisez la documentation de Moshi pour savoir comment l’installer : https://github.com/square/moshi

#2. Installation de KSP

Nous allons ajouter les dépendances nécessaires pour Moshi et KSP (Kotlin Symbol Processing) :

• Lisez la documentation ici : https://kotlinlang.org/docs/ksp-quickstart.html et installez KSP dans votre projet.

#3. Processor KSP pour Moshi

Ensuite il faut ajouter un processor KSP pour Moshi, qui va générer les adapters pour nous.

• Lisez la documentation de Moshi ici : https://github.com/square/moshi#codegen, dans la section KSP
• Vous devriez avoir besoin de rajouter seulement la dépendance com.squareup.moshi:moshi-kotlin-codegen:1.15.1, le plugin à été rajouté à l’étape d’avant.

#💙 Moshi + Retrofit

Maintenant que tout est installé correctement, on va enfin pouvoir coder !

1. Moshi doit être lié à Retrofit pour que les données soient automatiquement converties.
2. Faites en sorte que Moshi décode automatiquement les données JSON en objets Kotlin, y compris les Dates (👀 les ressources).
3. Créez un service Retrofit qui utilise Moshi pour les conversions.

Faites cela dans un fichier DwitchApiService.kt par exemple qui va ressembler à ça :

interface DwitchService {
   // Vos requêtes ici
}

val moshi = Moshi.Builder()
    //... Ajoutez vos adapters ici (notamment pour les dates)
    .build()

var retrofit = Retrofit.Builder()
    //... Les paramètres Retrofit ici (notamment un petit lien avec moshi)
    .build()

// Puis créez votre service
var dwitchService = retrofit.create(DwitchService::class.java)

Ressources

• Retrofit pour les requêtes réseaux
• Square Date Adapter - Utile pour décoder les dates automatiquement depuis le JSON

#Coroutines & Retrofit

Pour faire des appels réseaux, on va utiliser des Coroutines pour rendre les appels asynchrones.

#Dans un viewModel

viewModelScope.launch {
    try {
        val response = dwitchService.getOrders()
        // Faites quelque chose avec la réponse
    } catch (e: Exception) {
        // Gérez les erreurs
    }
}

#Dans un composable

#Via un SideEffect

val rememberCoroutineScope = rememberCoroutineScope()

SideEffect {
    rememberCoroutineScope.launch {
        try {
            val response = dwitchService.getOrders()
            // Faites quelque chose avec la réponse
        } catch (e: Exception) {
            // Gérez les erreurs
        }
    }
}

#Via un LaunchedEffect

val rememberCoroutineScope = rememberCoroutineScope()

LaunchedEffect(true) {
    try {
        val response = dwitchService.getOrders()
        // Faites quelque chose avec la réponse
    } catch (e: Exception) {
        // Gérez les erreurs
    }
}