Classes : modélisation et codage

Objectifs :

1. Faire un lien direct entre la modélisation des classes et les codes correspondants.
2. Savoir construire un petit modèle de classes et le mettre en oeuvre.

Un taille haie est caractérisé par

• sa cadence de coupe, typiquement 4500 coupes/minute;
• switchOn()+: méthode qui allume l’outil et fixe la cadence à 4500;
• switchOff()+: méthode qui éteint l’outil et fixe la cadence à 0.

1. Dessiner la représentation UML de cette classe.
2. Générer ou écrivez le code java correspondant à cette classe. On prévoira un constructeur ¹⁾ qui initialise le tailleHaie dans l’état éteint, avec une cadence de 0²⁾. Les exceptions levées dans le corps des méthodes générées permettent de signaler les méthodes encore non implémentées. Vous devez retirer les levées d'exception en implémentant les méthodes.
3. On veut pouvoir connaître la cadence du TailleHaie.
4. Tester votre code. Si vous n'avez pas encore vu la notion de Test en java vous pouvez mettre vos tests dans une classe dédiée comportant un main et votre test peut ressembler à ce qui suit.

public class TestOutils {
 
	public static void main(String[] args) {
		TailleHaie monTailleHaie = new TailleHaie();
		System.out.println("Taille Haie crée : " + monTailleHaie);
		System.out.println("==> Test init : " + (monTailleHaie.getCadence() == 0) );
		monTailleHaie.switchOn();
		System.out.println("Cadence du Taille Haie en fonctionnement : " + monTailleHaie.getCadence());
		System.out.println("==> Test fonctionnement : " + (monTailleHaie.getCadence() == 4500) );
		monTailleHaie.switchOff();
		System.out.println("Cadence du Taille Haie à l'arret : " + monTailleHaie.getCadence());
		System.out.println("==> Test Arret : " + (monTailleHaie.getCadence() == 0) );
 
	}
 
}

Sinon utilisez de préférence des tests unitaires, comme dans l'exemple di-dessous.

import org.junit.Before;
import org.junit.Test;
 
public class TailleHaieTest {
 
    TailleHaie trimmer;
 
    @Before
    public void setUp() throws Exception {
        trimmer = new TailleHaie();
    }
 
    @Test
    public void init() throws Exception {
        assertEquals("Taille haie a une cadence initiale de 0",0, trimmer.getCadence());
    }
    @Test
    public void switchOn() throws Exception {
        trimmer.switchOn();
        assertEquals("Taille haie a une cadence de 4500",4500, trimmer.getCadence());
    }
    @Test
    public void switchOff() throws Exception {
        trimmer.switchOn();
        trimmer.switchOff();
        assertEquals("Taille haie éteinte",0, trimmer.getCadence());
    }
}

Sur le même modèle, une tondeuse est caractérisée par

• la vitesse de rotation de sa lame, typiquement 1000 Tour/minute;
• une cadence;
• switchOn()+: méthode qui allume l’outil et fixe la cadence à 1000;
• switchOff()+: méthode qui éteint l’outil et fixe la cadence à 0.

1. Dessiner la représentation UML de cette classe et continuez comme précédemment.
2. Que constatez-vous? Quels sont les éléments communs? Ne pourrait-on pas “partager” des informations?
3. Ecrivez vos tests dans la même classe que précédemment et attention ils doivent tous continuer à fonctionner. Vous pouvez par exemple ajouter les lignes suivantes.

System.out.println("=========================TESTS TONDEUSE===================");
Tondeuse maTondeuse = new Tondeuse();
System.out.println("Tondeuse crée : " + maTondeuse);
System.out.println("==> Test init : " + (maTondeuse.getCadence() == 0) );
maTondeuse.switchOn();
System.out.println("Cadence de Tondeuse en fonctionnement : " + maTondeuse.getCadence());
System.out.println("==> Test fonctionnement : " + (maTondeuse.getCadence() == 1000) );
maTondeuse.switchOff();
System.out.println("Cadence de Tondeuse à l'arret : " + maTondeuse.getCadence());
System.out.println("==> Test Arret : " + (maTondeuse.getCadence() == 0) );

