Module polimi.ingsw.am21.codex

Package polimi.ingsw.am21.codex.model.Lobby

Class Lobby

java.lang.Object

polimi.ingsw.am21.codex.model.Lobby.Lobby

public class Lobby
extends Object

Represents the lobby where players join before starting the game.

Constructor Summary

Constructors

Constructor	Description
Lobby()	Constructs a lobby with a default maximum number of players (4).
Lobby(int maxPlayers)	Constructs a lobby with the specified maximum number of players.

Method Summary

Modifier and Type	Method	Description
void	addPlayer(UUID connectionID, CardPair<ObjectiveCard> objectiveCards, PlayableCard starterCard)	Adds a player to the lobby.
boolean	containsConnectionID(UUID connectionID)	Checks if a player with the given socket ID is already in the lobby.
Player	finalizePlayer(UUID connectionID, CardSideType cardSide, List<PlayableCard> hand)	Finalizes a player in the lobby, constructing the Player object and removing the PlayerBuilder from the map
Set<TokenColor>	getAvailableColors()	Gets a list of all the available token colors in the lobby
Optional<String>	getPlayerNickname(UUID connectionID)	Gets the nickname of the player in the lobby.
Optional<CardPair<ObjectiveCard>>	getPlayerObjectiveCards(UUID connectionID)	Retrieves the objective cards associated with a player in the lobby.
int	getPlayersCount()	Gets the current count of players in the lobby.
Map<UUID,javafx.util.Pair<String,TokenColor>>	getPlayersInfo()	Gets the information of all the players in the lobby.
Optional<TokenColor>	getPlayerTokenColor(UUID connectionID)	Gets the token color of the player in the lobby.
int	getRemainingPlayerSlots()	Gets the number of remaining player slots in the lobby.
PlayableCard	getStarterCard(UUID connectionID)
Boolean	hasSelectedFirstObjectiveCard(UUID connectionID)	Gets the objective card associated with the player in the lobby.
javafx.util.Pair<CardPair<ObjectiveCard>,PlayableCard>	removePlayer(UUID connectionID)	Removes a player from the lobby.
void	setNickname(UUID connectionID, String nickname)	Sets the nickname for a player in the lobby.
void	setObjectiveCard(UUID connectionID, Boolean firstObjectiveCard)	Updates the PlayerBuilder with connectionID with the selectedObjectiveCard
void	setToken(UUID connectionID, TokenColor tokenColor)	Sets the token color for a player in the lobby.

Methods inherited from class java.lang.Object

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

Constructor Details

Lobby

public Lobby(int maxPlayers)

Constructs a lobby with the specified maximum number of players.

Parameters:

maxPlayers - the maximum number of players allowed in the lobby

Lobby

public Lobby()

Constructs a lobby with a default maximum number of players (4).

Method Details

getRemainingPlayerSlots

public int getRemainingPlayerSlots()

Gets the number of remaining player slots in the lobby.

Returns:

the number of remaining player slots

getPlayersCount

public int getPlayersCount()

Gets the current count of players in the lobby.

Returns:

the count of players in the lobby

addPlayer

public void addPlayer(UUID connectionID,
 CardPair<ObjectiveCard> objectiveCards,
 PlayableCard starterCard)
               throws LobbyFullException.LobbyFullInternalException

Adds a player to the lobby.

Parameters:

connectionID - the socket ID of the player to add

Throws:

LobbyFullException.LobbyFullInternalException - if the lobby is full and cannot accept more players

removePlayer

public javafx.util.Pair<CardPair<ObjectiveCard>,PlayableCard> removePlayer(UUID connectionID)
                                                                    throws PlayerNotFoundGameException

Removes a player from the lobby.

Parameters:

connectionID - the socket ID of the player to remove

Returns:

the extracted objective card associated and the starter card of the player

Throws:

PlayerNotFoundGameException - if the player is not found in the lobby

setNickname

public void setNickname(UUID connectionID,
 String nickname)
                 throws PlayerNotFoundGameException,
NicknameAlreadyTakenException

