Exercices de Java, module 350 pour l'IPI. Il est nécessaire de forker ce repository pour pouvoir faire tout le TP !! Après chaque question, pusher vos modifications sur votre repository.

• Installer IntelliJ Ultimate en utilisant votre adresse IPI sur Jetbrains Student https://www.jetbrains.com/student/ ou un autre IDE si vous avez l'habitude (Eclipse)
• Si vous n'êtes pas familié avec Git, je vous recommande ce site : https://learngitbranching.js.org/ (faire au moins la première leçon du niveau 1) Via Microsoft Imagine, activer votre crédit étudiant Azure https://imagine.microsoft.com/fr-fr (ou via le mail reçu en début d'année, onthehub https://onthehub.com/)
• S'inscrire également au programme AWS Educate toujours avec votre adresse IPI (https://aws.amazon.com/fr/education/awseducate/).

Questions à se poser :

• Que représente pour vous la qualité logicielle ?
• Quels éléments faut-il pour avoir un logiciel de qualité ?
• Dans un projet, qui est responsable de la qualité ?
• Quand doit-on se préoccuper de la qualité dans la vie d'un projet ?

Faire une recherche sur la qualité logicielle sur le web... Répondre de nouveau aux questions. Qu'est-ce qui a changé ?

1. Ajoute à la racine du dossier, un fichier .travis.yml
2. Ajouter dans ce fichier : les paramètres de config (language: java)
3. Pushez le projet sur Git
4. Se connecter sur https://travis-ci.com/
5. Allez dans Setting et activer l'intégration GitHub Apps
6. Sélectionner votre repository
7. Cliquer sur Sync account
8. Cliquer sur Trigger build dans la liste d’options du build s'il ne se lance pas tout seul
9. Patienter le temps du lancement du build
10. Après chaque exercice, vérifier que le build passe toujours...

1. Aller sur https://sonarcloud.io/
2. Se connecter en liant son compte Github
3. Cliquer sur New project.
4. Sélectionner le repository correspodnant
5. Cliquer sur Analyse new project
6. Cliquer Create a project manually
7. Créer le token puis le récupérer en le copiant
8. Dans Travis, aller dans environnement variables
9. SONAR_TOKEN > le token > Add
10. Récupère le code yml qu'il faut ajouter dans le .travis.yml (attention à bien copier ce qui est à l'écran, pas à cliquer sur le bouton Copy)
11. Pushez puis relancer votre build sur Travis-ci.com
12. Analyser le premier rapport de Sonar

Créer la classe permettant de tester la méthode getNombreAnneeAnciennete de la classe Employe et mettre en place les tests unitaires nécessaires pour tester le plus exhaustivement possible cette méthode. Bien penser à tous les cas possibles, notamment les cas aux limites. Ne pas hésiter à corriger le code de la méthode initiale si besoin.

Créer une méthode de test paramétré permettant de tester le plus exhaustivement possible la méthode getPrimeAnnuelle de la classe Employe et corriger les éventuels problème de cette méthode.

Créer la classe de test et les méthodes permettant de tester la méthode embaucheEmploye de EmployeService sans la dépendance à la BDD.

Créer la classe de test et les méthodes permettant de tester la méthode findLastMatricule de EmployeRepository.

Tester de façon intégrée un cas nominal de la méthode embaucheEmploye de la classe EmployeService.