1. Mettez en facteur les éléments qui peuvent l'être dans la modélisation UML en ajoutant une classe OutilElectrique.
2. Pour les plus avancés, en fonction de vos choix, déterminez s'il s'agit d'une classe abstraite ou non. ⁴⁾
3. Modifier la modélisation et les codes en conséquence.⁵⁾
4. Réécrire en conséquence les classes TailleHaie et Tondeuse.
5. Relancer vos tests sans les modifier! Ils doivent toujours fonctionner!

		System.out.println("=========================TESTS TONDEUSE ETENDU ===================");
		//La tondeuse a plusieurs vitesses de traction possibles : arret, lent, moyenne ou rapide. 
		maTondeuse.switchOff();
		System.out.println("Vitesse de Tondeuse à l'arret attendue "+ Vitesse.arret +"==>" + maTondeuse.getVitesse());
		//Il est possible de changer la vitesse de la tondeuse. 
		maTondeuse.switchOn();
		System.out.println("Vitesse de Tondeuse au démarrage attendue "+ Vitesse.moyen +"==>" + maTondeuse.getVitesse());
		maTondeuse.setVitesse(Vitesse.rapide);
		System.out.println("Vitesse de Tondeuse attendue "+ Vitesse.rapide +"==>" + maTondeuse.getVitesse());
		//Au démarrage, sa vitesse est toujours à l'arrêt. Lorsque l'on éteint la tondeuse sa vitesse passe à arrêt.
		maTondeuse.switchOff();
		System.out.println("Vitesse de Tondeuse à l'arret attendue "+ Vitesse.arret +"==>" + maTondeuse.getVitesse());
		maTondeuse.setVitesse(Vitesse.rapide);
		maTondeuse.switchOn();
		System.out.println("Vitesse de Tondeuse au démarrage attendue (alors que on a modifie sa vitesse "+ Vitesse.moyen +"==>" + maTondeuse.getVitesse());
		maTondeuse.switchOff();

Il s'agit de développer à présent un robot “Jardinier”. On peut donner un outil à un jardinier, lui demander de travailler ou d'arrêter de travailler.

• Nos robots ont tous un nom qui leur est donné à la création. Il n'est pas possible de le modifier par la suite.
• Si on donne un outil au jardinier alors qu'il en a déjà un, il prend le nouvel outil et relâche l'ancien outil.
• Si on lui demande de travailler sans lui avoir donné d'outil, il répond par “Donnez-moi un outil!”. S'il a un outil en main, il le démarre et répond par “Je démarre ” suivi de la description de l'outil démarré.
• Si on lui demande d'arrêter de travailler, il répond par “Merci, la journée a été dure!”. S'il a un outil en main, il l'arrête et le “lâche”.

1. Donner une représentation UML du problème du Jardinier.
2. Générer les codes correspondants. Si les résultas ne vous satisfont pas, corriger votre modèle. En particulier, vous devrez utiliser la navigation entre les classes.
3. Compléter les codes correspondants.
4. Eventuellement par reverse-engineering, reconstruisez votre modèle.
5. Evidemment tester votre programme. Voici un exemple de trace possible à l'exécution des tests.

=========================TESTS Jardinier ===================
Bonjour Je suis R2-D2 : je n'ai pas d'outil 
Début  du travail pour le jardinier : Donnez-moi un outil!
On lui a donné la tondeuse : Je suis R2-D2, je tiens : Tondeuse [vitesse=arret, cadence=0]
Debut du travail pour le jardinier : Je démarre : Tondeuse [vitesse=moyen, cadence=1000]
Arret du travail pour le jardinier : Merci, la journée a été dure!
	 La tondeuse doit être à l'arrêt : Tondeuse [vitesse=arret, cadence=0]
	 Le jardinier n'a plus d'outil : Je suis R2-D2 : je n'ai pas d'outil

