多人游戏与网络同步 / 系统课时

怎样拆分网络层和大厅 UI

怎样拆分网络层和大厅 UI

大厅客户端一旦把 fetch、WebSocket 回调、状态修改和按钮渲染写在同一个组件里,任何协议变化都会牵动界面。本篇把请求、事件、状态和展示拆成明确边界,让网络细节可替换、状态更新可测试、UI 只关心用户意图与可渲染数据。

学习目标

  • 区分请求层、事件层、状态层和展示层的职责
  • 建立从服务端数据到 UI 的单向更新链路
  • 用可独立测试的模块边界避免网络代码回流到组件

先按职责切开四层

一个可维护的大厅客户端不需要很多框架概念,但需要稳定边界。请求层负责一次性 HTTP 调用;事件层负责接收实时消息并转成客户端能识别的事件;状态层持有房间列表、连接状态和派生数据;展示层只读取状态并发出“刷新、加入、离开”等用户意图。

大厅客户端网络层与 UI 的职责边界

模块 应该负责 不应该负责
请求层 URL、HTTP 方法、序列化、响应解析 弹 Toast、改 DOM、决定按钮文案
事件层 连接、订阅、重连、事件标准化 直接修改组件局部状态
状态层 合并快照与事件、保存请求状态、计算派生值 拼 HTTP 请求、操作页面节点
展示层 渲染状态、收集用户操作 解析服务端原始字段、管理重试协议

这样拆分后,协议字段变化只需要在网络边界适配;UI 看到的始终是稳定的客户端模型。

一个最小可运行的拆分

下面用一个无框架的 Node.js 示例模拟大厅。LobbyApi 只返回房间快照,LobbyEventClient 只分发事件,LobbyStore 负责合并状态,renderLobby 代表 React、Vue 或其他 UI 层的渲染函数。

js
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,
});

预期输出:

text
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 只做展示与交互,后续重连、缓存或协议升级才不会把整个大厅页面一起改动。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

怎样拆分网络层和大厅 UI

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通