at.pwd.boardgame.game.mancala

Class MancalaGame

java.lang.Object

at.pwd.boardgame.game.mancala.MancalaGame

All Implemented Interfaces:

Game<MancalaState,MancalaBoard>

public class MancalaGame
extends java.lang.Object
implements Game<MancalaState,MancalaBoard>

MancalaGame is an implementation of the Game interface for Mancala. Keep in mind that MancalaGame does not check for "valid" moves. Every move that is done is immediately executed. MancalaGames state is in the MancalaState object and the board configuration in the MancalaBoard.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	GAME_BOARD_TRANFORMER The transformer to create the view FXML
static java.lang.String	GAME_NAME The name of this game

Constructor Summary

Constructors

Constructor and Description
MancalaGame() Default constructor used by GameFactory
MancalaGame(MancalaGame game) Creates a semi deep copy of the given MancalaGame (State is copied, board is kept the same)
MancalaGame(MancalaState state, MancalaBoard board) Creates a new MancalaGame

Method Summary

Modifier and Type	Method and Description
WinState	checkIfPlayerWins() Checks if a player is winning.
MancalaBoard	getBoard() Returns the board configuration of the current game.
java.util.List<java.lang.String>	getSelectableSlots() Returns a list of selectable slots for the current game state and current board
MancalaState	getState() Returns the state of the current game.
java.io.InputStream	getViewXml() Returns the view as an FXML inputstream.
static void	init() Registers MancalaGame to the GameFactory and initializes MancalaHumanAgent
void	loadBoard(java.io.InputStream boardStream) This is called at the beginning loading the board.
int	nextPlayer() Finishes the current players turn and starting the turn of the next player.
boolean	selectSlot(java.lang.String id) Selects the slot with the given ID and calculates the turn.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

GAME_BOARD_TRANFORMER

public static final java.lang.String GAME_BOARD_TRANFORMER

The transformer to create the view FXML

See Also:

Constant Field Values

GAME_NAME

public static final java.lang.String GAME_NAME

The name of this game

See Also:

Constant Field Values

Constructor Detail

MancalaGame

public MancalaGame()

Default constructor used by GameFactory

MancalaGame

public MancalaGame(MancalaGame game)

Creates a semi deep copy of the given MancalaGame (State is copied, board is kept the same)

Parameters:

game - The game that should be copied.

MancalaGame

public MancalaGame(MancalaState state,
                   MancalaBoard board)

Creates a new MancalaGame

Parameters:

state - If null the default MancalaState of the board is generated (placing stones_per_slot many stones on each slot). If not null the given state is used.

board - The board that should be used for this MancalaGame

Method Detail

init

public static void init()

Registers MancalaGame to the GameFactory and initializes MancalaHumanAgent

getViewXml

public java.io.InputStream getViewXml()

Description copied from interface: Game

Returns the view as an FXML inputstream. This generates the board for the BoardController

Specified by:

getViewXml in interface Game<MancalaState,MancalaBoard>

Returns:

The inputstream of the fxml file

loadBoard

public void loadBoard(java.io.InputStream boardStream)

Description copied from interface: Game

This is called at the beginning loading the board. This should initialize the Game. After this getState() and getBoard() should return non null values. When an error happens during loading a RuntimeException may be thrown.

Specified by:

loadBoard in interface Game<MancalaState,MancalaBoard>

Parameters:

boardStream - InputStream of the board XML

selectSlot

public boolean selectSlot(java.lang.String id)

Selects the slot with the given ID and calculates the turn. If this ends the game. The final stones of the enemys player are placed in his depot too. Throws a RuntimeException if an invalid slot is selected

Parameters:

id - The ID of the slot that has been selected

Returns:

true ... the current player can play another turn, false ... the current player has to end his turn

getSelectableSlots

public java.util.List<java.lang.String> getSelectableSlots()

Returns a list of selectable slots for the current game state and current board

Returns:

A List containing all selectable slot IDs. If there is nothing selectable the list is empty

checkIfPlayerWins

public WinState checkIfPlayerWins()

Checks if a player is winning. If a player is winning the opponent gets the remaining stones into his own depot (so this method also alters the state).

Returns:

A WinState describing if and who is winning

getBoard

public MancalaBoard getBoard()

Description copied from interface: Game

Returns the board configuration of the current game.

Specified by:

getBoard in interface Game<MancalaState,MancalaBoard>

Returns:

Some object implementing Board interface

nextPlayer

public int nextPlayer()

Description copied from interface: Game

Finishes the current players turn and starting the turn of the next player. Keep in mind, that the Game class does not check for valid moves. Always call methods according to the rules.

Specified by:

nextPlayer in interface Game<MancalaState,MancalaBoard>

Returns:

The next players ID

getState

public MancalaState getState()

Description copied from interface: Game

Returns the state of the current game.

Specified by:

getState in interface Game<MancalaState,MancalaBoard>

Returns:

Some object implementing State interface