基于 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。

项目结构概览

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

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                 # 项目说明文档

数据库设计 (MySQL)

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

核心功能模块与 API

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

认证与用户信息

好友与会话管理

消息服务

环境与运行指南

运行环境要求

• Java Development Kit (JDK): 1.8 或更高版本
• MySQL Server: 5.7 或更高版本
• Maven: 3.6 或更高版本

部署步骤

首先确保 MySQL 服务运行，并创建一个名为 java_chatroom 的数据库。打开 src/main/resources/application.yml 文件，修改 username 和 password 为您的 MySQL 账户信息。

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/java_chatroom?...
    username: root
    password: your_password

执行 SQL 脚本初始化数据库结构：

mysql -u root -p < src/main/java/db.sql

克隆项目后，使用 Maven 编译和启动：

mvn clean install
mvn spring-boot:run

启动成功后，在浏览器访问 http://localhost:8080/login.html 即可体验。

后续扩展方向

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

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