From d10305ccb1b058dc3c18169cbe19e95af3f620bc Mon Sep 17 00:00:00 2001
From: E203647F <arthur.wlodarczak@univ-nantes.fr>
Date: Fri, 25 Jun 2021 10:29:51 +0200
Subject: [PATCH] Arthur : Ajout des commentaires sur les Listeners

---
 src/controleurs/ListenerBoutonCreate.java         | 10 +++++-----
 src/controleurs/ListenerBoutonFlotteBelgique.java |  3 +++
 src/controleurs/ListenerBoutonFlotteFrance.java   |  3 ++-
 src/controleurs/ListenerBoutonInscription.java    |  8 +++++---
 src/controleurs/ListenerBoutonJoin.java           | 15 ++++++++-------
 src/controleurs/ListenerClavierInscription.java   |  9 +++++----
 src/controleurs/ListenerClavierJoin.java          | 12 +++++++-----
 src/controleurs/ListenerCommentJouer.java         |  2 +-
 src/controleurs/ListenerCommentPlacer.java        |  4 ++--
 src/controleurs/ListenerJouer.java                |  4 +++-
 10 files changed, 41 insertions(+), 29 deletions(-)

diff --git a/src/controleurs/ListenerBoutonCreate.java b/src/controleurs/ListenerBoutonCreate.java
index 48b09e9..2b25781 100644
--- a/src/controleurs/ListenerBoutonCreate.java
+++ b/src/controleurs/ListenerBoutonCreate.java
@@ -25,27 +25,27 @@ public class ListenerBoutonCreate implements ActionListener {
     public void actionPerformed(ActionEvent clic) {
 
 
-
+        // Création de la fenêtre suivante
         MenuJeu fenetre3 = new MenuJeu("Fenetre de jeu",f1.getMaflotte());
         fenetre3.EtatFlotte(true);
+        //Initialisation d'un listener
         fenetre3.selectionnercase(new ListenerMouseJouer(fenetre3));
         fenetre3.pack();
         fenetre3.setVisible(true);
 
 
         try {
+            // Création d'une nouvelle partie
             int gameID = (Network.initNewGame("http://37.187.38.219/api/v0", f1.getPlayerVues(), f1.getMaflotte())).getId();
             Game JoinGame = new Game(gameID);
             fenetre3.setGame(JoinGame);
             ArrayList  test = new ArrayList(Network.listActivePlayers("http://37.187.38.219/api/v0"));
+            // Fenêtre pop-up
             JOptionPane optionPane = new JOptionPane("L'ID de votre partie est : " +  gameID + "  et ton nom est : " +f1.getPlayerVues().getName(), JOptionPane.INFORMATION_MESSAGE) ;
             JDialog dialog = optionPane.createDialog("Message d'information");
             dialog.setAlwaysOnTop(true);
             dialog.setVisible(true);
-            f1.dispose();
-
-
-
+            f1.dispose(); // fermer la fenêtre précédente
 
         } catch (UnirestException | UncompleteFleetException | BadCoordException | BadIdException exception) {
             exception.printStackTrace();
diff --git a/src/controleurs/ListenerBoutonFlotteBelgique.java b/src/controleurs/ListenerBoutonFlotteBelgique.java
index 0245f30..2950f1f 100644
--- a/src/controleurs/ListenerBoutonFlotteBelgique.java
+++ b/src/controleurs/ListenerBoutonFlotteBelgique.java
@@ -18,6 +18,8 @@ public class ListenerBoutonFlotteBelgique implements ActionListener {
 
     public void actionPerformed(ActionEvent clic) {
 
+
+        // Création de la fenêtre pour choisir la position des bateaux
         NavyFleet flotte = f1.getMaflotte();
         f2.setMaflotte(flotte);
         f2.selectionnercoord(new selectionnerfront(f2));
@@ -34,6 +36,7 @@ public class ListenerBoutonFlotteBelgique implements ActionListener {
         }
         f2.setPlayerVues(f1.getPlayerVues());
         f1.dispose();
+        // Pop-up pour expliquer comment placer des bateaux
         JOptionPane optionPane = new JOptionPane("Pour déplacer un bateau, cliquez dessus. Le bateau disparaitra alors.\n" +
                 "Entrez dans les zones de texte en haut à gauche les coordonnées de début et de fin du bateau.\n" +
                 "Appuyez ensuite sur le petit + " +
diff --git a/src/controleurs/ListenerBoutonFlotteFrance.java b/src/controleurs/ListenerBoutonFlotteFrance.java
index 3649dbb..af3f191 100644
--- a/src/controleurs/ListenerBoutonFlotteFrance.java
+++ b/src/controleurs/ListenerBoutonFlotteFrance.java
@@ -17,7 +17,7 @@ public class ListenerBoutonFlotteFrance implements ActionListener {
     }
 
     public void actionPerformed(ActionEvent clic) {
-
+        // Création de la fenêtre pour choisir la position des bateaux
         NavyFleet flotte = f1.getMaflotte();
         f2.setMaflotte(flotte);
         f2.selectionnercoord(new selectionnerfront(f2));
@@ -32,6 +32,7 @@ public class ListenerBoutonFlotteFrance implements ActionListener {
         }
         f2.setPlayerVues(f1.getPlayerVues());
         f1.dispose();
+        // Pop-up pour expliquer comment placer des bateaux
         JOptionPane optionPane = new JOptionPane("Pour déplacer un bateau, cliquez dessus. Le bateau disparaitra alors.\n" +
                 "Entrez dans les zones de texte en haut à gauche les coordonnées de début et de fin du bateau.\n" +
                 "Appuyez ensuite sur le petit + " +
diff --git a/src/controleurs/ListenerBoutonInscription.java b/src/controleurs/ListenerBoutonInscription.java
index fccf196..967d7e5 100644
--- a/src/controleurs/ListenerBoutonInscription.java
+++ b/src/controleurs/ListenerBoutonInscription.java
@@ -21,18 +21,19 @@ public class ListenerBoutonInscription implements ActionListener {
     }
 
     public void actionPerformed(ActionEvent clic){
+        //Vérification que le JTextField n'est pas vide
         if(f1.donneNomJoueur().equals("")){
             JOptionPane optionPane = new JOptionPane("Pseudo non renseigné", JOptionPane.ERROR_MESSAGE);
             JDialog dialog = optionPane.createDialog("Message d'erreur");
             dialog.setAlwaysOnTop(true);
             dialog.setVisible(true);
         }else{
-
+            //Connexion au proxy
             Player player1 = new Player(f1.donneNomJoueur());
             Network.setProxy("srv-proxy-etu-2.iut-nantes.univ-nantes.prive", 3128);
             Network.enableProxy(true);
             try {
-
+                //Inscription du joueur
                 if (Network.suscribeNewPlayer("http://37.187.38.219/api/v0", player1)){
                     f2.pack();
                     f2.setVisible(true);
@@ -41,7 +42,8 @@ public class ListenerBoutonInscription implements ActionListener {
 
 
                 }
-                else {
+                else { // Si le nom du joueur est déjà présent dans le NetWork, ouverture d'un pop-up.
+
                     JOptionPane optionPane = new JOptionPane("Pseudo déjà utilisé sur le network", JOptionPane.ERROR_MESSAGE);
                     JDialog dialog = optionPane.createDialog("Message d'erreur");
                     dialog.setAlwaysOnTop(true);
diff --git a/src/controleurs/ListenerBoutonJoin.java b/src/controleurs/ListenerBoutonJoin.java
index 485ff8b..1d9e92f 100644
--- a/src/controleurs/ListenerBoutonJoin.java
+++ b/src/controleurs/ListenerBoutonJoin.java
@@ -21,10 +21,11 @@ public class ListenerBoutonJoin implements ActionListener {
     public void actionPerformed(ActionEvent clic) {
         NavyFleet flotte = f1.getMaflotte();
 
-       String str = f1.checkID();
+
+        String str = f1.checkID();
         boolean idcorrect = true;
             for (int i = 0; i < str.length(); i++) {
-                if (!Character.isDigit(str.charAt(i))) {
+                if (!Character.isDigit(str.charAt(i))) { //Vérification que le JTextField de l'ID ne contient pas de lettres
                     JOptionPane optionPane = new JOptionPane("ID non valide", JOptionPane.ERROR_MESSAGE);
                     JDialog dialog = optionPane.createDialog("Message d'erreur");
                     dialog.setAlwaysOnTop(true);
@@ -33,7 +34,7 @@ public class ListenerBoutonJoin implements ActionListener {
                     break;
 
                 }
-                if (f1.checkID().equals("")) {
+                if (f1.checkID().equals("")) {//Vérification que le JTextField de l'ID ne contient pas d'espaces
                     JOptionPane optionPane = new JOptionPane("ID non renseigné", JOptionPane.ERROR_MESSAGE);
                     JDialog dialog = optionPane.createDialog("Message d'erreur");
                     dialog.setAlwaysOnTop(true);
@@ -43,7 +44,7 @@ public class ListenerBoutonJoin implements ActionListener {
 
                 }
             }
-        if (f1.checkID().equals("")) {
+        if (f1.checkID().equals("")) {//Vérification que le JTextField de l'ID n'est pas vide
             JOptionPane optionPane = new JOptionPane("ID non renseigné", JOptionPane.ERROR_MESSAGE);
             JDialog dialog = optionPane.createDialog("Message d'erreur");
             dialog.setAlwaysOnTop(true);
@@ -62,19 +63,19 @@ public class ListenerBoutonJoin implements ActionListener {
                 String test = new String(String.valueOf(Network.listInitializedGames("http://37.187.38.219/api/v0")));
                 for (int i = 0; i < test.length(); i++) {
 
-                    if (test.contains(f1.checkID())){
+                    if (test.contains(f1.checkID())){ // Si le NetWork contient bien la partie correspondant à l'ID renseignée, alors le joueur rejoint la partie
 
                         Network.joinGame("http://37.187.38.219/api/v0",  JoinGame, f1.getPlayerVues(), flotte);
+                        //Création de la fenêtre de jeu
                         MenuJeu fenetre3 = new MenuJeu("Interface de jeu", f1.getMaflotte());
                         fenetre3.setGame(JoinGame);
                         fenetre3.pack();
-
                         fenetre3.setVisible(true);
                         f1.dispose();
 
                     }
 
-                }
+                } //Pop-up qui s'ouvre si l'ID ne correspond à aucune partie sur le NetWork
                 JOptionPane optionPane = new JOptionPane("La partie n'existe pas sur le réseau", JOptionPane.ERROR_MESSAGE);
                 JDialog dialog = optionPane.createDialog("Message d'erreur");
                 dialog.setAlwaysOnTop(true);
diff --git a/src/controleurs/ListenerClavierInscription.java b/src/controleurs/ListenerClavierInscription.java
index 4cdbd3a..edb8b6c 100644
--- a/src/controleurs/ListenerClavierInscription.java
+++ b/src/controleurs/ListenerClavierInscription.java
@@ -31,9 +31,9 @@ public class ListenerClavierInscription implements KeyListener {
     @Override
     public void keyPressed(KeyEvent e) {
 
-
+        // Detection d'une pression sur la touche "Entrée"
         if(e.getKeyCode() == KeyEvent.VK_ENTER){
-            if(f1.donneNomJoueur().equals("")){
+            if(f1.donneNomJoueur().equals("")){ //Vérification que le JTextField n'est pas vide
                 JOptionPane optionPane = new JOptionPane("Pseudo non renseigné", JOptionPane.ERROR_MESSAGE);
                 JDialog dialog = optionPane.createDialog("Message d'erreur");
                 dialog.setAlwaysOnTop(true);
@@ -43,16 +43,17 @@ public class ListenerClavierInscription implements KeyListener {
                 try {
 
                     Player player1 = new Player(f1.donneNomJoueur());
+                    //Connexion au proxy
                     Network.setProxy("srv-proxy-etu-2.iut-nantes.univ-nantes.prive", 3128);
                     Network.enableProxy(true);
+                    //Inscription du joueur
                     if (Network.suscribeNewPlayer("http://37.187.38.219/api/v0", player1)){
-
                         f2.pack();
                         f2.setVisible(true);
                         f2.setPlayerVues(player1);
                         f1.dispose();
                     }
-                    else {
+                    else {// Si le nom du joueur est déjà présent dans le NetWork, ouverture d'un pop-up.
                         JOptionPane optionPane = new JOptionPane("Pseudo déjà utilisé sur le network", JOptionPane.ERROR_MESSAGE);
                         JDialog dialog = optionPane.createDialog("Message d'erreur");
                         dialog.setAlwaysOnTop(true);
diff --git a/src/controleurs/ListenerClavierJoin.java b/src/controleurs/ListenerClavierJoin.java
index 62cef6a..c3160ba 100644
--- a/src/controleurs/ListenerClavierJoin.java
+++ b/src/controleurs/ListenerClavierJoin.java
@@ -37,10 +37,11 @@ public class ListenerClavierJoin implements KeyListener {
     @Override
     public void keyPressed(KeyEvent k) {
         NavyFleet flotte2 = fenetre1.getMaflotte();
+        // Detection de pression sur la touche "Entrée"
         if (k.getKeyCode() == KeyEvent.VK_ENTER) {
             String str = fenetre1.checkID();
             boolean idcorrect = true;
-            for (int i = 0; i < str.length(); i++) {
+            for (int i = 0; i < str.length(); i++) { //Vérification que le JTextField de l'ID ne contient pas de lettres
                 if (!Character.isDigit(str.charAt(i))) {
                     JOptionPane optionPane = new JOptionPane("ID non valide", JOptionPane.ERROR_MESSAGE);
                     JDialog dialog = optionPane.createDialog("Message d'erreur");
@@ -50,7 +51,7 @@ public class ListenerClavierJoin implements KeyListener {
                     break;
 
                 }
-                if (fenetre1.checkID().equals("")) {
+                if (fenetre1.checkID().equals("")) {//Vérification que le JTextField de l'ID ne contient pas d'espaces
                     JOptionPane optionPane = new JOptionPane("ID non renseigné", JOptionPane.ERROR_MESSAGE);
                     JDialog dialog = optionPane.createDialog("Message d'erreur");
                     dialog.setAlwaysOnTop(true);
@@ -60,7 +61,7 @@ public class ListenerClavierJoin implements KeyListener {
 
                 }
             }
-            if (fenetre1.checkID().equals("")) {
+            if (fenetre1.checkID().equals("")) {//Vérification que le JTextField de l'ID n'est pas vide
                 JOptionPane optionPane = new JOptionPane("ID non renseigné", JOptionPane.ERROR_MESSAGE);
                 JDialog dialog = optionPane.createDialog("Message d'erreur");
                 dialog.setAlwaysOnTop(true);
@@ -78,9 +79,10 @@ public class ListenerClavierJoin implements KeyListener {
                     String test = new String(String.valueOf(Network.listInitializedGames("http://37.187.38.219/api/v0")));
                     for (int i = 0; i < test.length(); i++) {
 
-                        if (test.contains(fenetre1.checkID())) {
+                        if (test.contains(fenetre1.checkID())) {// Si le NetWork contient bien la partie correspondant à l'ID renseignée, alors le joueur rejoint la partie
 
                             Network.joinGame("http://37.187.38.219/api/v0", JoinGame, fenetre1.getPlayerVues(), flotte2);
+                            //Création de la fenêtre de jeu
                             MenuJeu fenetre3 = new MenuJeu("Interface de jeu",fenetre1.getMaflotte());
                             fenetre3.setGame(JoinGame);
                             fenetre3.pack();
@@ -90,7 +92,7 @@ public class ListenerClavierJoin implements KeyListener {
 
                         }
 
-                    }
+                    }//Pop-up qui s'ouvre si l'ID ne correspond à aucune partie sur le NetWork
                     JOptionPane optionPane = new JOptionPane("L'ID de la partie n'existe pas sur le network", JOptionPane.ERROR_MESSAGE);
                     JDialog dialog = optionPane.createDialog("Message d'erreur");
                     dialog.setAlwaysOnTop(true);
diff --git a/src/controleurs/ListenerCommentJouer.java b/src/controleurs/ListenerCommentJouer.java
index a532b9b..514eb53 100644
--- a/src/controleurs/ListenerCommentJouer.java
+++ b/src/controleurs/ListenerCommentJouer.java
@@ -16,7 +16,7 @@ public class ListenerCommentJouer implements ActionListener {
     }
 
     public void actionPerformed(ActionEvent clic){
-
+        // Pop-up permettant d'afficher les règles du jeu
         String message = "Le but du jeu est de couler tous les bateaux de l’adversaire.\n " +
                 "Pour cela, chacun votre tour, vous devez essayer de « tirer » sur ses navires en devinant leurs positions. \n" +
                 "Pour tirer, il faut choisir sur le plateau un emplacement en cliquant dessus. \n" +
diff --git a/src/controleurs/ListenerCommentPlacer.java b/src/controleurs/ListenerCommentPlacer.java
index 9e521c8..85aecd7 100644
--- a/src/controleurs/ListenerCommentPlacer.java
+++ b/src/controleurs/ListenerCommentPlacer.java
@@ -16,7 +16,7 @@ public class ListenerCommentPlacer implements ActionListener {
     }
 
     public void actionPerformed(ActionEvent clic){
-
+        // Pop-up permettant d'afficher les étapes pour placer sa flotte
         String message = "Pour déplacer un bateau, cliquez dessus. Le bateau disparaitra alors.\n" +
                 "Entrez dans les zones de texte en haut à gauche les coordonnées de début et de fin du bateau.\n" +
                 "Appuyez ensuite sur le petit + " +
@@ -24,7 +24,7 @@ public class ListenerCommentPlacer implements ActionListener {
 
         JOptionPane optionPane = new JOptionPane(message, JOptionPane.QUESTION_MESSAGE);
 
-        JDialog dialog = optionPane.createDialog("Règles de la Bataille Navale");
+        JDialog dialog = optionPane.createDialog("Comment créer sa flotte");
         dialog.setAlwaysOnTop(true);
         dialog.setVisible(true);
 
diff --git a/src/controleurs/ListenerJouer.java b/src/controleurs/ListenerJouer.java
index bb961ea..74c4c39 100644
--- a/src/controleurs/ListenerJouer.java
+++ b/src/controleurs/ListenerJouer.java
@@ -21,15 +21,17 @@ public class ListenerJouer  implements ActionListener {
     }
 
     public void actionPerformed(ActionEvent clic){
+        // Création de la fenêtre permettant de choisir les options pour jouer (créer ou rejoindre partie)
         MenuPartie f2 = null;
         try {
             f2 = new MenuPartie(titre);
         } catch (MalformedURLException e) {
             e.printStackTrace();
         }
-        f2.setMaflotte(f1.getMaflotte());
+        f2.setMaflotte(f1.getMaflotte()); // sauvegarde de la flotte créée
         f2.pack();
         f2.setVisible(true);
+        // Initialisation de Listeners
         f2.ListenerBoutonJoin(new ListenerBoutonJoin(f2));
         f2.ListenerBoutonCreate(new ListenerBoutonCreate(f2));
         f2.ListenerClavierJoin(new ListenerClavierJoin(f2));
-- 
GitLab