一个基于Spring Boot + WebSocket的简单聊天室应用,支持实时消息发送、文件上传和消息撤回功能。
AIGC,本项目99%部分的代码由AI完成,包括自述文件
需要Java8
java -jar LanChat.jar打开浏览器访问:http://localhost:8078 / http://你的IP:8078
- ✅ 无需登录:用户以IP地址作为身份标识
- ✅ 实时聊天:基于WebSocket的实时消息传输
- ✅ 文件分享:支持文件上传下载(最大10MB)
- ✅ 消息撤回:可以撤回自己发送的消息
- ✅ 历史记录:聊天记录永久保存,支持流式加载
- ✅ 离线运行:完全本地化,无外部依赖
- ✅ 响应式设计:支持桌面和移动设备
- 后端:Spring Boot 2.7.6 + WebSocket + JPA + H2 Database
- 前端:Thymeleaf + 原生JavaScript + CSS
- 数据库:H2内存数据库(文件持久化)
- 构建工具:Maven
- Java 8 或更高版本
- Maven 3.6 或更高版本
LanChat/
├── src/main/java/cn/yaklo/lanchat/
│ ├── config/ # 配置类
│ │ ├── NativeWebSocketConfig.java
│ │ └── WebSocketConfig.java
│ ├── controller/ # 控制器
│ │ ├── ChatController.java
│ │ ├── FileController.java
│ │ ├── WebSocketController.java
│ │ └── WebSocketNativeController.java
│ ├── demos/ # 演示代码
│ │ └── web/
│ │ ├── BasicController.java
│ │ ├── PathVariableController.java
│ │ └── User.java
│ ├── dto/ # 数据传输对象
│ │ └── ChatMessageDto.java
│ ├── entity/ # 实体类
│ │ ├── ChatFile.java
│ │ └── ChatMessage.java
│ ├── interceptor/ # 拦截器
│ │ └── WebSocketHandshakeInterceptor.java
│ ├── repository/ # 数据访问层
│ │ ├── ChatFileRepository.java
│ │ └── ChatMessageRepository.java
│ ├── service/ # 服务层
│ │ ├── ChatService.java
│ │ ├── FileService.java
│ │ └── UserService.java
│ ├── util/ # 工具类
│ │ └── IpUtil.java
│ └── LanChatApplication.java # 启动类
├── src/main/resources/
│ ├── application.properties # 配置文件
│ ├── static/ # 静态资源
│ │ ├── index.html
│ │ └── test.html
│ └── templates/ # 页面模板
│ └── chat.html # 聊天室页面
├── data/ # 运行时数据目录
│ ├── db/ # 数据库文件
│ └── upfile/ # 上传文件
└── pom.xml # Maven配置
默认端口为8078,可在application.properties中修改:
server.port=8078- 单条消息限制:128KB
- 最大文件大小:100MB
- 上传目录:
./data/upfile
- 数据库类型:H2
- 数据文件位置:
./data/db/chatdb - Web控制台:
http://localhost:8078/h2-console
- 离线环境:本项目无外部CDN依赖,所有资源内联,适合离线环境运行
- 数据持久化:聊天记录和上传文件均保存在本地
./data目录下 - 网络安全:本项目设计为局域网使用,如需公网部署请添加安全认证
- 浏览器兼容性:支持现代浏览器的WebSocket功能
- 文件安全:上传文件仅做基础验证,生产环境建议增加安全检查
A: 修改UserService.java中的formatUserName方法。
A: 修改ChatController.java中的默认size参数。
A: 修改application.properties中的spring.servlet.multipart.max-file-size。
A: 用户名:san,密码:空(可在application.properties中修改)
