mouserun.game

Interface GameControllerAdapter

All Known Implementing Classes:

GameUI

public interface GameControllerAdapter

Interface GameControllerAdapter provides the interface for the GameController to raise events that occurred during the game to be reflected in the Game Interface.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearMouse() This method will be invoked at the end of the game.
void	detonateBomb(Bomb bomb) This method will be invoked when a mouse crosses a bomb.
void	displayCountDown(int seconds) This method is to be invoked when showing the number of seconds left to the game end.
void	newBomb(Bomb bomb) This method will be invoked when a mouse planted a new bomb.
void	newCheese(Cheese newCheese) This method will be invoked each time the cheese changes location.
void	newMouse(MouseController mouse) This method will be invoked during game load to introduce new mouse into the user interface.
void	removeBomb(Bomb bomb) This method will be invoked when the bomb represent is to be removed.
void	repositionMouse(MouseController mouse, Grid grid) This method will be invoked when the mouse represent has to be repositioned.
void	start() This method will be invoked and adapter has to prepare all necessary preloading and starts the game.
void	stop() This method will be invoked and adapter has to cause all represents to halt.

Method Detail

newMouse

void newMouse(MouseController mouse)
              throws java.io.IOException

This method will be invoked during game load to introduce new mouse into the user interface. The adapter must be able to maintain the mouse and its represent.

Parameters:

mouse - The new mouse controller that was being loaded.

Throws:

java.io.IOException - As a new mouse is introduced, the adapter has to create a new represent, loading the appropriate assets. If the assets required are missing, this method should throw an IOException.

newCheese

void newCheese(Cheese newCheese)

This method will be invoked each time the cheese changes location. Old cheese represent should be removed.

Parameters:

newCheese - The cheese instance.

clearMouse

void clearMouse()

This method will be invoked at the end of the game. The mouse represent should be removed.

newBomb

void newBomb(Bomb bomb)
             throws java.io.IOException

This method will be invoked when a mouse planted a new bomb. The adapter should create a represent of the new bomb.

Parameters:

bomb - The bomb instance.

Throws:

java.io.IOException - When the method creates a represent for the new bomb, the IOException would be thrown if the required assets are missing.

detonateBomb

void detonateBomb(Bomb bomb)
                  throws java.io.IOException

This method will be invoked when a mouse crosses a bomb. The adapter should change the image of the represent of the bomb appropriately.

Parameters:

bomb - The bomb instance.

Throws:

java.io.IOException - When the method changes the image of the represent, the IOException would be thrown if the required assets are missing.

removeBomb

void removeBomb(Bomb bomb)

This method will be invoked when the bomb represent is to be removed.

Parameters:

bomb - The bomb instance.

repositionMouse

void repositionMouse(MouseController mouse,
                   Grid grid)

This method will be invoked when the mouse represent has to be repositioned.

Parameters:

mouse - The mouse to be moved.

grid - The grid that the mouse is to be moved to.

start

void start()

This method will be invoked and adapter has to prepare all necessary preloading and starts the game.

stop

void stop()

This method will be invoked and adapter has to cause all represents to halt.

displayCountDown

void displayCountDown(int seconds)

This method is to be invoked when showing the number of seconds left to the game end.