推荐项目- 项目地址：https://github.com/dromara/x-file-storage- 类别：Java- 项目标题： X File Storage 一站式文件存储- 项目描述：解决接入多个存储平台的繁琐流程，按照以往流程，每换一个存储平台都要修改大量代码，非常麻烦！特别是外包公司，不同的客户有不同的要求，这个项目就是解决这个问题的，一行代码将文件存储到本地、FTP、SFTP、WebDAV、GoogleCloud Storage、FastDFS、Azure Blob Storage、Mongo GridFS、Amazon S3及其兼容的存储平台（MinIO、阿里云 OSS、华为云 OBS、七牛云 Kodo、腾讯云 COS、百度云 BOS、又拍云 USS、金山云 KS3、美团云 MSS、京东云 OSS、天翼云 OOS、移动 云EOS、沃云 OSS、 网易数帆 NOS、Ucloud US3、青云 QingStor、平安云 OBS、首云 OSS、IBM COS）通过 WebDAV 连接到 Alist 后，可以使用百度网盘、天翼云盘、阿里云盘、迅雷网盘等常见存储服务。- 亮点：扩展性极强，可以自定义切面，用于增强功能；可自定义存储平台，方便兼容私有存储协议；可自定义文件适配器，随心所欲；支持保存到数据库，方便管理；支持一键压缩图片、生成缩略图，方便快捷。还有其它更多高级功能，例如客户端上传、跨存储平台复制移动文件，可以用于数据迁移或备份；ACL访问控制列表（文件权限管理）；Metadata 元数据等。支持 SpringBoot 和 Solon 的自动配置，也可以用在其它各种框架中不同于其它类似的开源项目，这个项目支持的存储平台最多，使用最方便，从一个存储平台切换到另一个存储平台只需要修改一下配置就行了，无需修改任何代码。非常适合快速开发平台、SaaS系统以及外包公司使用。- 示例代码：点击 快速入门 查看全部存储平台的使用方法！#### 🔧 配置这里以阿里云 OSS 为例，pom.xml 引入本项目，这里默认是 SpringBoot 环境，Solon 环境参考 在 Solon 中使用，其它环境参考 脱离 SpringBoot 单独使用xml<!-- 引入本项目 --><dependency> <groupId>org.dromara.x-file-storage</groupId> <artifactId>x-file-storage-spring</artifactId> <version>2.2.1</version></dependency><!-- 引入 阿里云 OSS SDK，如果使用其它存储平台，就引入对应的 SDK --><dependency> <groupId>com.aliyun.oss</groupId> <artifactId>aliyun-sdk-oss</artifactId> <version>3.16.1</version></dependency> application.yml 配置文件中添加以下基础配置关于配置文件及 FileInfo 中各种路径（path）的区别，可以参考 常见问题yamldromara: x-file-storage: #文件存储配置 default-platform: aliyun-oss-1 #默认使用的存储平台 aliyun-oss: - platform: aliyun-oss-1 # 存储平台标识 enable-storage: true # 启用存储 access-key: ?? secret-key: ?? end-point: ?? bucket-name: ?? domain: ?? # 访问域名，注意“/”结尾，例如：https://abc.oss-cn-shanghai.aliyuncs.com/ base-path: test/ # 基础路径#### 🔨编码在启动类上加上@EnableFileStorage注解java@EnableFileStorage@SpringBootApplicationpublic class SpringFileStorageTestApplication { public static void main(String[] args) { SpringApplication.run(SpringFileStorageTestApplication.class,args); }} #### ✨开始上传 支持 File、MultipartFile、UploadedFile、byte[]、InputStream、URL、URI、String、HttpServletRequest，大文件会自动分片上传。如果想支持更多方式，请阅读 文件适配器 章节java@RestControllerpublic class FileDetailController { @Autowired private FileStorageService fileStorageService;//注入实列 /** * 上传文件 */ @PostMapping("/upload") public FileInfo upload(MultipartFile file) { //只需要这一行代码即可上传成功 return fileStorageService.of(file).upload(); } /** * 上传文件，成功返回文件 url */ @PostMapping("/upload2") public String upload2(MultipartFile file) { FileInfo fileInfo = fileStorageService.of(file) .setPath("upload/") //保存到相对路径下，为了方便管理，不需要可以不写 .setSaveFilename("image.jpg") //设置保存的文件名，不需要可以不写，会随机生成 .setObjectId("0") //关联对象id，为了方便管理，不需要可以不写 .setObjectType("0") //关联对象类型，为了方便管理，不需要可以不写 .putAttr("role","admin") //保存一些属性，可以在切面、保存上传记录、自定义存储平台等地方获取使用，不需要可以不写 .upload(); //将文件上传到对应地方 return fileInfo == null ? "上传失败！" : fileInfo.getUrl(); } /** * 上传图片，成功返回文件信息 * 图片处理使用的是 https://github.com/coobird/thumbnailator */ @PostMapping("/upload-image") public FileInfo uploadImage(MultipartFile file) { return fileStorageService.of(file) .image(img -> img.size(1000,1000)) //将图片大小调整到 1000*1000 .thumbnail(th -> th.size(200,200)) //再生成一张 200*200 的缩略图 .upload(); } /** * 上传文件到指定存储平台，成功返回文件信息 */ @PostMapping("/upload-platform") public FileInfo uploadPlatform(MultipartFile file) { return fileStorageService.of(file) .setPlatform("aliyun-oss-1") //使用指定的存储平台 .upload(); } /** * 直接读取 HttpServletRequest 中的文件进行上传，成功返回文件信息 * 使用这种方式有些注意事项，请查看文档 基础功能-上传 章节 */ @PostMapping("/upload-request") public FileInfo uploadPlatform(HttpServletRequest request) { return fileStorageService.of(request).upload(); }}#### 🎨其它操作java//手动构造文件信息，可用于其它操作FileInfo fileInfo = new FileInfo() .setPlatform("huawei-obs-1") .setBasePath("test/") .setPath("aa/") .setFilename("image.png") .setThFilename("image.png.min.jpg");//文件是否存在boolean exists = fileStorageService.exists(fileInfo);//下载byte[] bytes = fileStorageService.download(fileInfo).bytes();//删除fileStorageService.delete(fileInfo);//其它更多操作如果将文件记录保存到数据库中，还可以更方便的根据 URL 进行操作了，详情请阅读 保存上传记录 章节java//直接从数据库中获取 FileInfo 对象，更加方便执行其它操作FileInfo fileInfo = fileStorageService.getFileInfoByUrl("https://abc.def.com/test/aa/image.png");//文件是否存在boolean exists = fileStorageService.exists("https://abc.def.com/test/aa/image.png");//下载byte[] bytes = fileStorageService.download("https://abc.def.com/test/aa/image.png").bytes();//删除fileStorageService.delete("https://abc.def.com/test/aa/image.png");//其它更多操作点击 快速入门 查看全部存储平台的使用方法！- 截图：- 后续更新计划：适配更多存储平台