From dfea7e873645b08fd25bccfaad3eafcce404a004 Mon Sep 17 00:00:00 2001
From: Fleischer Hanno <hanno.fleischer@unibw.de>
Date: Sun, 1 Dec 2024 14:37:04 +0100
Subject: [PATCH] added java docs for choosepowercard

---
 .../powerCardState/ChoosePowerCardState.java  | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/Projekte/mdga/model/src/main/java/pp/mdga/client/gameState/turnState/powerCardState/ChoosePowerCardState.java b/Projekte/mdga/model/src/main/java/pp/mdga/client/gameState/turnState/powerCardState/ChoosePowerCardState.java
index ae71e54f..f0c3fa6c 100644
--- a/Projekte/mdga/model/src/main/java/pp/mdga/client/gameState/turnState/powerCardState/ChoosePowerCardState.java
+++ b/Projekte/mdga/model/src/main/java/pp/mdga/client/gameState/turnState/powerCardState/ChoosePowerCardState.java
@@ -15,32 +15,55 @@
 import java.util.ArrayList;
 import java.util.stream.Collectors;
 
+/**
+ * State where the player can choose a power card
+ */
 public class ChoosePowerCardState extends PowerCardStates {
 
     private final PowerCardState parent;
     private ArrayList<BonusCard> possibleCards;
 
+    /**
+     * Constructor
+     * @param parent parent state
+     * @param logic game logic
+     */
     public ChoosePowerCardState(ClientState parent, ClientGameLogic logic) {
         super(parent, logic);
         this.parent = (PowerCardState) parent;
     }
 
+    /**
+     * Enter the state
+     */
     @Override
     public void enter() {
         possibleCards = new ArrayList<>();
+        //TODO: logic.send(new RequestPossibleCardsMessage());
     }
 
+    /**
+     * Exit the state
+     */
     @Override
     public void exit() {
         possibleCards = null;
     }
 
+    /**
+     * Set the possible cards
+     * @param msg possible cards message
+     */
     @Override
     public void received(PossibleCardMessage msg){
         possibleCards = (ArrayList<BonusCard>) msg.getPossibleCards();
         logic.addNotification(new SelectableCardsNotification(possibleCards));
     }
 
+    /**
+     * Select a card
+     * @param card card to select
+     */
     @Override
     public void selectCard(BonusCard card){
         if(card != null){
@@ -50,6 +73,10 @@ public void selectCard(BonusCard card){
         }
     }
 
+    /**
+     * Receive a card
+     * @param msg card message
+     */
     @Override
     public void received(PlayCardMessage msg){
         if(msg.getCard().equals(BonusCard.TURBO)){
@@ -59,11 +86,19 @@ public void received(PlayCardMessage msg){
         }
     }
 
+    /**
+     * Receive a die now message
+     * @param msg dice now message
+     */
     @Override
     public void received(DiceNowMessage msg){
         parent.getParent().setState(parent.getParent().getRollDice());
     }
 
+    /**
+     * Receive a possible piece message and decide if the player can swap or shield
+     * @param msg possible piece message
+     */
     @Override
     public void received(PossiblePieceMessage msg){
         if (msg.getEnemyPossiblePieces().isEmpty()){