Add: JavaDoc for Order4

2026-04-12 19:30:54 +02:00
parent a2d9c964f5
commit bce2db6d3b
1 changed files with 20 additions and 0 deletions
@@ -7,11 +7,31 @@ import java.util.ArrayList;
 import java.util.NoSuchElementException;

 public class Order4 extends OrderLogicCard {
+
+    /**
+     * Creates an Order4 logic card for a four-player game.
+     *
+     * @param players the list of players associated with this order card
+     * @throws NoSuchElementException if the number of players is not equal to 4
+     */
    public Order4(ArrayList<Player> players)throws NoSuchElementException {
        if(players.size()!=4)
            throw new NoSuchElementException();
        super(players);
    }
+
+    /**
+     * Applies the effect associated with the specified position index for the given player.
+     * If {@code index == 0}, the player gains 2 Food and the building effect is applied.
+     * If {@code index == 1}, the player gains 1 Food and the building effect is applied.
+     * If {@code index == 2}, no effect is applied.
+     * If {@code index == 3}, the player tries to remove 1 Food; if the removal succeeds,
+     * the player loses 2 Prestige.
+     *
+     * @param player the player to whom the effect is applied
+     * @param index the position index of the effect to apply
+     * @throws IndexOutOfBoundsException if {@code index < 0} or {@code index >= 4}
+     */
    @Override
    protected void effect(Player player,int index) throws IndexOutOfBoundsException
    {