Créer le ViewModel¶

7.1 Qu'est-ce qu'un ViewModel ?¶

Le rôle de la ViewModel est de fournir des données à l'interface utilisateur et de survivre aux changements de configuration. Une ViewModel agit comme un centre de communication entre le Repository et l'interface utilisateur. Vous pouvez également utiliser une ViewModel pour partager des données entre des fragments. La ViewModel est une partie de la bibliothèque Lifecycle.

Pour une introduction à ce sujet, consultez ViewModel Overview ou le billet de blog ViewModels: A Simple Example.

7.2 Pourquoi utiliser un ViewModel ?¶

Un ViewModel conserve les données de l'interface utilisateur de votre application de manière consciente du cycle de vie, ce qui leur permet de survivre aux changements de configuration. Séparer les données de l'interface utilisateur de votre application de vos classes Activity et Fragment vous permet de mieux suivre le principe de responsabilité unique : vos activités et fragments sont responsables de l'affichage des données à l'écran, tandis que votre ViewModel peut s'occuper de conserver et de traiter toutes les données nécessaires à l'interface utilisateur.

Dans le ViewModel, utilisez LiveData pour les données modifiables que l'interface utilisateur utilisera ou affichera. L'utilisation de LiveData présente plusieurs avantages :

• Vous pouvez utiliser un observateur sur les données (au lieu de les interroger régulièrement) et mettre à jour l'interface utilisateur uniquement lorsque les données changent réellement.
• Le référentiel (Repository) et l'interface utilisateur sont complètement séparés par le ViewModel.
• Il n'y a pas d'appels à la base de données depuis le ViewModel (tout cela est géré dans le référentiel), ce qui rend le code plus testable.

7.3 Implémenter le ViewModel¶

Créez un fichier de classe pour WordViewModel sous la racine du package de votre application et ajoutez-y ce code :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

class WordViewModel(application: Application) : AndroidViewModel(application) {

    private val repository = WordRepository(WordRoomDatabase.getDatabase(application).wordDao())

    val allWords: LiveData<List<Word>> = repository.allWords

    // Lance l'insertion dans une coroutine liée au cycle de vie du ViewModel.
    fun insert(word: Word) {
        viewModelScope.launch {
            repository.insert(word)
        }
    }
}

Explications :

• Créé une classe appelée WordViewModel qui prend l'application comme paramètre et étend AndroidViewModel.
• Ajouté une propriété privée repository pour conserver une référence au dépôt, créé à partir du DAO de la base de données.
• Ajouté une propriété allWords pour exposer la liste de mots en cache : elle est initialisée avec le LiveData du dépôt.
• Créé une fonction wrapper insert() qui appelle la fonction insert() du dépôt. De cette façon, l'implémentation de insert() est encapsulée de l'interface utilisateur.
• viewModelScope.launch { ... } lance une coroutine pour appeler la fonction suspend du dépôt. Le viewModelScope est lié au cycle de vie du ViewModel : les coroutines en cours sont annulées automatiquement lorsque le ViewModel est détruit (appel de onCleared()).