Aller au contenu principal

Travail 3 : Application Android (25 points)

But du travail​

Dans le TP2, les sujets n'existaient qu'en mémoire : fermer l'application les faisait disparaître.

Dans le TP3, tu vas :

  1. Sauvegarder les données (i.e. sujets et votes) dans une base de données SQLite, grâce à la librairie SujetBD.
  2. Valider et effectuer des opérations sur les données à l'aide d'une classe de service.
  3. Tester les méthodes de la classe de service avec des tests unitaires.
  4. Ajouter un tiroir de navigation permettant aussi de supprimer tous les sujets et tous les votes.

Git et suivi du code​

Tu recevras un lien GitHub Classroom pour le TP3. Tu peux y copier ton TP2.

  • ​2 points Minimum de 5 commits de tailles comparables (pas un commit géant et des commits vides).

  • Messages de commit décrivant l'avancement, en français correct (passe Word).

  • Ces points sont conditionnés à la remise d'au moins un commit par semaine de cours.


Architecture de l'application​

Ton application sera maintenant découpée en trois couches et associée à une BD locale :

Architecture en trois couches

La librairie SujetBD fournit :

  • Des classes représentant les sujets et les votes (Sujet et Vote);
  • Une base de données SQLite SujetVoteDataBase construite avec Room et un utilitaire UtilitaireBD permettant de l'obtenir;
  • Un DAO (Data Access Object), SujetVoteDAO, qui fournit les méthodes d’accès direct aux données. Tu n'as pas à écrire de SQL, c'est Room qui s'en charge à partir de ces méthodes d’accès.

Tu peux consulter la recette JitPack pour savoir comment importer la librairie. Le code source de la librairie est également accessible pour les curieux !

Pour tester l’accès à la base de données, tu peux exécuter le code suivant dans ton projet :

// Obtient la BD de l'application (LocalContext.current fournit le contexte Android nécessaire)
val database: SujetVoteDataBase = UtilitaireBD.get(LocalContext.current)

// Récupère le DAO, l'objet qui donne accès aux méthodes de lecture et d'écriture dans la BD
val dao: SujetVoteDAO = database.dao()

// Crée un objet Sujet vide (pas encore enregistré dans la BD)
val sujet = Sujet()

// Donne un contenu au sujet
sujet.contenu = "test"

// Envoie le sujet à la BD pour l'enregistrer (le DAO ne fait aucune vérification)
dao.ajouterSujet(sujet)

// Lit tous les sujets de la BD et les affiche dans le **Logcat**. Appliquez le filtre "system.out" dans le Logcat.
println(dao.tousLesSujets())

Une fois le code exécuté, tu peux inspecter la base de données de ton application à partir d’Android Studio :

View -> Tool Windows -> App Inspection -> Database Inspector

Développe ensuite la base de données, puis double-clique sur une table, comme Sujet, pour en consulter le contenu.

astuce

Dans ce TP, nous utilisons une BD locale hébergée sur votre émulateur. Pour effacer manuellement votre BD, il suffit de faire un Wipe Data de votre appareil (dans Device Manager).

remarque

Ce code sert seulement à vérifier le branchement. Retire-le une fois le test fait : dans ton application finale, les écrans n'appellent jamais le DAO directement. Ils passent par le service.