Ce TD vise

1. à vous apprendre à mettre en place des tests d'intégration
2. à concevoir une petite application à plusieurs en prévoyant les tests d'intégration.

Si vous dépassez le temps passez à la suite et revenez dessus plus tard. L'énoncé suivant est issu du “getting started” de easyMock mis à jour pour travailler avec junit 5 et voir un peu plus de choses.

1. Voici le .jar dont vous avez besoin pour avoir accès à l'environnement EasyMock.
2. Pour l'ajouter à votre classpath du projet : sur le nom du projet > Properties > Java Build Path > Puis ajouter le .jar ci-dessus.
3. Voici l'interface dont dépendent vos codes, mais que vous ne devez pas implémenter.

   public interface Collaborator {
    
   	// if the document already exists, a "AlreadyAdded" exception is thrown.
   	// if the document fails to be added, false is return.
   	public boolean documentAdded(String title) throws AlreadyAdded   ;
   	public void documentRemoved(String title) ;
    
   }

   Et l'exception associée :

   public class AlreadyAdded extends Exception {
   } 

4. Voici vos codes (donc vous pouvez bien sûr les modifier si vous le voulez) et donc il s'agit bien de la classe à tester

   public class ClassTested {
    
   	public static  final String COPY = "_copy";
   	private Collaborator listener;
    
   	private HashMap<String, String> documents = new HashMap<>();
    
   	public void setListener(Collaborator listener) {
   		this.listener = listener;
   	}
    
   	public void addDocument(String title, String document) {
   		try {
   			if (listener.documentAdded(title) ) 
   				documents.put(title, document);
   		} catch (AlreadyAdded e) {
   			documents.put(title+COPY, document);
   		}
   	}
    
   	public void removeDocument(String title) {
   		listener.documentRemoved(title);
   	}
    
    
   	public Collaborator getListener() {
   		return listener;
   	}
    
   	public boolean isContained(String key) {
   		return documents.containsKey(key);
    
   	}
   }

5. Voici un début de tests.
   1. Remarquez la construction du mock (5.a)

       import static org.easymock.EasyMock.*;
      import static org.junit.Assert.assertFalse;
      import static org.junit.jupiter.api.Assertions.assertTrue;
       
      import org.easymock.EasyMockSupport;
      import org.easymock.Mock;
      import org.easymock.TestSubject;
      import org.junit.jupiter.api.BeforeEach;
      import org.junit.jupiter.api.Test;
       
       
       
      public class ExampleTest extends EasyMockSupport {
       
      	  @TestSubject
      	  private ClassTested classUnderTest = new ClassTested(); // 2
       
      	  @Mock
      	  private Collaborator mock; // 1
       
      	  @BeforeEach
      	  public void setUp() {
                      //5.a
      		mock = mock(Collaborator.class); 
      		classUnderTest = new ClassTested();
      		classUnderTest.setListener(mock);
      	  }
       

   2. Vous pouvez l'exécuter il ne se passe rien (il n'y a aucun test )
6. Ajoutez un test.

       @Test
   	  public void testRemoveNonExistingDocument() {
   	    // This call should not lead to any notification
   	    // of the Mock Object
   		  replay(mock); // 6.b
   		  classUnderTest.removeDocument("Does not exist");
   	  }

   1. Il échoue en effet on enregistre (6.b) que le mock ne reçoit aucun message alors que là il a reçu un message. Vous devrez donc avoir l'erreur suivante

       java.lang.AssertionError: 
        Unexpected method call Collaborator.documentRemoved("Does not exist"):...

7. Ajoutez un test, cette fois-ci juste :
   1. On déclare le message que doit recevoir le mock (7.a)
   2. On enregistre (7.b)
   3. On lance le test sur notre code (7.c)
   4. On explicite la vérification (réalisée par défaut) (7.d)

          @Test
      	  public void testRemoveNonExistingDocument2() {
      		  mock.documentRemoved("Does not exist"); //7.a
      		  replay(mock); //7.b
      		  classUnderTest.removeDocument("Does not exist"); //7.c
      		  verify(mock); //7.d
      	  }

