From 957591d90e685c8dae4a1d2237c94a0037aeb87b Mon Sep 17 00:00:00 2001 From: Justine Yannis Date: Mon, 17 Oct 2022 21:08:10 +0200 Subject: [PATCH] =?UTF-8?q?D=C3=A9but=20commentaire=20javadoc,=20suppressi?= =?UTF-8?q?on=20redondances=20et=20lignes=20inutiles,=20erreur=20dans=20Ma?= =?UTF-8?q?kefile?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- projetAgile/Makefile | 3 +- .../Controller/GrilleMouseListener.java | 8 +++-- .../Event/AbstractGridInitiater.java | 29 +++++++++++++++++-- .../Event/GridChangedListener.java | 8 +++++ .../projetAgile/Event/GridEvent.java | 18 ++++++++++++ .../projetAgile/Event/PlayerEvent.java | 14 ++++++++- .../fr/iutfbleau/projetAgile/View/Grille.java | 9 ------ 7 files changed, 73 insertions(+), 16 deletions(-) diff --git a/projetAgile/Makefile b/projetAgile/Makefile index e0cad95..1efad1b 100644 --- a/projetAgile/Makefile +++ b/projetAgile/Makefile @@ -49,8 +49,9 @@ build/$(PACKAGE_PATH)/Controller/GrilleMouseListener.class : src/$(PACKAGE_PATH) build/$(PACKAGE_PATH)/Controller/ModelEventListener.class : src/$(PACKAGE_PATH)/Controller/ModelEventListener.java \ build/$(PACKAGE_PATH)/Event/GridChangedListener.class \ + build/$(PACKAGE_PATH)/View/Grille.class \ $(Event) - build/$(PACKAGE_PATH)/View/Grille.class + javac $(JAVAC_OPT) $< #------- Modele ------ diff --git a/projetAgile/src/fr/iutfbleau/projetAgile/Controller/GrilleMouseListener.java b/projetAgile/src/fr/iutfbleau/projetAgile/Controller/GrilleMouseListener.java index 3257236..69c42ae 100644 --- a/projetAgile/src/fr/iutfbleau/projetAgile/Controller/GrilleMouseListener.java +++ b/projetAgile/src/fr/iutfbleau/projetAgile/Controller/GrilleMouseListener.java @@ -10,13 +10,17 @@ public class GrilleMouseListener extends MouseInputAdapter{ private Grille grille; private GrilleModel modele; - + /** + * Listener de la vue qui change le modèle lors des actions des utilisateurs + * @param grille La vue + * @param modele Le modèle + */ public GrilleMouseListener(Grille grille, GrilleModel modele) { this.grille = grille; this.modele = modele; this.grille.init(this.modele.getTab()); } - + @Override public void mousePressed(MouseEvent e) { if(e.getButton() == MouseEvent.BUTTON1) { diff --git a/projetAgile/src/fr/iutfbleau/projetAgile/Event/AbstractGridInitiater.java b/projetAgile/src/fr/iutfbleau/projetAgile/Event/AbstractGridInitiater.java index 5433c4d..fc7b046 100644 --- a/projetAgile/src/fr/iutfbleau/projetAgile/Event/AbstractGridInitiater.java +++ b/projetAgile/src/fr/iutfbleau/projetAgile/Event/AbstractGridInitiater.java @@ -5,18 +5,36 @@ public abstract class AbstractGridInitiater { protected EventListenerList listeners = new EventListenerList(); + /** + * Ajoute le listener donné en argument à la liste des listes + * @param listener Le listener a ajouté + */ public void addGridListener(GridChangedListener listener) { listeners.add(GridChangedListener.class, listener); } - - public void removeTGridListener(GridChangedListener listener) { + + /** + * Supprime le listener donné en argument de la liste des listeners + * @param listener Le listener a supprimer + */ + public void removeGridListener(GridChangedListener listener) { listeners.remove(GridChangedListener.class, listener); } - + + /*** + * Retourne un tableau de tous les listeners + * @return Le tableau de listeners + */ public GridChangedListener[] getGridListeners() { return listeners.getListeners(GridChangedListener.class); } + /** + * Notifie tous les listeners lorsque la grille est modifié + * @param column la colonne modifié + * @param row la ligne modifié + * @param player le joueur qui a joué + */ protected void fireGridChanged(int column, int row, int player) { GridEvent event = null; for(GridChangedListener listener : getGridListeners()) { @@ -26,6 +44,11 @@ public abstract class AbstractGridInitiater { } } + /** + * Notifie tous les listeners lorsque le tour du joueur change + * @param oldPlayer L'ancien joueur qui jouait + * @param newPlayer Le nouveau joueur qui joue + */ protected void firePlayerChanged(int oldPlayer, int newPlayer) { PlayerEvent event = null; for(GridChangedListener listener : getGridListeners()) { diff --git a/projetAgile/src/fr/iutfbleau/projetAgile/Event/GridChangedListener.java b/projetAgile/src/fr/iutfbleau/projetAgile/Event/GridChangedListener.java index 220df78..1c54a4a 100644 --- a/projetAgile/src/fr/iutfbleau/projetAgile/Event/GridChangedListener.java +++ b/projetAgile/src/fr/iutfbleau/projetAgile/Event/GridChangedListener.java @@ -3,7 +3,15 @@ package fr.iutfbleau.projetAgile.Event; import java.util.EventListener; public interface GridChangedListener extends EventListener{ + /** + * Méthode invoqué lorsque la grille est modifié + * @param e Evenement contenant la colonne, ligne et joueur du pion placé dans la grille + */ void gridChanged(GridEvent e); + /** + * Méthode invoqué lorsque le tour du joueur est modifié + * @param e Evenement contenant l'ancien joueur et le nouveau + */ void playerChanged(PlayerEvent e); } diff --git a/projetAgile/src/fr/iutfbleau/projetAgile/Event/GridEvent.java b/projetAgile/src/fr/iutfbleau/projetAgile/Event/GridEvent.java index 366fd5d..5c5345b 100644 --- a/projetAgile/src/fr/iutfbleau/projetAgile/Event/GridEvent.java +++ b/projetAgile/src/fr/iutfbleau/projetAgile/Event/GridEvent.java @@ -5,20 +5,38 @@ public class GridEvent { private int row; private int player; + /** + * Evenement représentant le changement dans la grille + * @param column la colonne modifié + * @param row la ligne modifié + * @param player le joueur qui a joué + */ public GridEvent(int column, int row, int player) { this.column = column; this.row = row; this.player = player; } + /** + * Retourne la colonne modifié + * @return La colonne modifié + */ public int getColumn() { return this.column; } + /** + * Retourne la ligne modifié + * @return la ligne modifié + */ public int getRow() { return this.row; } + /** + * Retourne le joueur qui a joué + * @return Le joueur qui a joué + */ public int getPlayer() { return this.player; } diff --git a/projetAgile/src/fr/iutfbleau/projetAgile/Event/PlayerEvent.java b/projetAgile/src/fr/iutfbleau/projetAgile/Event/PlayerEvent.java index 586626a..2273fac 100644 --- a/projetAgile/src/fr/iutfbleau/projetAgile/Event/PlayerEvent.java +++ b/projetAgile/src/fr/iutfbleau/projetAgile/Event/PlayerEvent.java @@ -4,16 +4,28 @@ public class PlayerEvent { private int oldPlayer; private int newPlayer; - + /** + * Evenement représentant le changement de tour des joueurs + * @param oldPlayer l'ancien joueur + * @param newPlayer le nouveau joueur + */ public PlayerEvent(int oldPlayer, int newPlayer) { this.newPlayer = newPlayer; this.oldPlayer = oldPlayer; } + /** + * Retourne le nouveau joueur + * @return Le nouveau joueur + */ public int getNewPlayer() { return newPlayer; } + /** + * Retourne l'ancien joueur + * @return L'ancien joueur + */ public int getOldPlayer() { return oldPlayer; } diff --git a/projetAgile/src/fr/iutfbleau/projetAgile/View/Grille.java b/projetAgile/src/fr/iutfbleau/projetAgile/View/Grille.java index 5f11535..3891bab 100644 --- a/projetAgile/src/fr/iutfbleau/projetAgile/View/Grille.java +++ b/projetAgile/src/fr/iutfbleau/projetAgile/View/Grille.java @@ -43,19 +43,10 @@ public class Grille extends JPanel{ grille[x][y] = pion; } } - - int minimumWidth = this.column * Pion.getPionMinimumSize().width; - int minimumHeight = this.row * Pion.getPionMinimumSize().height; - int preferredWidth = this.column * Pion.getPionPreferredSize().width; - int preferredHeight = this.row * Pion.getPionPreferredSize().height; - - this.setMinimumSize(new Dimension(minimumWidth, minimumHeight)); - this.setPreferredSize(new Dimension(preferredWidth, preferredHeight)); } public void addPlayerPiece(int column, int row, int player) { - Color c = player == Constants.PLAYER_ONE ? Constants.PLAYER_ONE_COLOR : Constants.PLAYER_TWO_COLOR; this.grille[column][row].setPlayer(player); this.grille[column][row].repaint(); }