当前位置：首页 > news >正文

spring boot文件上传之x-file-storage

news 2025/8/4 2:57:11

spring boot文件上传之x-file-storage

今天看到一个文件上传的开源组件x-file-storage，官方地址如下：

https://x-file-storage.xuyanwu.cn/#/

该组件官网是这样介绍的，如下：

一行代码将文件存储到本地、FTP、SFTP、WebDAV、阿里云 OSS、华为云 OBS、七牛云 Kodo、腾讯云 COS、百度云 BOS、又拍云 USS、MinIO、 Amazon S3、GoogleCloud Storage、FastDFS、 Azure Blob Storage、Cloudflare R2、金山云 KS3、美团云 MSS、京东云 OSS、天翼云 OOS、移动云EOS、沃云 OSS、网易数帆 NOS、Ucloud US3、青云 QingStor、平安云 OBS、首云 OSS、IBM COS、其它兼容 S3 协议的存储平台。查看所有支持的存储平台

具体学习的话可以详细参考该组件网站给的示例

这里以springboot3为例，文件上传到本地做了一个简单测试，代码如下

第一步，引入pom依赖

		<dependency><groupId>org.dromara.x-file-storage</groupId><artifactId>x-file-storage-spring</artifactId><version>2.2.1</version></dependency>

第二步，配置yaml

dromara:x-file-storage: default-platform: local-plus-1 thumbnail-suffix: ".min.jpg" local-plus:- platform: local-plus-1 enable-storage: true  enable-access: true domain: http://127.0.0.1:8080/file/ base-path: local-plus/path-patterns: /file/** storage-path: D:/Temp/

第三步，编写controller

@RestController
public class FileController {@Autowiredprivate FileStorageService fileStorageService;/*** 上传文件*/@PostMapping("/upload")public FileInfo upload(@RequestParam("file")MultipartFile file) {String originalFilename = file.getOriginalFilename();FileInfo upload = fileStorageService.of(file).setSaveFilename(originalFilename).upload();return upload;}
}

第四步，启动类上添加开启启用该组件注解

@SpringBootApplication
@EnableFileStorage
public class XFileStorageApplication {public static void main(String[] args) {SpringApplication.run(XFileStorageApplication.class, args);}}