8. Ajoutez un test, mais cette fois-ci nous explicitons la valeur de retour attendue et nous créons deux mocks pour nous assurer qu'il n'y a pas d'effets secondaires

   	  @Test
   	  public void testAddDocument() throws AlreadyAdded {
   		  //Initialisation
   		  Collaborator firstCollaborator = mock(Collaborator.class);//construction de mock
   		  Collaborator  secondCollaborator = mock(Collaborator.class);//construction de mock, il ne sera pas utilisé
   		  classUnderTest.setListener(firstCollaborator); 
    
   		  //// expect document addition
   		  expect(firstCollaborator.documentAdded("New Document")).andReturn(true); //On attend que le mock réponde True ! 
   		  replayAll(); //on enregistre le comportement de tous les Mocks
   		  classUnderTest.addDocument("New Document", "content");
   		  assertTrue(classUnderTest.isContained("New Document")); //on vérifie que NOS codes se comportent correctement
   		  verifyAll(); //On vérifie le comportement de tous les mocks
   	  }

9. Ajoutez un test, mais cette fois-ci nous attendons pour valeur de retour false

    	  @Test
   	  public void testFailingAddDocument() throws AlreadyAdded {
   		  //Initialisation
   		  Collaborator firstCollaborator = mock(Collaborator.class);
   		  Collaborator secondCollaborator = mock(Collaborator.class);
   		  classUnderTest.setListener(firstCollaborator); 
    
   		  //// expect document addition
   		  expect(firstCollaborator.documentAdded("New Document")).andReturn(false);
   		  replayAll();
   		  classUnderTest.addDocument("New Document", "content");
   		  assertFalse(classUnderTest.isContained("New Document"));
   		  verifyAll();
   	  }
    

10. et enfin nous testons une levée d'exception

     	  @Test
    	  public void testDuplicationWhenAddingDocument() throws AlreadyAdded {
    		  //Initialisation
    		  Collaborator firstCollaborator = mock(Collaborator.class);
    		  Collaborator secondCollaborator = mock(Collaborator.class);
    		  classUnderTest.setListener(firstCollaborator); 
     
    		  //// expect document addition
    		  expect(firstCollaborator.documentAdded("New Document")).andThrow(new AlreadyAdded());
    		  replayAll();
    		  classUnderTest.addDocument("New Document", "content");
    		  assertTrue(classUnderTest.isContained("New Document"+ClassTested.COPY));
    		  verifyAll();
    	  }

Cela conclut la partie tutorielle. A présent, vous devriez savoir créer vous même des tests d'intégration.

Vous devez réaliser en groupe de X étudiants un jeu de quizz dont voici la spécification.

• V0 : Version de base
  1. En tant que joueur, je veux répondre à une question du quizz TRES FORTE PRIORITE
     1. Si j'ai la bonne réponse je gagne 1pt
     2. Si je n'ai pas la bonne réponse, la bonne réponse m'est donnée.
     3. La vérification de la réponse ne dépend pas des minuscules ou majuscules
     4. ex :
        1. “Quelle est la capitale de la France”, je réponds PARIS, le jeu me félicite et m'annonce que j'ai gagné 1 pt
        2. “Quelle est la capitale de l'Espagne”, je réponds madrid … j'ai gagné 1 pt
        3. “Quelle est la capitale de l'Érythrée”, je réponds Assab, le jeu m'annonce que la bonne réponse est Asmara, je n'ai pas gagné de points
  2. En tant que joueur, je veux jouer une partie de quizz, de façon à m'amuser en vérifiant mes connaissances. FORTE PRIORITE

Un groupe a proposé l'an dernier les interfaces suivantes.

Voici un code pour tester un jeu.

1. Modélisez par groupe de 2 ou 3 étudiants, le jeu
   1. En particulier, intéressez aux interactions entre les classes.
   2. Une fois que vous êtes d'accord.
2. Développez séparément
   1. Etudiant 1 : Développez la classe Game sans développer la classe Quiz.
      1. Tester votre classe Game en utilisant des Mocks.
   2. Etudiant 2 : Développez la classe Quizz sans développer la classe Question.
      1. Tester votre classe Quizz en utilisant des Mocks

1. 10 questions sont posées au joueur
2. Seules des questions auxquelles le joueur n'a jamais répondu juste lui sont posées.
3. S'il n'y a plus assez de questions “nouvelles”, le joueur est invité à charger d'autres questions.
4. La partie est enregistrée à la fin de la partie, i.e. que si on interrompt la partie en cours de jeu, elle n'est pas enregistrée.
5. ex :
   1. Je lance une partie à mon nom
      1. 10 questions me sont posées et je réponds juste à 4 questions
      2. A la fin de la partie le système me signale que j'ai gagné 4 points et que la partie est enregistrée sous mon nom.
