Module it.polimi.ingsw.am13

Package it.polimi.ingsw.am13.network.rmi

Class GameControllerRMI

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

it.polimi.ingsw.am13.network.rmi.GameControllerRMI

All Implemented Interfaces:

GameControllerRMIIF, Serializable, Remote

public class GameControllerRMI
extends UnicastRemoteObject
implements GameControllerRMIIF

Version of class representing gameController for the RMI connection. Hence this class is exposed to the network as RMI remote object. The controller is the controller given to a particular players using RMI for connection. This implies the methods called via this gameController are implicitly referred to the players it belongs to.
This is a controller for a single game/match

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private final GameController	gameController	Wrapped gameController
private final PlayerLobby	player

Fields inherited from class java.rmi.server.RemoteObject

ref

Constructor Summary

Constructors

Constructor	Description
GameControllerRMI(GameController gameController, PlayerLobby player)	Wraps the given gameController to be exposed to the network, and associates this specific controller to the given player

Method Summary

Modifier and Type	Method	Description
void	choosePersonalObjective(CardObjectiveIF cardObj)	Method callable only during INIT phase.
int	getGameId()
List<PlayerLobby>	getPlayers()
private void	logCommand(String cmd)	Logging function which notifies the command which has been received on the server console .
void	pickCard(CardPlayableIF card)	Picks one of the 6 cards on the table, and makes the game proceed to the next Turn.
void	playCard(CardPlayableIF card, Side side, Coordinates coord)	Plays a given card side on the field, at the given coordinates
void	playStarter(Side side)	Method callable only once during INIT phase.
void	transmitChatMessage(List<PlayerLobby> receivers, String text)	Transmits a chat message (while this message will not cause any change in the model, nor will it be stored, it follows the same path as all the other messages)
void	updatePing()	Updates the ping of the player's listener by setting it to the current time

Methods inherited from class java.rmi.server.UnicastRemoteObject

clone, exportObject, exportObject, exportObject, exportObject, exportObject, unexportObject

Methods inherited from class java.rmi.server.RemoteServer

getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

gameController

private final GameController gameController

Wrapped gameController

player

private final PlayerLobby player

Constructor Details

GameControllerRMI

public GameControllerRMI(GameController gameController,
 PlayerLobby player)
                  throws RemoteException,
InvalidPlayerException

Wraps the given gameController to be exposed to the network, and associates this specific controller to the given player

Parameters:

gameController - gameController to wrap in order to be exposed to the network

player - Player (client RMI) who will use this gameController

Throws:

InvalidPlayerException - If the given player is not present in the game

RemoteException

Method Details

logCommand

private void logCommand(String cmd)

Logging function which notifies the command which has been received on the server console .

Parameters:

cmd - Command name

updatePing

public void updatePing()
                throws RemoteException

Updates the ping of the player's listener by setting it to the current time

Specified by:

updatePing in interface GameControllerRMIIF

Throws:

RemoteException

playStarter

public void playStarter(Side side)
                 throws RemoteException,
InvalidPlayCardException,
GameStatusException

Method callable only once during INIT phase. It plays the starter card of the player on the passed side

Specified by:

playStarter in interface GameControllerRMIIF

Parameters:

side - The side of the starting card

Throws:

GameStatusException - If game phase is not INIT

InvalidPlayCardException - Positioning error of the card at coordinates (0,0).

RemoteException

choosePersonalObjective

public void choosePersonalObjective(CardObjectiveIF cardObj)
                             throws RemoteException,
InvalidChoiceException,
VariableAlreadySetException,
GameStatusException

Method callable only during INIT phase. Sets the personal objective of the player according to his choice. The objective card must be between the 2 possible cards given to the player. They can be retrieved with fetchPersonalObjectives(player)

Specified by:

choosePersonalObjective in interface GameControllerRMIIF

Parameters:

cardObj - the objective chosen by the player

Throws:

GameStatusException - if this method isn't called in the INIT phase

InvalidChoiceException - if the objective card does not belong to the list of the possible objective cards for the player

VariableAlreadySetException - if this method has been called before for the player

RemoteException

playCard

public void playCard(CardPlayableIF card,
 Side side,
 Coordinates coord)
              throws RemoteException,
RequirementsNotMetException,
InvalidPlayCardException,
GameStatusException

Plays a given card side on the field, at the given coordinates

Specified by:

playCard in interface GameControllerRMIIF

Parameters:

card - Card which is being played. It must be in player's hand

side - Indicates whether the card is going to be played on the front or on the back

coord - Coordinates in the field of the player where the card is going to be positioned

Throws:

RequirementsNotMetException - If the requirements for playing the specified card in player's field are not met

InvalidPlayCardException - If the player doesn't have the specified card

GameStatusException - If this method is called in the INIT or CALC POINTS phase

RemoteException

pickCard

public void pickCard(CardPlayableIF card)
              throws RemoteException,
InvalidDrawCardException,
GameStatusException

Picks one of the 6 cards on the table, and makes the game proceed to the next Turn. If there is no other turn to play after this one, it adds the objective points and calculates the winner.

Specified by:

pickCard in interface GameControllerRMIIF

Parameters:

card - A playable card that should be in the field

Throws:

InvalidDrawCardException - if the passed card is not on the table

GameStatusException - if this method is called in the INIT or CALC POINTS phase

RemoteException

getGameId

public int getGameId()
              throws RemoteException

Specified by:

getGameId in interface GameControllerRMIIF

Returns:

Unique number indicating the actual game model (hence the game/match to its all entirety)

Throws:

RemoteException

getPlayers

public List<PlayerLobby> getPlayers()
                             throws RemoteException

Specified by:

getPlayers in interface GameControllerRMIIF

Returns:

the players of the match

Throws:

RemoteException

transmitChatMessage

public void transmitChatMessage(List<PlayerLobby> receivers,
 String text)
                         throws RemoteException

Transmits a chat message (while this message will not cause any change in the model, nor will it be stored, it follows the same path as all the other messages)

Specified by:

transmitChatMessage in interface GameControllerRMIIF

Parameters:

receivers - of the message

text - content of the message

Throws:

RemoteException