Sets the nickname for a player in the lobby.

Parameters:

connectionID - the socket ID of the player

nickname - the nickname to set

Throws:

PlayerNotFoundGameException - if the socket ID is not found in the lobby

NicknameAlreadyTakenException - if the nickname is already taken by another player

setToken

public void setToken(UUID connectionID,
 TokenColor tokenColor)
              throws PlayerNotFoundGameException,
TokenAlreadyTakenException

Sets the token color for a player in the lobby.

Parameters:

connectionID - the socket ID of the player

tokenColor - the token color to set

Throws:

PlayerNotFoundGameException - if the socket ID is not found in the lobby

TokenAlreadyTakenException - if the token color is already taken by another player

setObjectiveCard

public void setObjectiveCard(UUID connectionID,
 Boolean firstObjectiveCard)
                      throws PlayerNotFoundGameException

Updates the PlayerBuilder with connectionID with the selectedObjectiveCard

Parameters:

connectionID - the socket ID of the player

firstObjectiveCard - sets the selectedObjectiveCard card to the first or second from the CardPair

Throws:

PlayerNotFoundGameException - if the socket ID is not found in the lobby

hasSelectedFirstObjectiveCard

public Boolean hasSelectedFirstObjectiveCard(UUID connectionID)
                                      throws PlayerNotFoundGameException

Gets the objective card associated with the player in the lobby.

Parameters:

connectionID - the socket ID of the player

Returns:

the objective card associated with the player

Throws:

PlayerNotFoundGameException - if the player is not found in the lobby

finalizePlayer

public Player finalizePlayer(UUID connectionID,
 CardSideType cardSide,
 List<PlayableCard> hand)
                      throws PlayerNotFoundGameException,
IncompletePlayerBuilderException,
IllegalCardSideChoiceException,
IllegalPlacingPositionException

Finalizes a player in the lobby, constructing the Player object and removing the PlayerBuilder from the map

Parameters:

connectionID - the socket ID of the player to finalize

cardSide - the objective card associated with the player

Returns:

the finalized Player object

Throws:

PlayerNotFoundGameException - if the socked ID is not found in the lobby

IncompletePlayerBuilderException

IllegalCardSideChoiceException

IllegalPlacingPositionException

getPlayerObjectiveCards

public Optional<CardPair<ObjectiveCard>> getPlayerObjectiveCards(UUID connectionID)

Retrieves the objective cards associated with a player in the lobby.

Parameters:

connectionID - the socket ID of the player

Returns:

the CardPair containing the objective cards of the player

containsConnectionID

public boolean containsConnectionID(UUID connectionID)

Checks if a player with the given socket ID is already in the lobby.

Parameters:

connectionID - the socket ID of the player to check

Returns:

true if the player is already in the lobby, otherwise false

getPlayerNickname

public Optional<String> getPlayerNickname(UUID connectionID)
                                   throws PlayerNotFoundGameException

Gets the nickname of the player in the lobby.

Parameters:

connectionID - the socket ID of the player

Returns:

the nickname of the player

Throws:

PlayerNotFoundGameException - if the player is not found in the lobby

getPlayerTokenColor

public Optional<TokenColor> getPlayerTokenColor(UUID connectionID)
                                         throws PlayerNotFoundGameException

Gets the token color of the player in the lobby.

Parameters:

connectionID - the socket ID of the player

Returns:

the token color of the player

Throws:

PlayerNotFoundGameException - if the player is not found in the lobby

getAvailableColors

public Set<TokenColor> getAvailableColors()

Gets a list of all the available token colors in the lobby

getPlayersInfo

public Map<UUID,javafx.util.Pair<String,TokenColor>> getPlayersInfo()

Gets the information of all the players in the lobby.

Returns:

a map of the players' socket ID to their nickname and token color

getStarterCard

public PlayableCard getStarterCard(UUID connectionID)
                            throws PlayerNotFoundGameException

Parameters:

connectionID - the socked ID of the player

Returns:

the starter card of the player

Throws:

PlayerNotFoundGameException - if the player is not found in the lobby