From 5e44d39c909996ad00b68b14fdef78c66894cf75 Mon Sep 17 00:00:00 2001
From: Fabian Keller <Fabian.Keller@stud.htwk-leipzig.de>
Date: Fri, 8 Jan 2021 15:38:24 +0100
Subject: [PATCH] Kommentierung verbessert

---
 src/de/jaujau/spiellogik/Spiel.java | 28 +++++++++++++---------------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/src/de/jaujau/spiellogik/Spiel.java b/src/de/jaujau/spiellogik/Spiel.java
index 46496e7..6ae3695 100644
--- a/src/de/jaujau/spiellogik/Spiel.java
+++ b/src/de/jaujau/spiellogik/Spiel.java
@@ -13,6 +13,7 @@ import de.jaujau.gui.Dashboard_GUI;
 
 /**
  * Diese Klasse organisiert den Spielablauf
+ * Diese Klasse beinhaltet Methoden um Spielzüge auszuführen, um Kontrollen durchzuführen und um zwischen Spieler und Computer zu wechseln
  * @author Fabian Keller 
  */
 public class Spiel {
@@ -60,7 +61,7 @@ public class Spiel {
 	
 	/**
 	 * Initialisiert ein Spiel
-	 * Handelt den Start aus
+	 * Handelt den Start aus und führt, falls nötig, den ersten Spielzug aus
 	 * @param dashboard
 	 */
 	public void spiel(Dashboard_GUI dashboard) {
@@ -86,7 +87,7 @@ public class Spiel {
 			int computerZug = computerGegner.cpu_Zug(zwei_ziehen, aussetzen, kartensatz);
 			System.out.println("\nSPIEL Computerauswahl: " + computerZug);
 			switch(computerZug) {
-			case -2: //aussetzen anzeigen?
+			case -2: 
 				aussetzen = false;
 				alternieren(dashboard);
 				break;
@@ -106,14 +107,14 @@ public class Spiel {
 	
 	
 	/**
-	 * Organisiert den Spielablauf
+	 * Organisiert den Spielablauf nach jedem gültigen Zug
 	 * @param dashboard
 	 */
 	private void alternieren(Dashboard_GUI dashboard) {
 		if(spielGewonnen) return;
 		if(amZug == Spieler.SPIELER) {
 			amZug = Spieler.COMPUTER;
-			dashboard.aktualisiereGUI(); //Komplette GUI wird aktualisiert
+			dashboard.aktualisiereGUI();
 			System.out.println("\nSPIEL Computer am Zug");
 			int computerZug = computerGegner.cpu_Zug(zwei_ziehen, aussetzen, kartensatz);
 			System.out.println("SPIEL Computerauswahl: " + computerZug);
@@ -145,7 +146,7 @@ public class Spiel {
 	
 	
 	/**
-	 * Wird aufgerufen wenn das Spiel entschieden wurde
+	 * Wird aufgerufen wenn das Spiel entschieden wurde, führt zum Spielende
 	 * @param spieler Spieler, welcher gewonnen hat
 	 */
 	private void gewinn(Spieler spieler) {
@@ -165,7 +166,7 @@ public class Spiel {
 	}
 	
 	/**
-	   * falls eine Karte gelegt werden kann wird diese gelegt 	
+	   * falls eine Karte gelegt werden kann, wird diese gelegt 
 	   * @param       	kartenindex
 	   */
 	public void karteLegen(int kartenindex) {
@@ -175,24 +176,21 @@ public class Spiel {
 			System.out.println("SPIEL pruefeZug positiv");
 			System.out.println("SPIEL Lege Karte " + kartenindex);
 			kartensatz.ablegen(kartenindex);
-			if(kartensatz.getHand(amZug).size() == 1) {
+			if(kartensatz.getHand(amZug).size() == 1) { //Teilnehmer hat nur noch eine Karte
 				audio.spieleJau();
 			}
-			if(kartensatz.getHand(amZug).isEmpty()) {
+			if(kartensatz.getHand(amZug).isEmpty()) { //Teilnehmer hat gewonnen
 				audio.spieleJauJau();
 				gewinn(amZug);
 				return;
-				//Spieler hat gewonnen, keine Karte mehr auf der Hand -- Was passiert?
-				// Spieler Gewonnen aufrufen, Punkte aktualisieren
-				// Highscore Page oder Startseite aufrufen
 			}
 			System.out.println("SPIEL Kartenhand von COMPUTER: " + kartensatz.getHand(Spieler.COMPUTER));
 			System.out.println("SPIEL Kartenhand von SPIELER:  " + kartensatz.getHand(Spieler.SPIELER));
 			effekteSetzen();
-			if(kartensatz.getKarte(kartenindex).getWERT() == Wert.ACHT) {
+			if(kartensatz.getKarte(kartenindex).getWERT() == Wert.ACHT) { //Sonderfall: wiederholtes aussetzen 
 				if(amZug == Spieler.SPIELER)		dashboard.showaussetzen(false);
 			}
-			if(kartensatz.getKarte(kartenindex).getWERT() == Wert.BUBE) {
+			if(kartensatz.getKarte(kartenindex).getWERT() == Wert.BUBE) { //Sonderfall: Wünscher wurde gelegt
 				if(amZug == Spieler.COMPUTER)	alternieren(dashboard);
 			}
 			else {
@@ -203,7 +201,7 @@ public class Spiel {
 	
 	
 	/**
-	   * falls eine oder mehrere Karten gezogen werden können, wird dies ausgeführt 
+	   * falls eine oder mehrere Karten gezogen werden können, wird dies für den Teilnehmer ausgeführt 
 	   */
 	public void karteZiehen(){
 		if(spielGewonnen) return;
@@ -222,7 +220,7 @@ public class Spiel {
 			}
 			alternieren(dashboard);
 		}
-		else { //AussetzenButton 
+		else { //ziehen nicht möglich
 			return;
 		}
 	}