com.iohao.game.widget.light.room.Room Maven / Gradle / Ivy
/*
* ioGame
* Copyright (C) 2021 - present 渔民小镇 （[email protected]、[email protected]） . All Rights Reserved.
* # iohao.com . 渔民小镇
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see
* key : userId
* value : player
*
*
* @return 玩家
*/
Map getPlayerMap();
/**
* 玩家位置
*
* key : seat
* value : userId
*
*
* @return 玩家位置
*/
Map getPlayerSeatMap();
/**
* get roomId
*
* @return 房间唯一 id
*/
long getRoomId();
/**
* set roomId
*
* @param roomId 房间唯一 id
*/
void setRoomId(long roomId);
/**
* get 房间空间大小
*
* @return 房间空间大小。如 4 就是 4 个人上限 (可以根据规则设置)
*/
int getSpaceSize();
/**
* set 房间空间大小
*
* @param spaceSize 房间空间大小。如 4 就是 4 个人上限 (可以根据规则设置)
*/
void setSpaceSize(int spaceSize);
/**
* get 房间状态
*
* @return 房间状态
*/
RoomStatusEnum getRoomStatusEnum();
/**
* set 房间状态
*
* @param roomStatusEnum 房间状态
*/
void setRoomStatusEnum(RoomStatusEnum roomStatusEnum);
/**
* get 创建房间信息（及玩法规则）
*
* @return 创建房间信息（及玩法规则）
*/
RoomCreateContext getRoomCreateContext();
/**
* 设置创建房间信息（及玩法规则）
*
* @param roomCreateContext 创建房间信息（及玩法规则）
*/
void setRoomCreateContext(RoomCreateContext roomCreateContext);
/**
* 房间创建者的 userId
*
* @return userId
*/
default long getCreatorUserId() {
return this.getRoomCreateContext().getCreatorUserId();
}
/**
* 当前 userId 是否是房间创建者
*
* @param userId userId
* @return true 是房间创建者
*/
default boolean isCreatorUserId(long userId) {
return this.getCreatorUserId() == userId;
}
/**
* 玩家列表: 所有玩家
*
* @param 玩家
* @return 所有玩家
*/
default Collection listPlayer() {
return (Collection) this.getPlayerMap().values();
}
/**
* steam players
*
* @return player Stream
*/
default Stream streamPlayer() {
return this.listPlayer().stream();
}
/**
* userId Collection
*
* @return userId
*/
default Collection listPlayerId() {
return this.getPlayerMap().keySet();
}
/**
* 通过 userId 查找玩家
*
* @param userId userId
* @param Player
* @return 玩家
*/
default T getPlayerById(long userId) {
return (T) this.getPlayerMap().get(userId);
}
/**
* 玩家是否存在房间内
*
* @param userId userId
* @return true 存在
*/
default boolean existUser(long userId) {
return this.getPlayerMap().get(userId) != null;
}
/**
* 添加玩家到房间内
*
* @param player 玩家
*/
default void addPlayer(Player player) {
player.setRoomId(this.getRoomId());
long userId = player.getUserId();
this.getPlayerMap().put(userId, player);
this.getPlayerSeatMap().put(player.getSeat(), userId);
}
/**
* 移除玩家
*
* @param player 玩家
*/
default void removePlayer(Player player) {
long userId = player.getUserId();
this.getPlayerMap().remove(userId);
this.getPlayerSeatMap().remove(player.getSeat());
}
/**
* 当前房间是否是所指定的房间状态
*
* @param roomStatusEnum 房间状态
* @return true 是所指定的房间状态
*/
default boolean isStatus(RoomStatusEnum roomStatusEnum) {
return this.getRoomStatusEnum() == roomStatusEnum;
}
/**
* 如果玩家在房间内，就执行给定的操作，否则不执行任何操作。
*
* @param userId userId
* @param action 给定操作
* @param t
*/
default void ifPlayerExist(long userId, Consumer action) {
T player = this.getPlayerById(userId);
Optional.ofNullable(player).ifPresent(action);
}
/**
* 如果玩家不在房间内，就执行给定的操作，否则不执行任何操作。
*
* @param userId userId
* @param runnable 给定操作
*/
default void ifPlayerNotExist(long userId, Runnable runnable) {
var player = this.getPlayerById(userId);
PresentKit.ifNull(player, runnable);
}
/**
* 统计房间内的玩家数量
*
* @return 玩家数量
*/
default int countPlayer() {
return this.getPlayerMap().size();
}
/**
* 房间内的是否没有玩家
*
* @return true 房间内没有玩家了
*/
default boolean isEmptyPlayer() {
return this.getPlayerMap().isEmpty();
}
/**
* 得到一个空位置
*
* @return >=0 表示有位置
*/
default int getEmptySeatNo() {
return RoomKit.getEmptySeatNo(this);
}
/**
* 玩家是否都准备了
*
* @return true 所有玩家都准备了
*/
default boolean isReadyPlayers() {
// 是否都准备了。玩家中，如果有任意一个没点准备的，notReady 为 true
boolean notReady = this.streamPlayer().anyMatch(player -> !player.isReady());
return !notReady;
}
/**
* forEach players
*
* the first argument is the userId
*
*
* @param action action
*/
default void forEach(BiConsumer action) {
this.getPlayerMap().forEach(action);
}
}