【独家整理】Spring Boot WebSocket 聊天室实战:群聊到一对一私聊,开箱即用
【独家整理】Spring Boot WebSocket 聊天室实战:群聊到一对一私聊,开箱即用
想给应用加实时聊天,还在靠页面轮询?这个项目可以直接跑起来看效果。Spring Boot WebSocket 聊天室接好了端点、配好了三个页面,多人聊天和单人聊天两种玩法,克隆下来就能验证。
🧩 它是什么,解决什么问题
这是一个基于 Spring Boot 和 WebSocket 的聊天室应用,面向想快速搞懂双向通信、又需要现成可运行示例的开发者。核心能力是两条:多人同房间收发消息,以及指定用户之间的一对一私聊。仓库里 demo.zip 打包了完整源码,导入 IDE 即可运行,不依赖额外的中间件。
核心功能拆解
多人会话:开几个标签页,消息立刻流转
多人聊天入口是 public.html,页面打开后自动生成形如"风清扬+随机数"的昵称并连上服务器。你可以在本地开多个浏览器标签页,各自发消息,其他页面无需刷新就能看到新消息——这是演示多人场景最快的方式。
单人私聊:两个固定页面,消息只发给对方
单人聊天提供了 wukong.html 和 bajie.html 两个固定页面,模拟两人对话。服务端收到消息后按昵称(nickname/nickname2)在连接表里查对端,只对双方投递,并给各自打上 isSelf 标记,前端据此把消息显示在左右两侧。
连接管理:上线下线自动计数
端点用 @OnOpen 和 @OnClose 维护了一个静态的在线人数计数,每次有人加入或断开都会打印当前在线数,方便你观察连接状态,也省去了自己写这部分代码的功夫。
⚙️ 技术实现速览
| 技术 | 承担的角色 | 选型理由 |
|---|---|---|
| Spring Boot 2.0.4 | 后端框架,托管 8080 端口 | 自动配置,导入 Maven 项目直接运行 |
| spring-boot-starter-websocket | 实时通信核心 | 全双工推送,服务端主动下发消息 |
| Java 8 + json-lib | 消息组装与 JSON 序列化 | 轻量,客户端消息格式统一为 JSON |
| jQuery + Amaze UI | 聊天页面 UI | 纯静态页面,前端零构建 |
数据流向很短:浏览器执行 new WebSocket("ws://localhost:8080/websocket/" + 昵称) 建立连接 → @ServerEndpoint("/websocket/{userno}") 标注的 MyWebSocket 用 @OnMessage 收消息 → ConcurrentHashMap 按用户标识找到对端连接并 sendMessage → 页面拿到 JSON(nickname/date/content/isSelf)后渲染气泡。
配置类只注册了一个 ServerEndpointExporter Bean,整个服务端逻辑集中在一个文件里,读起来没有负担。
🎯 适合哪些场景
- 课堂演示与学习 —— 一个文件读懂 WebSocket 端点的完整生命周期
- 团队群聊原型 —— 验证消息实时性,再往登录、房间上扩展
- 一对一客服 Demo —— 参考私聊的双向投递写法
- 二次开发基线 —— 代码结构简单,加认证、换存储成本低
🚀 快速上手,三步跑起来
- 克隆仓库:
git clone https://gitcode.com/open-source-toolkit/7eac9 - 解压
demo.zip,用 IntelliJ IDEA 或 Eclipse 导入这个 Maven 项目(需 Java 8 与 Maven) - 运行
DemoApplication,浏览器打开:多人聊天http://localhost:8080/public.html,单人聊天http://localhost:8080/wukong.html与http://localhost:8080/bajie.html
仓库内资料:README.md 写有使用说明,demo.zip 是完整源码包(含 pom.xml 与全部页面),LICENSE 是许可文本。
🤝 参与与社区
项目采用 MIT 许可证,可自由使用和修改。作者已注明"登录等功能待后续完善",这是现成的入手点。有问题或想法直接在 Issues 里提,也欢迎提交 Pull Request。
去仓库把项目跑一遍,卡住了就把报错贴到 Issue 里,顺便看看私聊那段 sendToUser 的实现。