Définir une interface de dépôt
Exposez les besoins en données sans divulguer les détails HTTP.
Définir une interface de dépôt est une leçon Kotlin Multiplatform Academy gratuite sur CoddyKit. Ceci est la leçon 1 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.
Qu'est-ce qu'un référentiel ?
Un référentiel est le point d'accès unique que vos applications utilisent pour obtenir des données, en masquant leur véritable origine.
Commencez par une interface
Définissez d'abord le référentiel comme une interface Kotlin, afin que les appelants dépendent d'un contrat plutôt que d'une classe concrète.
interface UserRepository {
suspend fun getUser(id: String): User
}Parlez en termes métier
Nommez les méthodes selon les besoins de l'application, par exemple getUser, et non selon la manière dont les données sont récupérées. L'intention reste claire et stable.
Renvoyer des modèles métier
L'interface renvoie des modèles métier propres, jamais du JSON brut ni des réponses HTTP, afin que l'interface utilisateur reste simple.
suspend fun getUsers(): List<User>Aucun terme HTTP autorisé
Écartez de l'interface les termes comme Ktor, les en-têtes et les codes d'état. Les appelants ne doivent jamais savoir que HTTP existe.
Suspendre pour le travail asynchrone
Déclarez les méthodes de données comme suspend afin qu'elles puissent effectuer un travail asynchrone sans bloquer et s'intégrer naturellement aux coroutines dans les deux applications.
suspend fun refresh()Il se trouve dans commonMain
Placez l'interface dans commonMain afin qu'Android et iOS partagent exactement le même contrat de données, sans duplication.
Plusieurs implémentations sont possibles
Une interface peut avoir plusieurs implémentations : une implémentation réseau réelle et une implémentation factice pour les tests, que vous pouvez remplacer librement.
Faciliter les tests
Comme les appelants dépendent de l'interface, vous pouvez injecter un référentiel factice dans les tests et éviter d'interroger le réseau réel.
class FakeUserRepository : UserRepositoryDes méthodes claires et ciblées
Gardez chaque méthode concise et utile. Une API ciblée est plus facile à lire, à simuler et à faire évoluer au fil du temps.
Un exemple complet
Voici un contrat de référentiel bien structuré, qui expose tout ce dont la fonctionnalité utilisateur a besoin, et rien de plus.
interface UserRepository {
suspend fun getUsers(): List<User>
suspend fun getUser(id: String): User
}Vérification rapide
Où l'interface du référentiel doit-elle se trouver dans un projet KMP ?
Récapitulatif
Une interface de référentiel dans commonMain définit les données nécessaires à l'application à l'aide de méthodes suspend et de modèles métier, tout en masquant les détails HTTP.
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 « Définir une interface de dépôt » est-elle gratuite ?
Oui — le texte complet de « Définir une interface de 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 « Définir une interface de dépôt » ?
Exposez les besoins en données sans divulguer les détails HTTP. 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 1 sur 4.
Combien de temps prend la leçon « Définir une interface de 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
- Définir une interface de dépôt
- Encapsuler l’API derrière le dépôt
- Mapper les DTO vers les modèles du domaine
- Exposer les résultats sous forme de Flow