1. Et si nous voulions représenter plusieurs sortes de Robot, que ferions-nous? Et si tout robot était un Outil Electrique ?

Pour vous aider :

• Vous ne pouvez pas modifier le nom du Jardinier donc vous devez lui donner un nom à la création, pour cela vous créez un constructeur :

   public class Jardinier{
        // Un constructeur qui prend le nom en parametre
	public Jardinier(String nom) {
		this.nom = nom;
	}

• Pour créer un jardinier maintenant, vous devez lui donner un nom.

Jardinier monJardinier = new Jardinier("R2-D2");

• Pour visualiser un objet java, vous pouvez redéfinir son affichage en implémenentant une méthode String ToString() par exemple :

	public String toString() {
		String s = "Je suis " +  nom ;
		if (outil== null)
			s += " : je n'ai pas d'outil ";
		else
			s += ", je tiens : " +  outil ;
		return s;
	}

A présent notre robot peut utiliser un véhicule.

Un véhicule a une position (X, Y en entier). Il peut se déplacer sur l'axe des x ou des y. Il peut être initialisé, ce qui le place en position (0,0).

Un charriot est un véhicule qui se déplace d'un delta de 10 à chaque demande de déplacement : s'il est en (0,0), déplacer le chariot sur X l'amène en (10,0), puis en déplacement sur XY l'amène en (20,10).

Une fusee est un véhicule qui se déplace d'un delta de 100 à chaque demande de déplacement.

1. Définissez les classes et les codes associés.
2. Si à présent nous voulons modifier une position de delta sur l'axe des X, des Y, en diagonale, que faîtes-vous?
3. Si nous voulons à présent que notre véhicule soit repéré par des coordonnées GPS ou polaires au lieu de coordonnées cartésiennes… Que devez_vous modifier?

===================TESTS Vehicules ===================
Chariot => Vehicule [position=[0,0]]
Avance sur X, position attendue [10,0] : true
Avance sur Y, position attendue  [10,10]: true
Fusee => Vehicule [position=[0,0]]
Avance sur position attendue [100,0]  : true
Avance sur position attendue [100,100]  : true

On peut donner un véhicule au robot. Il l'initialise quand il le reçoit. On peut demander au robot de se déplacer selon un schéma donné : “XYXX”⁶⁾. Le robot déplacera alors le véhicule de X puis de Y puis de X puis de X.

Quand le robot arrête de travailler il ramène le véhicule en position initiale.

Voici un exemple de trace obtenue en testant ce qui est demandé.

===================TESTS jardinier & Vehicules ===================
Pas de vehicule : Je suis R2-D2 : je n'ai pas d'outil  je n'ai pas de vehicule 
Avec un charriot : Je suis R2-D2 : je n'ai pas d'outil , j'ai ce vehicule Chariot => Vehicule [position=[0,0]]
Deplacement du jardinier en XYX, on attend (0,0),(10,0) (10,10) (20,10) 
Nouvelle position attendue [20,10]  : true


Avec une fusee : Je suis R2-D2 : je n'ai pas d'outil , j'ai ce vehicule Fusee => Vehicule [position=[0,0]]
Deplacement du jardinier en XYX, on attend (0,0),(100,0) (100,100) (200,100) 
Nouvelle position attendue [200,100]  : true

Définir un code qui correspond au début de scénario ci-dessus.

Nous sommes très content de notre robot jardinier. Nous décidons de construire un robot facteur.

Il transporte des courriers.

Suivez l'énoncé pas à pas. Il est écrit ainsi pour vous aider. Des exemples de tests sont donnés pour vous aider, en particulier à définir les méthodes associées à vos classes.

Un courrier est défini par une adresse et un contenu. Pour des raisons de confidentialité, une fois créé, si on demande l'adresse ou le contenu du courrier, on obtient un texte illisible : il est crypté en utilisant un encrypteur donné plus bas et une clef donnée à la construction du courrier.

Voici le modèle correspondant à la classe “Encryptor”

Le courrier ne contient pas le texte initial, ni la clef de cryptage. Elles sont seulement connues à la création du courrier. On ne peut pas modifier l'adresse ou le contenu d'un courrier.

Exemple de tests et de trace :

String adresseOrigine = "Avenue Fabron, Nice";
Courrier mail = new Courrier(adresseOrigine,"Bravo ", 3);
System.out.println("Courrier adresse illisible " + mail.getAdresse());
System.out.println("Courrier contenu illisible " + mail.getContenu());			

  ===================TESTS Courrier ===================
 Courrier adresse illisible rEV]FVuRQA\]}ZPV
 Courrier contenu illisible qARE\