6. En tant que joueur, je veux consulter les différentes parties que j'ai réalisées, de façon à vérifier ma progression PRIORITE FAIBLE
7. Je peux voir les dates de parties, le nombre de points marqués par partie.
8. ex.
   1. Etant donné que J'ai joué 5 parties….
   2. Je visualise les 5 parties avec leur date et le nombre de points marqués.
   3. Je peux en savoir plus sur une partie : durée de la partie, et questions posées et mes réponses ….
9. En tant que producteur de questions, je veux pouvoir ajouter des questions à la base de questions PRIORITE MOYENNE
   1. Une question est composée d'une question et d'une réponse.
   2. On ne vérifie pas si la question existe déjà, on suppose que le producteur sait ce qu'il fait.
   3. ex.
      1. Etant donné que dans ma base, il y a déjà 3 questions.
      2. J'ajoute la question “Praia est la capitale de quel pays?” réponse Capt Vert
      3. Il y a 4 questions dans la base à présent dont ma nouvelle question.
10. En tant que joueur, je veux pouvoir charger de nouvelles questions PRIORITE MOYENNE
11. ex.
    1. Etant donné que j'ai déjà 3 questions dans ma base.
    2. Je charge la nouvelle série de questions datée du 27/10
    3. J'ai maintenant toutes les questions que j'avais avant plus les nouvelles questions.
    4. Attention les références aux questions ne sont pas perdues, i.e. que si j'ai déjà répondu à la question sur “la capitale de Paris”, la question ne me sera pas reposée.

• V1A : Plusieurs joueurs
• V1B : Des catégories de questions.
• V1C : Des difficultés de questions.
• V1D : Persistance : les questions sont stockées dans un fichier, de même pour les parties.

1. Conception : V0 (Environ 1/2 heure intense)
   1. Conseils
      • Concevez l'application V0 à deux (i.e. UC, Classes, un diagramme de séquence pour analyser le déroulement d'une partie est conseillé, MAIS ne faîtes que ce qui vous paraît vraiment utile)
      • Partagez le travail à réaliser
      • Prévoyez les tests à réaliser pour chacune des histoires, vous pouvez même faire du TDD
   2. Enrichissez les histoires si besoin pour être sûrs de savoir les tester.
   3. Sauvegardez une copie de votre conception quelle qu'elle soit : photo ou autre. Vous utiliserez cette conception pour faire le point à la fin entre votre travail initial et la réalisation. Vous ne serez pas noté dessus, vous devez apprendre à vous évaluer.
2. Vous pouvez à partir de là choisir de focaliser sur une histoire ou de traiter plusieurs histoires en même temps.
   1. Développement : V0
      • Développez le jeu en testant chacun individuellement vos classes et en utilisant les mocks pour les interactions.
   2. Intégration : V0
      • Mettez vos codes en commun
      • Testez une histoire et vérifier que vous pouvez dire qu'elle est terminée, c'est à dire que tous les tests passent.
      • Faîtes les tests sur toutes les histoires, soyez itératif.
   3. Faîtes une copie de votre architecture;
      1. vous la comparerez avec la précédente et la suivante. Il s'agit ici pour vous de
         1. déterminer si vous aviez fait des erreurs ou des incomplétudes,
         2. déterminer si vous saurez faire mieux la prochaine fois ou non, qu'avez-vous appris éventuellement?
         3. identifier les points que vous aimeriez améliorer (liste des TODO dans le code, le modèle, l'architecture).
3. V1 : Choisissez une extension, complétez éventuellement les histoires et allez jusqu'au code correspondant.
   1. reprendre la question précédente.
4. Si vous êtes ici et que vous en avez envie ajoutez une autre extension.

Pour Interroger vous pouvez utiliser:

import javax.swing.JOptionPane;
....
 String m = JOptionPane.showInputDialog("Anyone there?");
 System.out.println(m); // juste pour expliquer ici
 JOptionPane.showMessageDialog(null, "A oui, il y a quelqu'un");

1. Document
   1. faisant état de vos réponses aux points ; les derniers modèles seront considérés pour l'évaluation de l'architecture.
   2. d'une image de la couverture de tests finale
   3. Précisez les extensions réalisées.
2. Des codes et tests associés.

Rendus au plus tard le lundi 19 novembre à 18h45 sous http://jalon.unice.fr/cours/blay/Cours-blay-20150930110548/BoiteDepot-blay-20181113101132476393?mode_etudiant=true&tab=deposit

Voici le document qui sera utilisé pour l'évaluation (il peut encore changer) : https://goo.gl/forms/PmNPOPcurIKJLlo32