Files
webgame-backend/src/main/java/com/webgame/webgamebackend/service/engine/RoomContext.java
T

114 lines
3.2 KiB
Java
Raw Normal View History

2026-06-30 10:20:26 +08:00
package com.webgame.webgamebackend.service.engine;
import com.webgame.webgamebackend.ws.dto.WsMessage;
2026-06-30 10:32:29 +08:00
import lombok.Getter;
2026-06-30 10:20:26 +08:00
import java.util.List;
import java.util.function.Consumer;
/**
* 房间上下文
*
* 游戏引擎初始化时由 RoomManager 传入,包含引擎所需的房间信息和回调接口。
* 引擎不应持有对 RoomManager 的直接引用,所有与房间层的交互通过此上下文完成。
*/
2026-06-30 10:32:29 +08:00
@Getter
2026-06-30 10:20:26 +08:00
public class RoomContext {
/** 房间 ID */
private final String roomId;
/** 游戏 ID */
private final String gameId;
2026-06-30 10:32:29 +08:00
/** 参与对局的玩家列表(按座位号排序,不可变) */
2026-06-30 10:20:26 +08:00
private final List<PlayerInfo> players;
/** 玩法模式 */
private final String mode;
/** 底注金额 */
private final int stakes;
2026-06-30 10:32:29 +08:00
/** 广播消息到房间内所有 WebSocket 会话(不暴露到 getter) */
2026-06-30 10:20:26 +08:00
private final Consumer<WsMessage> broadcaster;
2026-06-30 10:32:29 +08:00
/** 私有消息发送器(不暴露到 getter) */
2026-06-30 10:20:26 +08:00
private final PrivateMessageSender privateSender;
2026-06-30 10:32:29 +08:00
/** 游戏结束回调(不暴露到 getter) */
2026-06-30 10:20:26 +08:00
private final GameOverCallback onGameOver;
public RoomContext(String roomId, String gameId, List<PlayerInfo> players,
String mode, int stakes,
Consumer<WsMessage> broadcaster,
PrivateMessageSender privateSender,
GameOverCallback onGameOver) {
this.roomId = roomId;
this.gameId = gameId;
this.players = List.copyOf(players); // 防御性拷贝
this.mode = mode;
this.stakes = stakes;
this.broadcaster = broadcaster;
this.privateSender = privateSender;
this.onGameOver = onGameOver;
}
/**
* 广播消息到房间内所有人
*/
public void broadcast(WsMessage message) {
broadcaster.accept(message);
}
/**
* 向指定用户发送私有消息(如重连时的状态同步)
*/
public void sendToUser(String userId, WsMessage message) {
privateSender.send(userId, message);
}
/**
* 游戏结束,通知房间层
*
* @param winnerId 胜者 accountId,null 表示平局
* @param resultType 结果类型(win / draw / resign)
*/
public void gameOver(String winnerId, String resultType) {
onGameOver.onGameOver(winnerId, resultType);
}
/**
* 房间内玩家简要信息
*/
public record PlayerInfo(String userId, int seatNumber) {}
/**
* 游戏结束回调接口
*/
@FunctionalInterface
public interface GameOverCallback {
/**
* 游戏结束通知
*
* @param winnerId 胜者 accountId,null 表示平局
* @param resultType 结果类型
*/
void onGameOver(String winnerId, String resultType);
}
/**
* 私有消息发送接口
*/
@FunctionalInterface
public interface PrivateMessageSender {
/**
* 向指定用户的所有 WebSocket 会话发送消息
*
* @param userId 目标用户 accountId
* @param message 消息
*/
void send(String userId, WsMessage message);
}
}