基于 Spring Boot 与 WebSocket 的 Java 实时聊天室系统

系统架构与数据流

本项目的核心在于 Spring Boot + WebSocket 实现的实时通信机制。采用经典的三层架构（Controller/Service/Dao）配合 WebSocket 模型。

核心通信流程

1. 用户通过 HTTP /login 登录成功后，获取会话信息。
2. 用户发起 WebSocket 连接请求到 /WebSocketMessage。
3. 服务器将用户 ID 和对应的 WebSocket 会话 (Session) 绑定存储。
4. 用户 A 发送消息到服务器（通过 WebSocket）。
5. 服务器根据消息中的目标用户 ID 查找对应的 WebSocket Session。
6. 服务器通过目标 Session 将消息实时推送给用户 B。

项目结构概览

清晰的模块化结构，便于开发者理解和维护：

text
java_chatroom/
├── src/
│   ├── main/
│   │   ├── java/com/example/java_chatroom/
│   │   │   ├── api/          # Controller 层
│   │   │   ├── component/    # 组件类
│   │   │   ├── config/       # 配置类
│   │   │   └── model/        # 数据模型
│   │   ├── resources/
│   │   │   ├── mapper/       # MyBatis XML 映射文件
│   │   │   └── static/       # 前端静态资源 (HTML/CSS/JS)
│   │   └── db.sql            # 数据库初始化脚本
├── pom.xml                   # Maven 依赖配置
└── README.md                 # 项目说明文档

数据库设计

系统采用 5 个核心数据表来实现用户关系和消息存储。

核心功能模块与 API

项目主要通过 RESTful API 和 WebSocket 端点实现功能。

认证与用户信息

好友与会话管理

消息服务

功能特性总结

1. 用户认证体系: 支持用户注册新账号，实现基于会话的登录校验。
2. 高效实时通信: 利用 WebSocket 实现消息的毫秒级推送，支持一对一私密聊天。
3. 完善的消息与会话管理: 自动管理私聊会话的创建与激活，持久化存储消息记录。
4. 基础的好友关系: 展示当前用户的好友列表。

未来展望

本项目可进一步扩展以实现更丰富的功能：

• 好友请求功能: 实现用户搜索、发送/接受好友请求的完整流程。
• 个性化展示: 用户添加头像，个性签名等。
• 群聊支持: 扩展会话模型，支持多人聊天室和群组管理。
• 消息类型扩展: 支持发送图片、文件和表情包。
• 用户状态管理: 实时显示用户的在线/离线状态和最后活跃时间。
• UI/UX 优化: 引入更现代的前端框架或库，实现响应式设计。