Template (officielle)
Préalable
Tous ces éléments sont à observer pour que le travail soit évaluable
- Une archive .zip est déposée sur Moodle.
- L'archive comporte un projet eclipse mentionnant le nom et le prénom (une infraction de nommage tolérée sur les 3 itérations)
- Le projet respecte la structure demandée (présence des répertoires src et tests, fichiers sources dans les bons paquetages. -0,25 sur la note finale par fichier mal placé)
- Les versions de Java, Junit et Eclipse sont conformes à celles demandées (une infraction tolérée sur les 3 itérations)
- Eclipse ne mentionne pas de problème de compilation (sauf problèmes de liaison au JDK, à JUnit 5)
Acquis 1 : Programmer des énoncés de conception en Java selon les principes de la POO
Seuil de réussite (tous sont à valider pour obtenir l'acquis)
- [Prog. Procedurale] PMD relève au plus 2 méthodes trop longues et/ou trop complexes
- [Cohésion] PMD relève au plus 2 classes comportant 5 attributs ou plus.
- [Cohésion] PMD relève au plus 1 classe divine ou une classe de données
- [Encapsulation] PMD relève au plus 2 attributs d'accès autres que private
- [Encapsulation] Au moins 2 méthodes ou constructeurs respectent le principe de copies défensives pour les collections.
- [Masquage] Les classes métiers respectent la loi de Déméter (2 infractions tolérées)
- [RDD] La plupart des types du domaine correspondent aux candidats identifiés pendant l'étape de conception.
- [Polymorphisme] Les paramètres des constructeurs des superviseurs sont des types abstraits (interfaces ou classe abstraite)
- [Polymorphisme] PMD ne lève pas d'alerte LooseCoupling
- [Architecture] Les tests ArchUnit ne révèlent pas de problème d'architecture
Acquis 2 : Valider les comportements des objets programmés par des tests unitaires
Seuil de réussite (tous sont à valider pour obtenir l'acquis)
- Chaque classe du domaine est validée par une classe de test. Les classes de test sont définis dans le même package (mais dans le répertoire tests).
- L'ensemble des classes de test du domaine couvre au moins 90% des classes du domaine.
- Tous les tests unitaires des classes du domaine réussissent. (1 test en échec toléré)
Acquis 3 : Documenter son code
Seuil de réussite (tous sont à valider pour obtenir l'acquis)
- Les types et les méthodes publics sont documentés par de la javadoc inspirée par les énoncés (cf. PMD, 5 fautes tolérées)
- Les pré ou postconditions demandées figurent dans la javadoc, dans l’en-tête de la méthode , et les réponses concernent la classe est correcte.
- La CTT demandée est correctement (justifiées, avec le pire des cas si il existe, avec signification des vairables N, M, etc) évaluée dans la Javadoc de la classe
Acquis 4 : Justifier le choix d'une structure de données particulière
Seuil de réussite (tous sont à valider pour obtenir l'acquis)
- Les choix de type de collection sont correctement documentés dans le code pour les cases du terrain de jeu, dans la javadoc de la classe .
- Les choix d'implémentation sont correctement documentés dans le code pour les cases du terrain de jeu, dans la javadoc de la classe .
Degré de maitrise
Vérifiés SI tous les critères de seuil de réussite ont été observés pour affiner la cote
- PMD ne rélève aucun problème de méthode trop complexe et/ou trop longue
- Plus de 2 méthodes ou constructeurs appliquent le principes de copies défensives sur les collections
- Au moins 2 constructeurs ou méthode de fabrique valident leurs paramètres.
- PMD ne relève aucun problème de type data class ou god object
- Les méthodes ne faisant pas partie du diagramme de classe ou des diagrammes de collaboration sont private (voire protected)
- Le paquetage domain est couvert à 100% par les classes de tests du même package.
- La documentation de plusieurs méthodes fait état de précondition et de postcondition correctes
- Les collections sont utilisées sans réinventer la roue (pas de reprogrammation de méthodes existantes, ou de parcours séquentiel quand l'accès direct est prévu par exemple)
- Un plan de test exhaustif valide le code correspondant à la CTT demandée