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

X File Storage：一行代码搞定30+存储平台的Java文件管理神器 [特殊字符]

news 2026/5/13 14:41:59

X File Storage：一行代码搞定30+存储平台的Java文件管理神器 🚀

【免费下载链接】x-file-storage一行代码将文件存储到本地、FTP、SFTP、WebDAV、谷歌云存储、阿里云OSS、华为云OBS、七牛云Kodo、腾讯云COS、百度云 BOS、又拍云USS、MinIO、 AWS S3、金山云 KS3、美团云 MSS、京东云 OSS、天翼云 OOS、移动云 EOS、沃云 OSS、网易数帆 NOS、Ucloud US3、青云 QingStor、平安云 OBS、首云 OSS、IBM COS、其它兼容 S3 协议的平台。后续即将支持 Samba、NFS项目地址: https://gitcode.com/dromara/x-file-storage

还在为不同云存储平台的API差异而烦恼吗？X File Storage让文件存储变得前所未有的简单！这个开源项目通过统一的API接口，支持本地存储、FTP、SFTP、WebDAV以及阿里云OSS、腾讯云COS等30多种主流存储平台，真正实现了"一次编码，处处存储"的理想。

✨ 为什么选择X File Storage？

🎯 极简集成体验

传统的文件存储方案需要为每个平台编写不同的代码逻辑，而X File Storage只需要简单的配置和一行核心代码就能完成文件上传。无论是个人项目还是企业级应用，都能快速上手使用。

🌈 全面的平台兼容性

项目支持几乎所有你能想到的存储方式：

本地存储：简单可靠
云存储平台：阿里云OSS、腾讯云COS、华为云OBS等
协议存储：FTP、SFTP、WebDAV
对象存储：MinIO、AWS S3及所有兼容S3协议的平台

🛠️ 快速开始指南

环境准备与依赖配置

确保你的项目满足以下基础要求：

JDK 8或更高版本
Maven构建工具
Spring Boot 2.x+（可选）

在pom.xml中添加核心依赖即可开始使用：

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

配置文件设置

在application.yml中进行简单配置：

dromara: x-file-storage: default-platform: aliyun-oss-1 aliyun-oss: - platform: aliyun-oss-1 access-key: your-access-key secret-key: your-secret-key end-point: your-endpoint bucket-name: your-bucket

启用文件存储服务

在Spring Boot启动类上添加启用注解：

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

📁 核心功能详解

文件上传的多种方式

X File Storage支持灵活的文件上传策略，你可以根据业务需求选择最适合的方式：

基础文件上传

// 单行代码完成文件上传 FileInfo fileInfo = fileStorageService.of(file).upload();

高级上传配置

// 带完整参数的上传 FileInfo fileInfo = fileStorageService.of(file) .setPath("upload/") // 存储路径 .setSaveFilename("custom.jpg") // 自定义文件名 .setObjectId("123") // 业务对象ID .setObjectType("user") // 业务对象类型 .putAttr("role","admin") // 自定义属性 .upload();

智能图片处理功能

内置强大的图片处理能力，无需额外集成图片处理服务：

// 图片缩放+缩略图生成 FileInfo fileInfo = fileStorageService.of(file) .image(img -> img.size(1000,1000)) // 主图缩放 .thumbnail(th -> th.size(200,200)) // 缩略图生成 .upload();