项目简介
本项目是基于Spring Boot框架的文件管理系统,可简单、高效地管理文件的上传、下载和存储。它整合了本地文件服务、MinIO分布式文件服务和阿里云OSS服务,能满足不同场景下的文件管理需求。
项目的主要特性和功能
- 多模块管理:各模块负责配置管理、数据库操作、模板引擎、日志记录等不同功能。
- 配置管理:支持从
yaml
和properties
文件读取配置,用@Value
和@ConfigurationProperties
注解绑定配置。 - 静态资源和模板引擎:支持Freemarker和Thymeleaf模板引擎生成动态内容。
- 数据库操作:支持MySQL数据库,有JDBC、JPA操作,集成MyBatis和MyBatis - Plus。
- 日志框架:集成日志框架记录系统运行日志。
- 全局异常处理:提供全局异常处理机制统一处理异常。
- 分布式文件服务:支持本地、MinIO和阿里云OSS服务进行文件上传和下载。
- 用户管理:具备用户注册、登录、信息更新和头像上传等功能。
安装使用步骤
1. 环境准备
- Java 8 或更高版本
- Maven 3.x
- MySQL 5.7 或更高版本
- MinIO 或阿里云OSS账号
2. 复制项目
bash
cd spring-boot-file-management
3. 配置数据库
在application.properties
或application.yml
文件中配置数据库连接信息:
properties
spring.datasource.url=jdbc:mysql://localhost:3306/yourdatabase
spring.datasource.username=yourusername
spring.datasource.password=yourpassword
4. 配置文件存储服务
本地文件服务
在application.properties
或application.yml
文件中配置本地文件存储路径:
properties
file.upload-path=D:\\Projects\\Subjects\\Spring Boot Back Basic\\upload
MinIO分布式文件服务
在application.properties
或application.yml
文件中配置MinIO连接信息:
properties
minio.endPoint=http://43.137.12.232:9000
minio.accessKey=admin
minio.secretKey=admin123
阿里云OSS服务
在application.properties
或application.yml
文件中配置阿里云OSS连接信息:
properties
aliyun-oss.endpoint=your-oss-endpoint
aliyun-oss.bucket=your-bucket-name
aliyun-oss.dir=your-directory
aliyun-oss.host=your-oss-host
aliyun-oss.ak=your-access-key
aliyun-oss.secret=your-secret-key
5. 启动项目
在项目根目录下运行以下命令启动项目:
bash
mvn spring-boot:run
6. 访问项目
项目启动后,可通过浏览器访问以下地址:
- 本地文件服务:http://localhost:8080/file/upload
- MinIO文件服务:http://localhost:8080/file/uploadMinio
- 阿里云OSS服务:http://localhost:8080/file/uploadOss
7. 用户管理
- 用户注册:
POST /user/add
- 用户登录:
POST /user/login
- 获取用户信息:
GET /user/info?username=yourusername
- 更新用户信息:
PUT /user/update
- 上传用户头像:
POST /user/avatar
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】