Ajouter une base de données "Room"¶

5.1 Qu'est-ce qu'une base de données Room ?¶

• Room est une couche de base de données au-dessus d'une base de données SQLite.
• Room s'occupe des tâches banales que vous aviez l'habitude de gérer avec un SQLiteOpenHelper.
• Room utilise le DAO pour émettre des requêtes vers sa base de données.
• Par défaut, pour éviter de dégrader les performances de l'interface utilisateur, Room ne vous permet pas d'émettre des requêtes sur le thread principal. Lorsque les requêtes Room renvoient des LiveData, elles sont automatiquement exécutées de manière asynchrone sur un thread d'arrière-plan.
• Room fournit des vérifications au moment de la compilation des déclarations SQLite.

5.2 Implémenter la base de données Room¶

Votre classe de base de données Room doit être abstraite et hériter de RoomDatabase. En général, vous n'avez besoin que d'une seule instance d'une base de données Room pour toute l'application.

Créons-en une maintenant. Créez un fichier de classe appelé WordRoomDatabase sous le package data.db et ajoutez-y le code suivant :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

@Database(entities = {Word.class}, version = 1, exportSchema = false)
public abstract class WordRoomDatabase extends RoomDatabase {

   public abstract WordDao wordDao();

   private static volatile WordRoomDatabase INSTANCE;
   private static final int NUMBER_OF_THREADS = 4;
   public static final ExecutorService databaseWriteExecutor =
        Executors.newFixedThreadPool(NUMBER_OF_THREADS);

   public static WordRoomDatabase getDatabase(final Context context) {
        if (INSTANCE == null) {
            synchronized (WordRoomDatabase.class) {
                if (INSTANCE == null) {
                    INSTANCE = Room.databaseBuilder(context.getApplicationContext(),
                            WordRoomDatabase.class, "word_database")
                            .fallbackToDestructiveMigration()
                            .build();
                }
            }
        }
        return INSTANCE;
    }
}

Parcourons le code ensemble :

• La classe de base de données pour Room doit être abstraite (abstract) et étendre RoomDatabase.
• Vous annotez la classe pour qu'elle soit une base de données Room avec @Database et utilisez les paramètres d'annotation pour déclarer les entités qui appartiennent à la base de données et définir le numéro de version. Chaque entité correspond à une table qui sera créée dans la base de données. Les migrations de base de données sont hors du champ d'application de ce codelab, nous définissons donc exportSchema à false ici pour éviter un avertissement de compilation. Dans une application réelle, vous devriez envisager de définir un répertoire que Room utilisera pour exporter le schéma afin que vous puissiez vérifier le schéma actuel dans votre système de contrôle de version.
• La base de données expose des DAO via une méthode "getter" abstraite pour chaque @Dao.
• Nous avons défini un singleton, WordRoomDatabase, pour empêcher l'ouverture de plusieurs instances de la base de données en même temps.
• getDatabase renvoie le singleton. Il créera la base de données la première fois qu'elle sera accédée, en utilisant le générateur de base de données de Room pour créer un objet RoomDatabase dans le contexte de l'application à partir de la classe WordRoomDatabase et le nommer "word_database".
• Nous avons créé un ExecutorService avec un pool de threads fixe que vous utiliserez pour exécuter les opérations de base de données de manière asynchrone sur un thread d'arrière-plan.