Kotlin Multiplatform Academy · Leçon

Encapsuler l’API derrière le dépôt

Masquez Ktor et la sérialisation aux appelants.

Leçon 2 sur 413 étapes

Encapsuler l’API derrière le dépôt est une leçon Kotlin Multiplatform Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Kotlin Multiplatform Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Kotlin Multiplatform Academy comprend 4 leçons au total.

Construisez maintenant la version réelle

Une fois l'interface définie, vous écrivez une implémentation concrète qui récupère réellement les données en arrière-plan.

Implémentez l'interface

Créez une classe qui implémente l'interface du référentiel et s'engage à fournir toutes les méthodes qu'elle déclare.

class UserRepositoryImpl : UserRepository

Injectez le client Ktor

Transmettez HttpClient au constructeur au lieu de le créer à l'intérieur, afin de pouvoir le partager et le remplacer dans les tests.

class UserRepositoryImpl(private val client: HttpClient) : UserRepository

Masquez l'appel réseau

Dans chaque méthode, effectuez la requête Ktor et renvoyez le résultat. Les appelants voient des données propres, jamais la requête elle-même.

override suspend fun getUsers() = client.get(url).body<List<User>>()

Gardez les URL à l'intérieur

Stockez les URL de base et les chemins dans l'implémentation. Le reste de l'application ignore ainsi complètement tout point de terminaison.

Un seul endroit à modifier

Si le chemin de l'API change, vous ne modifiez que cette classe. L'interface et tous les appelants restent inchangés.

La sérialisation reste masquée

L'appel body transforme ici le JSON en modèles, de sorte que la sérialisation ne remonte jamais jusqu'à la couche d'interface utilisateur.

val user: User = client.get(url).body()

Le même code pour les deux applications

Cette implémentation se trouve dans commonMain, si bien que le même code de récupération alimente Android et iOS de manière identique.

Remplacez-la sans modifier les appelants

Comme elle respecte l'interface, vous pourrez plus tard la remplacer par une version avec mise en cache sans qu'aucun appelant ne change.

Reliez-la avec DI

Une configuration d'injection de dépendances fournit cette implémentation aux appelants via le type interface, ce qui limite le couplage.

single<UserRepository> { UserRepositoryImpl(get()) }

L'enveloppe complète

Voici l'enveloppe complète : elle reçoit un client, masque la requête et renvoie de simples modèles métier.

class UserRepositoryImpl(
    private val client: HttpClient
) : UserRepository {
    override suspend fun getUsers() =
        client.get("/users").body<List<User>>()
}

Vérification rapide

Quel est le rôle principal de l'implémentation du référentiel ?

Récapitulatif

L'implémentation reçoit un HttpClient, effectue la requête et renvoie des modèles métier, en isolant tout le réseau des appelants.

Gratuit pour commencer

Apprends Kotlin avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours
30
Leçons
120

Questions Fréquemment Posées

La leçon « Encapsuler l’API derrière le dépôt » est-elle gratuite ?

Oui — le texte complet de « Encapsuler l’API derrière le dépôt » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Kotlin Multiplatform Academy, passe à CoddyKit PRO. Le cours Kotlin Multiplatform Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Encapsuler l’API derrière le dépôt » ?

Masquez Ktor et la sérialisation aux appelants. Tu pratiques Kotlin Multiplatform Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Kotlin Multiplatform Academy ?

Aucune expérience préalable n'est requise. Kotlin Multiplatform Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.

Combien de temps prend la leçon « Encapsuler l’API derrière le dépôt » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Kotlin Multiplatform Academy ?

Oui. Chaque leçon Kotlin Multiplatform Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Définir une interface de dépôt
  2. Encapsuler l’API derrière le dépôt
  3. Mapper les DTO vers les modèles du domaine
  4. Exposer les résultats sous forme de Flow
← Retour à Kotlin Multiplatform Academy