多人游戏与网络同步 / 系统课时
怎样拆分网络层和大厅 UI
怎样拆分网络层和大厅 UI
大厅客户端一旦把 fetch、WebSocket 回调、状态修改和按钮渲染写在同一个组件里,任何协议变化都会牵动界面。本篇把请求、事件、状态和展示拆成明确边界,让网络细节可替换、状态更新可测试、UI 只关心用户意图与可渲染数据。
学习目标
- 区分请求层、事件层、状态层和展示层的职责
- 建立从服务端数据到 UI 的单向更新链路
- 用可独立测试的模块边界避免网络代码回流到组件
先按职责切开四层
一个可维护的大厅客户端不需要很多框架概念,但需要稳定边界。请求层负责一次性 HTTP 调用;事件层负责接收实时消息并转成客户端能识别的事件;状态层持有房间列表、连接状态和派生数据;展示层只读取状态并发出“刷新、加入、离开”等用户意图。

| 模块 | 应该负责 | 不应该负责 |
|---|---|---|
| 请求层 | URL、HTTP 方法、序列化、响应解析 | 弹 Toast、改 DOM、决定按钮文案 |
| 事件层 | 连接、订阅、重连、事件标准化 | 直接修改组件局部状态 |
| 状态层 | 合并快照与事件、保存请求状态、计算派生值 | 拼 HTTP 请求、操作页面节点 |
| 展示层 | 渲染状态、收集用户操作 | 解析服务端原始字段、管理重试协议 |
这样拆分后,协议字段变化只需要在网络边界适配;UI 看到的始终是稳定的客户端模型。
一个最小可运行的拆分
下面用一个无框架的 Node.js 示例模拟大厅。LobbyApi 只返回房间快照,LobbyEventClient 只分发事件,LobbyStore 负责合并状态,renderLobby 代表 React、Vue 或其他 UI 层的渲染函数。
class LobbyApi {
constructor(transport) {
this.transport = transport;
}
async listRooms() {
return this.transport("/rooms");
}
}
class LobbyEventClient {
constructor() {
this.listeners = new Set();
}
subscribe(listener) {
this.listeners.add(listener);
return () => this.listeners.delete(listener);
}
emit(event) {
// 事件层只分发标准事件,不直接改 UI。
for (const listener of this.listeners) listener(event);
}
}
class LobbyStore {
constructor() {
this.rooms = [];
this.listeners = new Set();
}
subscribe(listener) {
this.listeners.add(listener);
return () => this.listeners.delete(listener);
}
setRooms(rooms) {
this.rooms = rooms;
this.notify();
}
applyEvent(event) {
if (event.type !== "room.memberCountChanged") return;
// 所有房间数据变更都在状态层提交,UI 不自己维护副本。
this.rooms = this.rooms.map((room) =>
room.id === event.roomId
? { ...room, memberCount: event.memberCount }
: room
);
this.notify();
}
notify() {
const snapshot = this.rooms.map((room) => ({ ...room }));
for (const listener of this.listeners) listener(snapshot);
}
}
function renderLobby(rooms) {
const text = rooms
.map((room) => `${room.name} ${room.memberCount}/${room.capacity}`)
.join(", ");
console.log(`rooms: ${text}`);
}
// transport 在真实项目中可以替换成 fetch,而不影响 Store 与 UI。
const api = new LobbyApi(async (path) => {
if (path !== "/rooms") throw new Error("unexpected path");
return [
{ id: "r1", name: "Alpha", memberCount: 1, capacity: 4 },
];
});
const events = new LobbyEventClient();
const store = new LobbyStore();
store.subscribe(renderLobby);
events.subscribe((event) => store.applyEvent(event));
store.setRooms(await api.listRooms());
events.emit({
type: "room.memberCountChanged",
roomId: "r1",
memberCount: 2,
});预期输出:
rooms: Alpha 1/4
rooms: Alpha 2/4把这段代码换到真实项目时,transport 可以改成 fetch,LobbyEventClient 可以接 WebSocket,而 LobbyStore 与展示层不需要知道底层连接细节。
让数据只沿一个方向提交
最容易失控的耦合是“谁拿到数据谁就改 UI”。更稳妥的链路是:网络层产出响应或事件,状态层完成校验与合并,再由 UI 订阅状态变化。这样 HTTP 刷新和 WebSocket 推送最终走同一条提交路径,不会各自维护一份房间列表。
对实时事件,事件层最好先把协议字段转换成稳定的客户端事件,例如把服务端不同版本的成员数消息统一成 room.memberCountChanged。状态层只处理这种标准事件,避免协议版本判断散落在多个组件中。
如果一次请求有 loading、error 或“已被新请求替代”等状态,也应放进状态层或专门的请求状态模块。UI 根据这些状态决定按钮是否禁用、是否显示错误,而不是自己维护一套与网络生命周期平行的布尔变量。
用目录和测试守住边界
项目目录不必机械照搬某种框架,但命名应能让职责一眼可见。例如:
network/lobby-api.js:HTTP 请求与响应适配network/lobby-events.js:实时连接与事件标准化state/lobby-store.js:房间状态、请求状态和派生选择器ui/lobby-view.js:渲染与用户操作绑定
测试也应跟着边界拆。请求层测试状态码和数据映射;事件层测试原始消息能否转换成标准事件;状态层输入快照或事件后断言新状态;UI 测试给定状态时显示什么、用户点击后发出什么意图。
当某个模块开始同时出现 fetch、WebSocket 消息解析、房间数组修改和按钮文案时,就是边界正在回流的信号。优先把“外部协议”收进网络层,把“业务状态变更”收进状态层,再让 UI 只做展示与交互,后续重连、缓存或协议升级才不会把整个大厅页面一起改动。