Spring Boot 集成阿里云OSS 完成文件上传下载

最新推荐文章于 2025-05-07 19:22:37 发布

码农爱java

最新推荐文章于 2025-05-07 19:22:37 发布

阅读量1k

点赞数 9

CC 4.0 BY-SA版权

分类专栏：【随笔--杂记】文章标签： spring boot 阿里云后端 Excel 文件上传下载 OSS

本文链接：https://blog.csdn.net/weixin_42118323/article/details/143776951

前言：

文件上传下载在项目开发中是一个非常常见的业务场景，在云服务上还没有兴起的时候，一般来说都会把文件单独存放到文件服务器上，随着云服务的兴起，各类云服务厂商都提供了 OSS 服务，本篇我们分享 Spring Boot 项目如何把文件存储到阿里云 OSS。

Spring Boot 集成阿里云 OSS

阿里云提供了 SDK，项目中引入相关依赖即可，我们在 pom.xml 文件中引入依赖如下：

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

阿里云访问信息

阿里云访问信息有四个如下：

Endpoint：OSS服务所在地域的访问域名。
AccessKeyId：访问OSS服务的密钥ID。
AccessKeySecret：访问OSS服务的密钥秘钥。
BucketName：您创建的存储空间名称。

阿里云 OSS 上传下载工具类

根据阿里云的访问要求封装了阿里云 OSS 上传下载工具类，如下：

import cn.hutool.core.util.StrUtil;
import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.common.comm.Protocol;
import com.aliyun.oss.model.GetObjectRequest;
import com.aliyun.oss.model.PutObjectRequest;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import java.net.URLDecoder;
import java.util.Date;

/**
 * @ClassName： AliyunOssUtil
 * @Author: Author
 * @Date: 2024/11/13 19:39
 * @Description:
 */
@Slf4j
@Component
public class AliyunOssUtil {
   
   

    @Value("${aliyun.oss.endpoint}")
    private String endpoint;

    @Value("${aliyun.oss.accessKeyId}")
    private String accessKeyId;

    @Value("${aliyun.oss.accessKeySecret}")
    private String accessKeySecret;

    @Value("${aliyun.oss.bucketName}")
    private String bucketName;

    /**
     * @return com.aliyun.oss.ClientBuilderConfiguration
     * @description 获取配置类
     */
    public ClientBuilderConfiguration getConfig() {
   
   
        // ClientBuilderConfiguration是OSSClient的配置类，可配置代理、连接超时、最大连接数等参数。
        ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
        // 设置从连接池中获取连接的超时时间（单位：毫秒），默认不超时。
        conf.setConnectionRequestTimeout(3000);
        // 设置连接空闲超时时间。超时则关闭连接，默认为60000毫秒。
        conf.setIdleConnectionTime(30000)