校园二手交易:基于Spring Boot和原生JavaScript的校园二手交易平台项目

可用于搭建校园二手物品交易平台,支持用户注册登录、发布管理物品、浏览搜索筛选功能,具备JWT认证、WebSocket实时通知和响应式界面,采用Spring Boot后端与原生JavaScript前端实现数据持久化。【此简介由AI生成】

Branch1Tags0

校园二手物品交易平台

一个基于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. 数据库配置

  1. 创建MySQL数据库:
CREATE DATABASE campus_trade;
  1. 修改数据库连接配置(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项目)

部署说明

生产环境配置

  1. 修改application.yml中的数据库连接
  2. 设置JWT密钥(jwt.secret)
  3. 配置静态资源路径
  4. 设置合适的文件上传大小限制

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