• Installer Gauge depuis https://gauge.org/. La méthode d'installation recommandée est via npm. Il faut donc installer NodeJS. D'autres méthodes sont possibles cependant.
• Ajouter le chemin de l'exécutable Gauge dans la variable d'environnement PATH. Vous pouvez utiliser la commande where gauge dans une invite de commande Windows, ou which gauge dans un terminal Linux.
• À l'aide d'un terminal, vous positionner à la racine de votre projet Java et initialiser (à l'aide de la documentation) un nouveau projet Gauge Java. Déplacer le dossier specs dans le dossier src/test/resources.
• Un projet d'exemple de Gauge avec Spring se trouve à cette adresse : https://github.com/getgauge-examples/ioc-spring
• Récupérer les classes RegisterIOC et SpringGaugeTestApp et les intégrer dans votre projet. Vous inspirer de la classe PaymentService pour ajouter les Step nécessaires pour écrirer un test d'acceptation validant la fonctionnalité d'embauche d'un employé.

• S'assurer de la lisibilité du code et du respect des conventions.
• Ajouter des logger aux endroits stratégiques du code en utilisant le bon niveau de log. Rediriger toutes les logs d'erreur dans un fichier error.log et tous vos logs dans un fichier logs.log. Ajouter la configuration de rotation tous les jours et faire en sorte que les fichiers ne puissent dépasser 10Mo.
• Vérifier et le cas échéant compléter la documentation du code, générer la JavaDoc avec maven.
• Ajouter à votre Github une documentation statique avec MkDocs.
• Ajouter des badges contenant les métriques principales de votre projet en haut de ce README à l'aide de l'API de Sonar : https://sonarcloud.io/web_api/api/project_badges

Commencer par faire une branche evaluation à partir de votre branche master une fois le TP terminé. Travailler sur cette branche pour l'évaluation.

• Tester de manière unitaire le plus exhaustivement possible la méthode augmenterSalaire d'Employe en essayant de faire du TDD. Décommenter la méthode dans Employe et écrire d'abord les tests entièrement (en réflechissant particulièrement aux cas limites) avant d'écrire la méthode. Pensez-vous que vous auriez écrit la méthode directement comme cela si vous n'aviez pas écrit les tests en premier ?

• Tester unitairement (en utilisant les tests paramétrés) la méthode getNbRtt d'Employe. Le nombre de RTT se calcule à partir de la formule suivante : Nombre de jours dans l'année - Nombre de jours travaillés dans l'année en plein temps - Nombre de samedi et dimanche dans l'année - Nombre de jours fériés ne tombant pas le week-end - Nombre de congés payés. Le tout au pro-rata du taux d'activité du salarié. Attention, des erreurs sont présentes dans cette méthode. Faites donc vos calculs avant et débugguer votre code pour trouver les erreurs. Aidez-vous de Sonar... Rendre cette méthode plus propre, documentée et lisible. Infos :

  • 2019 : l'année est non bissextile, a débuté un mardi et il y a 10 jours fériés ne tombant pas le week-end.
  • 2021 : l'année est non bissextile, a débuté un vendredi et il y a 7 jours fériés ne tombant pas le week-end.
  • 2022 : l'année est non bissextile, a débuté un samedi et il y a 7 jours fériés ne tombant pas le week-end.
  • 2032 : l'année est bissextile, a débuté un jeudi et il y a 7 jours fériés ne tombant pas le week-end.

• Tester sans dépendance à la BDD la méthode calculPerformanceCommercial d'EmployeService

• Tester de manière intégrée une cas nominal de la méthode précédente
• Tester de manière intégrée la méthode d'EmployeRepository avgPerformanceWhereMatriculeStartsWith
• BONUS Ecrire un test d'acceptation Gauge pour la fonctionnalité de calcul de performance d'un commercial.

• S'assurer que votre code passe et qu'il n'y a aucun code smells ou anomalies ou bugs bloquants, critiques ou majeurs. Si c'est le cas, corriger le code fourni.
• S'assurer d'avoir 100% de couverture de code sur les méthodes testés dans l'évaluation. Vérifier la couverture de code avec mutation et à défaut d'atteindre 100%, essayer d'obtenir un bon niveau.

En fin de TP, créer une Pull Request de votre branche evaluation vers master et mettez-vous d'accord avec un collègue pour qu'il fasse la revue de code. Faites les éventuelles modifications puis affectez-moi la PR.