可用于搭建校园二手物品交易平台,支持用户注册登录、发布管理物品、浏览搜索筛选功能,具备JWT认证、WebSocket实时通知和响应式界面,采用Spring Boot后端与原生JavaScript前端实现数据持久化。【此简介由AI生成】
Access rate limit exceeded. Please log in to continue.
校园二手物品交易平台
一个基于Spring Boot和原生JavaScript的校园二手物品交易平台,支持用户注册、登录、发布物品、浏览物品、搜索筛选等功能。
功能特性
- ✅ 用户注册与登录
- ✅ JWT身份认证
- ✅ 物品发布与管理
- ✅ 物品浏览与搜索
- ✅ 实时通知(WebSocket)
- ✅ 响应式前端界面
- ✅ 数据持久化(MySQL)
技术栈
后端
- Spring Boot 3.5.7
- Spring Security(JWT认证)
- Spring Data JPA
- Spring WebSocket
- MySQL数据库
- JJWT(JWT令牌)
前端
- 原生HTML/CSS/JavaScript
- 响应式设计
- WebSocket实时通信
项目结构
d:\www\demo\
├── src/main/java/com/example/demo/
│ ├── config/ # 配置类
│ │ ├── SecurityConfig.java
│ │ └── WebSocketConfig.java
│ ├── controller/ # 控制器
│ │ ├── AuthController.java
│ │ ├── ItemController.java
│ │ ├── UserController.java
│ │ └── WebSocketController.java
│ ├── entity/ # 实体类
│ │ ├── Item.java
│ │ └── User.java
│ ├── repository/ # 数据访问层
│ │ ├── ItemRepository.java
│ │ └── UserRepository.java
│ ├── service/ # 业务逻辑层
│ │ ├── ItemService.java
│ │ └── UserService.java
│ ├── dto/ # 数据传输对象
│ │ ├── AuthRequest.java
│ │ ├── AuthResponse.java
│ │ ├── ItemRequest.java
│ │ ├── ItemResponse.java
│ │ └── UserResponse.java
│ └── util/ # 工具类
│ └── JwtUtil.java
├── src/main/resources/
│ ├── static/ # 前端静态资源
│ │ ├── index.html
│ │ └── js/app.js
│ └── application.properties
└── pom.xml
环境要求
- Java 21+
- MySQL 8.0+
- Maven 3.6+
快速开始
1. 数据库配置
- 创建MySQL数据库:
CREATE DATABASE campus_trade;
- 修改数据库连接配置(
src/main/resources/application.properties):
spring.datasource.url=jdbc:mysql://localhost:3306/campus_trade
spring.datasource.username=your_username
spring.datasource.password=your_password
2. 构建项目
cd d:\www\demo
mvn clean package
3. 运行项目
mvn spring-boot:run
或者直接运行JAR文件:
java -jar target/demo-0.0.1-SNAPSHOT.jar
4. 访问应用
打开浏览器访问:http://localhost:8080
API接口文档
认证相关
POST /api/auth/register- 用户注册POST /api/auth/login- 用户登录GET /api/auth/validate- 验证令牌
物品相关
GET /api/items- 获取所有物品GET /api/items/my- 获取我的物品(需认证)GET /api/items/{id}- 获取物品详情POST /api/items- 创建物品(需认证)PUT /api/items/{id}- 更新物品(需认证)DELETE /api/items/{id}- 删除物品(需认证)GET /api/items/search?keyword={keyword}- 搜索物品GET /api/items/filter?category={}&minPrice={}&maxPrice={}&condition={}&supportsDelivery={}- 筛选物品
用户相关
GET /api/users/profile- 获取用户资料(需认证)PUT /api/users/profile- 更新用户资料(需认证)
前端功能
页面导航
- 首页:展示所有物品
- 浏览物品:带筛选功能的物品浏览页面
- 发布帖子:发布新的二手物品
- 我的物品:管理自己发布的物品
- 登录/注册:用户认证
主要特性
- 响应式设计,支持移动端
- 实时物品更新通知
- 智能搜索和筛选
- 用户友好的界面交互
开发说明
数据库表结构
users表
- id (主键)
- username (用户名)
- password (加密密码)
- avatar (头像)
- created_at (创建时间)
- updated_at (更新时间)
items表
- id (主键)
- title (标题)
- description (描述)
- price (价格)
- category (分类)
- condition (新旧程度)
- supports_delivery (是否支持配送)
- user_id (用户ID,外键)
- created_at (创建时间)
- updated_at (更新时间)
安全配置
- 使用BCryptPasswordEncoder加密密码
- JWT令牌认证
- CORS跨域配置
- CSRF保护禁用(API项目)
部署说明
生产环境配置
- 修改
application.yml中的数据库连接 - 设置JWT密钥(jwt.secret)
- 配置静态资源路径
- 设置合适的文件上传大小限制
Docker部署(可选)
FROM openjdk:21-jdk-slim
COPY target/demo-0.0.1-SNAPSHOT.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]
常见问题
Q: 数据库连接失败
A: 检查MySQL服务是否启动,数据库连接配置是否正确
Q: 前端页面无法访问
A: 确保Spring Boot应用正常启动,检查端口8080是否被占用
Q: 文件上传失败
A: 检查文件大小是否超过配置限制,存储路径是否有写权限
许可证
MIT License
贡献
欢迎提交Issue和Pull Request来改进这个项目。
联系方式
如有问题请联系项目维护者。
Introduction
可用于搭建校园二手物品交易平台,支持用户注册登录、发布管理物品、浏览搜索筛选功能,具备JWT认证、WebSocket实时通知和响应式界面,采用Spring Boot后端与原生JavaScript前端实现数据持久化。【此简介由AI生成】
Customize your domain