SpringBoot整合阿里云OSS文件上传、下载、查看、删除，打造高效存储管理方案

2023-09-12 21:23:24

将 SpringBoot 与阿里云 OSS 整合：高效的文件存储管理解决方案

一、引言

数据爆炸的时代，存储空间的重要性日益凸显。阿里云 OSS 凭借其稳定性、安全性、高扩展性等特性，成为众多企业和个人的云存储首选。而 SpringBoot 作为 Java 领域备受欢迎的微服务框架，以其简单易用、开箱即用的特点备受开发者青睐。将 SpringBoot 与阿里云 OSS 整合，可实现文件上传、下载、查看、删除等一系列操作，为用户提供高效便捷的文件存储管理解决方案。

二、构建 Bucket

使用阿里云 OSS，首要任务是创建 Bucket，它就好比一个盛放文件的容器。

登录阿里云控制台 ，点击“对象存储 OSS”，然后点击“创建 Bucket”。
填写信息 ，包括 Bucket 名称、区域等，点击“确定”。

三、配置 SpringBoot 项目

在 SpringBoot 项目中，需引入阿里云 OSS 的 Java SDK。

添加依赖 ，在 pom.xml 文件中：

<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.11.0</version>
</dependency>

启用 OSS 服务 ，在 SpringBoot 主类中：

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

四、文件上传

有了 OSS 和 SpringBoot，文件上传变得轻而易举：

@PostMapping("/upload")
public String upload(@RequestParam("file") MultipartFile file) {
    // 获取文件名
    String fileName = file.getOriginalFilename();
    // 创建 OSS 客户端
    OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
    // 上传文件
    ossClient.putObject(bucketName, fileName, file.getInputStream());
    // 关闭 OSS 客户端
    ossClient.shutdown();
    return "上传成功";
}

五、文件下载

文件下载同样简单：

@GetMapping("/download/{fileName}")
public void download(@PathVariable("fileName") String fileName, HttpServletResponse response) {
    // 创建 OSS 客户端
    OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
    // 下载文件
    ossClient.getObject(bucketName, fileName, response.getOutputStream());
    // 关闭 OSS 客户端
    ossClient.shutdown();
}

六、文件查看

查看文件也很方便：

@GetMapping("/view/{fileName}")
public String view(@PathVariable("fileName") String fileName, Model model) {
    // 创建 OSS 客户端
    OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
    // 下载文件
    ossClient.getObject(bucketName, fileName, new File(fileName));
    // 关闭 OSS 客户端
    ossClient.shutdown();
    // 将文件名传给模板引擎
    model.addAttribute("fileName", fileName);
    return "view";
}

七、文件删除

最后，文件删除也很简单：

@DeleteMapping("/delete/{fileName}")
public String delete(@PathVariable("fileName") String fileName) {
    // 创建 OSS 客户端
    OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
    // 删除文件
    ossClient.deleteObject(bucketName, fileName);
    // 关闭 OSS 客户端
    ossClient.shutdown();
    return "删除成功";
}