Work on GameInterface and PlayerInterface to create shell

Author: Jstrine09

src/main/java/com/github/zipcodewilmington/Casino.java

@@ -6,6 +6,8 @@
 import com.github.zipcodewilmington.casino.PlayerInterface;
 import com.github.zipcodewilmington.casino.games.blackjack.BlackjackGame;
 import com.github.zipcodewilmington.casino.games.blackjack.BlackjackPlayer;
+import com.github.zipcodewilmington.casino.games.craps.CrapsGame;
+import com.github.zipcodewilmington.casino.games.craps.CrapsPlayer;
 import com.github.zipcodewilmington.casino.games.numberguess.NumberGuessGame;
 import com.github.zipcodewilmington.casino.games.numberguess.NumberGuessPlayer;
 import com.github.zipcodewilmington.casino.games.slots.SlotsGame;
@@ -38,8 +40,15 @@ public void run() {
                         play(new NumberGuessGame(), new NumberGuessPlayer());
                     } else if (gameSelectionInput.equals("BLACKJACK")) {
                         play(new BlackjackGame(), new BlackjackPlayer(casinoAccount));
+                    } else if (gameSelectionInput.equals("CRAPS")) {
+                        play(new CrapsGame(), new CrapsPlayer(casinoAccount));
+                    // ── Teammates: uncomment your game below when ready ──────────
+                    // } else if (gameSelectionInput.equals("ROULETTE")) {
+                    //     play(new RouletteGame(), new RoulettePlayer(casinoAccount));
+                    // } else if (gameSelectionInput.equals("HANGMAN")) {
+                    //     play(new HangmanGame(), new HangmanPlayer(casinoAccount));
+                    // ─────────────────────────────────────────────────────────────
                     } else {
-                        // TODO - implement better exception handling
                         String errorMessage = "[ %s ] is an invalid game selection";
                         throw new RuntimeException(String.format(errorMessage, gameSelectionInput));
                     }
@@ -70,13 +79,11 @@ private String getGameSelectionInput() {
         return console.getStringInput(new StringBuilder()
                 .append("Welcome to the Game Selection Dashboard!")
                 .append("\nFrom here, you can select any of the following options:")
-            .append("\n\t[ SLOTS ], [ NUMBERGUESS ], [ BLACKJACK ]")
+            .append("\n\t[ SLOTS ], [ NUMBERGUESS ], [ BLACKJACK ], [ CRAPS ]")
                 .toString());
     }
 
-    private void play(Object gameObject, Object playerObject) {
-        GameInterface game = (GameInterface)gameObject;
-        PlayerInterface player = (PlayerInterface)playerObject;
+    private void play(GameInterface game, PlayerInterface player) {
         game.add(player);
         game.run();
     }

src/main/java/com/github/zipcodewilmington/casino/GameInterface.java

@@ -1,23 +1,46 @@
-package com.github.zipcodewilmington.casino;
-
-/**
- * Created by leon on 7/21/2020.
- */
-public interface GameInterface extends Runnable {
-    /**
-     * adds a player to the game
-     * @param player the player to be removed from the game
-     */
-    void add(PlayerInterface player);
-
-    /**
-     * removes a player from the game
-     * @param player the player to be removed from the game
-     */
-    void remove(PlayerInterface player);
-
-    /**
-     * specifies how the game will run
-     */
-    void run();
-}
+package com.github.zipcodewilmington.casino;
+
+/**
+ * Contract for all games in the Casino.
+ * Methods marked `default` are optional overrides — implement them in your game class as needed.
+ */
+public interface GameInterface extends Runnable {
+
+    // ── Required (must implement) ─────────────────────────────────────
+
+    /** Add a player to the game. */
+    void add(PlayerInterface player);
+
+    /** Remove a player from the game. */
+    void remove(PlayerInterface player);
+
+    /** Main game loop — drives a full session. */
+    void run();
+
+    // ── Optional hooks (override in your game class as needed) ────────
+
+    /** Load or reset any game state before a session starts. */
+    default void fetch() {}
+
+    /** Called at the start of each round. */
+    default void start() {}
+
+    /** Called at the end of each round. */
+    default void end() {}
+
+    /** Register or initialise any sub-games or game variants. */
+    default void loadGames() {}
+
+    /**
+     * Factory method — create and return a player for this game.
+     * Override to return your concrete player type (e.g. new BlackjackPlayer(account)).
+     */
+    default PlayerInterface createPlayer(CasinoAccount account) {
+        return null;
+    }
+
+    /** Remove and clean up a player — delegates to remove() by default. */
+    default void deletePlayer(PlayerInterface player) {
+        remove(player);
+    }
+}

src/main/java/com/github/zipcodewilmington/casino/PlayerInterface.java

@@ -1,21 +1,36 @@
-package com.github.zipcodewilmington.casino;
-
-/**
- * Created by leon on 7/21/2020.
- * All players of a game should abide by `PlayerInterface`.
- * All players must have reference to the `ArcadeAccount` used to log into the `Arcade` system.
- * All players are capable of `play`ing a game.
- */
-public interface PlayerInterface {
-    /**
-     * @return the `ArcadeAccount` used to log into the `Arcade` system to play this game
-     */
-    CasinoAccount getArcadeAccount();
-
-    /**
-     * Defines how a specific implementation of `PlayerInterface` plays their respective game.
-     * @param <SomeReturnType> specify any return type you would like here
-     * @return whatever return value you would like
-     */
-    <SomeReturnType> SomeReturnType play();
-}
+package com.github.zipcodewilmington.casino;
+
+/**
+ * Contract for all players in the Casino.
+ * All players must hold a CasinoAccount reference and know how to play their game.
+ * Methods marked `default` are provided for free — override them if you need custom behaviour.
+ */
+public interface PlayerInterface {
+
+    // ── Required (must implement) ─────────────────────────────────────
+
+    /** @return the CasinoAccount used to log into the Casino system. */
+    CasinoAccount getArcadeAccount();
+
+    /**
+     * Defines how this player plays their game.
+     * @param <SomeReturnType> any return type you need
+     */
+    <SomeReturnType> SomeReturnType play();
+
+    // ── Provided for free (override if needed) ────────────────────────
+
+    /**
+     * Alias for getArcadeAccount() — matches the UML name.
+     * Override if your player stores the account under a different field.
+     */
+    default CasinoAccount fetchCasinoAccount() {
+        return getArcadeAccount();
+    }
+
+    /** @return the player's current balance, or 0.0 if no account is set. */
+    default double getBalance() {
+        CasinoAccount account = getArcadeAccount();
+        return account != null ? account.getBalance() : 0.0;
+    }
+}