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 :
- Sauvegarder les données (i.e. sujets et votes) dans une base de données SQLite, grâce à la librairie SujetBD.
- Valider et effectuer des opérations sur les données à l'aide d'une classe de service.
- Tester les méthodes de la classe de service avec des tests unitaires.
- 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 :

- Étape 0 : La librairie SujetBD
- Étape 1 : La classe de service (1 point)
- Étape 2 : Les tests du service
- Étapes 3 à 7 : L'application finale
La librairie SujetBD fournit :
- Des classes représentant les sujets et les votes (
SujetetVote); - Une base de données SQLite
SujetVoteDataBaseconstruite avec Room et un utilitaireUtilitaireBDpermettant 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.
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).
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.
Le DAO permet d'accéder à la BD en lecture et écriture, mais n'effectue aucune validation sur les entrées de l'utilisateur... Pour ce faire, nous utiliserons une classe de service. C'est dans cette classe que vivront les règles de l'application (parfois appelées « logique applicative » ou « règles d'affaires »).
1 point Créer une classe de service en remplaçant Dupont par ton nom, à partir du modèle suivant:
class DupontService(db: SujetVoteDataBase) {
private val database : SujetVoteDataBase = db
private val dao : SujetVoteDAO = database.dao()
fun ajouterSujet(contenu: String) : Long{
// validation du contenu
val trimme = contenu.trim()
if (trimme.length == 0){
throw TexteVideException()
}
if (trimme.length < 5){
throw TexteCourtException()
}
val existant : Optional<Sujet> = dao.sujetParContenu(trimme)
if (existant.isPresent){
throw DejaPresentException()
}
// Tout va bien, on peut ajouter le sujet dans la BD
val sujet = Sujet()
sujet.contenu = trimme
return dao.ajouterSujet(sujet) // retourne l'id du sujet ajouté
}
fun ajouterVote(vote: Vote){
// TODO à faire plus des tests JUnit
throw UnsupportedOperationException()
}
fun listeSujets(): List<Sujet>{
throw UnsupportedOperationException()
}
fun moyenneVotes(id: Long): Double{
throw UnsupportedOperationException()
}
fun distributionVotes(id: Long): Map<Int, Int>{
throw UnsupportedOperationException()
}
fun supprimerTousLesSujets(){
throw UnsupportedOperationException()
}
fun supprimerTousLesVotes(){
throw UnsupportedOperationException()
}
fun sujetParId(id: Long): Sujet? {
throw UnsupportedOperationException()
}
}
Remarquez la structure de ajouterSujet : on commence par valider l'entrée de l'utilisateur, et on écrit dans la BD ensuite à l'aide du DAO. Si une règle n'est pas respectée, une exception est lancée et rien n'est écrit dans la BD. La méthode ajouterVote suivra le même principe. La classe de service permet également d'effectuer des opérations sur les données obtenues de la BD. C'est ce que permettront notamment les méthodes moyenneVotes et distributionVotes.
Dans l'interface, tu pourras utiliser ton service en créant une instance de celle-ci :
val service : DupontService = DupontService(UtilitaireBD.get(LocalContext.current))
service.ajouterSujet("Sujet 3")
L’interface s’occupe exclusivement de l’affichage des données ou des messages d’erreurs, pas de la vérification des données. Tu devras modifier l’interface de ton TP2 pour faire appel aux méthodes du service !
Tu devras tester chacune des méthodes de ta classe de service. Voici un squelette de la classe de tests:
@RunWith(AndroidJUnit4::class) // tests à placer dans le dossier androidTest
class TestsService {
private lateinit var service: DupontService
@Before
fun setup() {
val appContext = InstrumentationRegistry.getInstrumentation().targetContext
val db = UtilitaireBD.getForTests(appContext)
service = DupontService(db)
}
@Test
fun testAjoutOk() {
// creer un sujet avec un contenu valide
service.ajouterSujet("Ceci est un sujet de test")
// verifier que le sujet a bien été ajouté
val sujets = service.listeSujets()
assert(sujets.any { it.contenu == "Ceci est un sujet de test" })
}
@Test(expected = TexteVideException::class)
fun testAjoutSujetVide() {
// essayer d'ajouter un sujet vide
service.ajouterSujet("")
}
@Test(expected = TexteCourtException::class)
fun testAjoutSujetTropCourt() {
// essayer d'ajouter un sujet trop court
service.ajouterSujet("Test")
}
@Test(expected = DejaPresentException::class)
fun testAjoutSujetExistant() {
// ajouter un sujet
service.ajouterSujet("Ceci est un sujet de test")
// essayer de l'ajouter à nouveau
service.ajouterSujet("Ceci est un sujet de test")
}
// TODO compléter les autres tests pour les méthodes restantes
}
testAjoutOk utilise listeSujets(). Ce test ne passera qu'après avoir complété cette méthode à l'étape 4.
Étape 3 : Ajout/Création d'un nouveau sujet
La méthode ajouterSujet() ainsi que ses tests sont fournis. Vous devez intégrer la création d'un sujet dans l'interface graphique.
- 1 point Un sujet est créé dans l'écran de création en utilisant le contenu du champ texte.
- 1 point Si la création échoue, un message indiquant la raison de l'erreur est affiché ("sujet vide", "sujet trop court", "sujet existant").
Étape 4 : Affichage de la liste des sujets
- 1 point Au niveau service, vous devez vous assurez de renvoyer la liste triée par nombre de votes, en ordre décroissant. Est-ce qu'une méthode du DAO peut vous être utile ?
- 1 point Vous devez écrire les tests pour cette méthode.
Vous pourrez compléter les tests de cette méthode une fois l'étape 5 terminée!
- 2 points Vous devez intégrer la liste dans l'écran d'accueil de l'application.
Étape 5 : Ajout d'un vote
- 2 points Au niveau service, vous devez vous assurez qu'il n'y a pas de vote existant pour ce sujet et ce votant (personne ayant effectué le vote). Quelle méthode du DAO peut vous être utile ici ? Assurez-vous de lancer une exception significative si le vote existe déjà. Vous devez également vous assurer que le nom du votant fasse au minimum 4 caractères imprimables (pas des espaces).
- 1 point Vous devez écrire les tests pour cette méthode.
- 1 point Vous devez intégrer l'ajout d'un vote dans l'écran correspondant de l'interface graphique. Le comportement attendu est le suivant : lorsqu'un utilisateur appuie sur un sujet de la liste, il est amené vers l'écran de vote de ce sujet. Si le vote est créé avec succès, l'application doit revenir à l'écran d'accueil.
Vous aurez besoin de programmer la méthode sujetParId() du service. Quelle méthode du DAO sera appelée par le service ?
- 1 point Vous devez fournir un message significatif en cas d'erreur (déjà voté ou nom trop court ou vide).