TP1 : Le patron Observer

IDrawable

Cette interface définit un type d'objet représentable dans la fenêtre de visualisation et les méthodes que ce type d'objet doit implémenter.

En particulier un tel objet doit pouvoir donner sa couleur, sa taille et définir une méthode paint pour être en mesure de se dessiner dans un JPanel.

Visualizer

Cette classe abstraite donne les principales méthodes permettant de représenter la fenêtre de visualisation. En outre, la classe définit également la signature d'une méthode abstraite permettant de récupérer un ensemble d'objet de type IDrawable ou hérités : getDrawables. 

Notez que les méthodes données ici sont implémentées pour gérer toutes les questions de positionnement dans le cadre du projet, vous n'aurez jamais à vous en soucier.0

IActionable

Cette interface permet de définir un type d'objet qui soit gérable par le moteur de simulation.

Pour correspondre à l'interface une classe doit nécessairement exposer une méthode act(), correspondant à l'activité de l'objet pendant un cycle de simulation.

Simulator

Cette classe définit un moteur de simulation générique. Le moteur est définit pour un type d'IActionable donné (dans notre cas, ICreature).

La classe contient la liste des objets à simuler (attribut actionables), un thread permettant l'exécution du moteur de simulation, d'un booléen gérant l'état de démarrage de la simulation (attribut running) et d'un dernier attribut pour gérer l'intervalle de temps entre chaque cycle d'exécution (attribut executionDelay).

La classe contient la méthode simulate qui permet d'activer chacun des objets de la simulation (via la méthode act()). La méthode start permet de démarrer la simulation via la création d'un thread. Notez que la méthode start peut être appelée avec un booléen afin d'afficher des informations de débug en console.

La classe a été implémentée de telle façon que la gestion du thread soit correcte, vous n'avez jamais à modifier l'implémentation du thread, ni à changer les attributs volatile ou les méthodes synchronized.

ICreature

Cette interface définit les méthodes qu'une créature doit exposer pour donner son environnement, sa vitesse, sa direction et sa position.

ICreature hérite de l'interface IActionable (voir package simulator) : une créature peut être simulée au sein du moteur de simulation. Elle hérite également de l'interface IDrawable (voir package visual) : une créature peut être représentée à l'écran. 

AbstractCreature

Une créature possède tous les attributs qui lui permettent de se positionner dans un environnement (position et environment), de se déplacer (speed et direction), d'interagir avec d'autres créatures (fieldOfView -> champ de vision et visionDistance) et d'être représentée à l'écran (size et color).

Elle possède également deux méthodes protégées (et donc accessibles dans les classes héritées) pour se mouvoir (move) et tourner (rotate). 

Enfin, une méthode permettant de dessiner la créature (selon sa taille et son champ de vision) est également fournie (paint).

StupidCreature

L'implémentation de cette créature consiste uniquement en l'implémentation de la méthode act() requis par l'interface IActionable. Dans le cadre de la StupidCreature, cette méthode fait se déplacer la créature en utilisant sa vitesse et sa direction.