QUESTIONS

1. Commencer par créer la classe Encriptor en recopiant “simplement” le code donné plus bas.
2. Regarder le code de tests de courrier :
   1. A quoi correspond d'après vous le 3 ?
   2. Pourquoi la réponse à getAdresse est-ce un texte crypté?
3. Dans l'ordre que vous voulez, répondez à ces deux questions, et tester votre code.
   1. Quel est le modèle de la classe Courrier?
   2. Quel est son code ?

Pour lire le courrier il faut utiliser un décrypteur, c'est un outil électrique. Quand il est allumé, si on lui présente un courrier, et on lui donne la clef, il nous donne l'adresse en claire, sinon il renvoie l'adresse telle que.

Exemple de tests et de trace :

Decryptor decryptor = new Decryptor();
System.out.println("pas de lecture si non demarre " + decryptor.readAddress(mail,3));
decryptor.switchOn();
System.out.println("lecture efficiente " +  decryptor.readAddress(mail,3) + " : " + decryptor.readAddress(mail,3).equals(adresseOrigine) );

===================TESTS Decrypteur ===================
pas de lecture si non demarre rEV]FVuRQA\]}ZPV
lecture efficiente : Avenue Fabron, Nice : true

QUESTIONS

1. Quelles sont les méthodes de la classe Decryptor ? Quelle est la relation entre Decryptor et OutilElectrique ?
2. La classe Decryptora besoin de créer un Encyptor à chaque appel en lecture en lui passant la bonne clef.
3. Implémenter la classe Decryptor.

Notre robot facteur peut avoir un véhicule pour se déplacer et un décrypteur pour lire le courrier. Quand on lui remet un courrier, on lui donne la clef pour lire le courrier.

Exemple de tests et de trace simple:

System.out.println("===================TESTS Facteur ===================");
Facteur facteur = new Facteur("Hermes");
//Une distribution simple
facteur.distribue(mail,3);
String adresse = facteur.lire();
System.out.println("Je dois aller à " + adresse);
facteur.setVehicule(charriot);
facteur.deplacer("XXYYY");
Courrier courrierDepose = facteur.depose();
System.out.println("Courrier" + courrierDepose +" deposé à l'adresse : " + adresse );
System.out.println("Je suis en  [20,30]: " + charriot.getPosition());

Je dois aller à Avenue Fabron, Nice
CourrieroutilsPK.Courrier@511d50c0 deposé à l'adresse : Avenue Fabron, Nice
Je suis en  [20,30]: [20,30]
Je dois aller à Avenue Fabron, Nice
Courrier deposé à l'adresse : Avenue Fabron, Nice
Je suis en  [20,30]: [20,30]

QUESTIONS

1. Quel est le modèle de la classe Facteur?
2. Quelles sont les méthodes que doit avoir un Facteur?
3. Qu'ont en commun un Facteur et un Jardinier?
4. Implémenter la classe Facteur
5. Le facteur a-t-il bien lâché le courrier une fois déposé ? Que faîtes-vous si vous demandez au facteur de lire le courrier alors qu'il n'en a plus ? Par exemple :

 
adresse = facteur.lire();
System.out.println("Je dois aller à " + adresse);

Je dois aller à Rentre chez toi

Evidemment notre facteur ne distribue pas un seul courrier.

Exemple de tests et de trace :

System.out.println("===================TESTS Facteur ===================");
//3 courriers sont remis à notre facteur avec pour chacun la clef pour lire leur adresse.	
Courrier c2 = new Courrier("Petit Prince Planete","Je veux etre ton ami ",2);
Courrier c3 = new Courrier("Pere Noel","Je voudrais un robot voyageur ",5);

Facteur facteur = new Facteur("Hermes");
facteur.distribue(mail,3);
facteur.distribue(c2,2);
facteur.distribue(c3,2);
		
String adresse = facteur.lire();
System.out.println("Je dois aller à " + adresse);
facteur.setVehicule(charriot);
facteur.deplacer("XXYYY");
Courrier courrier = facteur.depose();
System.out.println("Courrier deposé à l'adresse : " + adresse );
System.out.println("Je suis en  [20,30]: " + charriot.getPosition());
		
adresse = facteur.lire();
System.out.println("Je dois aller à :" + adresse);
System.out.println("Je prends ma fusee");
facteur.setVehicule(fusee);
facteur.deplacer("XYXYXYXYXYXYXY");
courrier = facteur.depose();
System.out.println("Courrier depose à l'adresse " + adresse);
System.out.println("Je suis en [700,700] : " + fusee.getPosition());
		
adresse = facteur.lire();
System.out.println("Je dois aller à : " + adresse);
System.out.println("Je ne comprends pas, même pas capable de me donner la bonne clef!");
facteur.depose();
System.out.println("Courrier perdu ");
System.out.println("Je suis toujours en [700,700] : " + fusee.getPosition());
		
adresse = facteur.lire();
System.out.println("J'ai fini :  " + adresse);

===================TESTS Facteur ===================
Je dois aller à Avenue Fabron, Nice
Courrier deposé à l'adresse : Avenue Fabron, Nice
Je suis en  [20,30]: [20,30]
Je dois aller à : Petit Prince Planete
Je prends ma fusee
Courrier depose à l'adresse Petit Prince Planete
Je suis en [700,700] : [700,700]
Je dois aller à :Wbub'Ihbk
Je ne comprends pas, même pas capable de me donner la bonne clef!
Courrier perdu 
Je suis toujours en [700,700] : [700,700]
J'ai fini :  Rentre chez toi

QUESTIONS

1. Que devez-vous modifier pour que le Facteur remplisse bien son rôle ?
2. Améliorer la classe Facteur

Voici le code pour crypter il est basé sur : un code qui ne prend pas de clef, ici à la construction de l'“Encrypteur” on lui passe une clef qui est évidemment secrète.

public class Encryptor {
 
	  private final int key;
 
	  public Encryptor(int key) {
		super();
		this.key = key;
	}
 
 
	public String encrypt(String password){
	        String crypte="";
	        for (int i=0; i<password.length();i++)  {
	            int c=password.charAt(i)^(48 + key);  
	            crypte=crypte+(char)c; 
	        }
	        return crypte;
	    }
 
 
      public String decrypt(String password){
	        String aCrypter="";
	        for (int i=0; i<password.length();i++)  {
	            int c=password.charAt(i)^(48 + key);  
	            aCrypter=aCrypter+(char)c; 
	        }
	        return aCrypter;
	    }
 
 
}

Exemple de tests de l'encryptor :

              Encryptor d = new Encryptor(2);
	String origine = "Avenue Fabron, Nice";
	String sCryptee = d.encrypt(origine);
	System.out.println("Pas lisible " + sCryptee);
	String r = d.decrypt(sCryptee);
	System.out.println(r  + " : " + r.equals(origine));