在Springboot项目中实现将文件上传至阿里云 OSS

oss介绍

阿里云对象存储服务(OSS)是一种高效、安全和成本低廉的数据存储服务,可以用来存储和管理海量的数据文件。本文将教你如何使用 Java 将文件上传到阿里云 OSS,并实现访问文件。

1. 准备工作

1.1 开通 OSS 服务

登录阿里云官网,进入 OSS 控制台,创建一个存储桶(Bucket)。配置时需注意:

  • Bucket 名称:必须是全球唯一。
  • 访问权限 :根据需求选择 公共读 或 私有。

1.2 获取访问密钥

在阿里云控制台,进入 AccessKey 管理页面 ,创建 AccessKey 并保存 AccessKey ID 和 AccessKey Secret。


2. 引入必要的依赖

2.1 Maven 依赖

确保你的项目使用 Maven 管理,在 pom.xml 文件中添加阿里云 OSS 的依赖:

java 复制代码
!--阿里云oss依赖坐标-->
        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>3.17.4</version>
        </dependency>
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
            <version>2.3.1</version>
        </dependency>
        <dependency>
            <groupId>javax.activation</groupId>
            <artifactId>activation</artifactId>
            <version>1.1.1</version>
        </dependency>
        <!-- no more than 2.3.3-->
        <dependency>
            <groupId>org.glassfish.jaxb</groupId>
            <artifactId>jaxb-runtime</artifactId>
            <version>2.3.3</version>
        </dependency>

3. 配置上传工具类

创建一个工具类 AliOssUtil,实现文件上传功能。

工具类代码

java 复制代码
package com.itzx.utils;

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.PutObjectRequest;
import com.aliyun.oss.model.PutObjectResult;

import java.io.InputStream;

public class AliOssUtil {
    // Endpoint以华东1(杭州)为例,其它Region请按实际情况填写。
    private static final String ENDPOINT = "https://oss-cn-beijing.aliyuncs.com";
    // 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    private static final String ACCESS_KEY_ID = "LTAI5tGszDz8GJEHECogCh4P";
    private static final String ACCESS_KEY_SECRET = "uJOmUYxkB3Cn8oQAiLhvmNYYIt59Em";
    // 填写Bucket名称,例如examplebucket。
    private static final String BUCKET_NAME = "zx-0415-zk";

    public static String uploadFile(String objectName, InputStream in) throws Exception {
        OSS ossClient = new OSSClientBuilder().build(ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET);
        String url="";
        try {
            // 填写字符串。
            String content = "Hello OSS,你好世界";

            // 创建PutObjectRequest对象。
            PutObjectRequest putObjectRequest = new PutObjectRequest(BUCKET_NAME, objectName, in);
            
            // 上传字符串。
            PutObjectResult result = ossClient.putObject(putObjectRequest);
            //url组成
            url = "https://" + BUCKET_NAME + "." + ENDPOINT.replace("https://", "").replace("http://", "") + "/" + objectName;

        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
        return url;
    }
}

4. 测试文件上传功能

编写测试代码调用工具类,验证文件上传功能。

测试代码

java 复制代码
package com.itzx.controller;

import com.itzx.pojo.Result;
import com.itzx.utils.AliOssUtil;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

import java.util.UUID;

@RestController
public class FileUploadController {

    @PostMapping("/upload")
    public Result<String> upload(MultipartFile file) throws Exception {
        //把文件的内容存储到本地磁盘上
        String originalFilename= file.getOriginalFilename();
        String filename= UUID.randomUUID().toString()+originalFilename.substring(originalFilename.lastIndexOf("."));
        String url= AliOssUtil.uploadFile(filename, file.getInputStream());
        return Result.success(url);
    }
}

5. 注意事项

  1. Endpoint 配置

    根据你的 OSS 所在的地域选择对应的 Endpoint,例如华北 2(北京)是 https://oss-cn-beijing.aliyuncs.com。

  2. 访问权限

    • 如果文件需要公开访问,可以设置 ObjectAcl 为 PublicRead。
    • 如果是私有文件,需要生成带签名的 URL,供临时访问。
  3. 路径规范
    objectName 是文件在 OSS 中的完整路径。例如:folder/file.jpg,可以通过路径管理文件层级。


6. 示例结果

运行测试代码后,上传成功会返回文件的 URL,例如:

java 复制代码
https://your-bucket-name.oss-cn-beijing.aliyuncs.com/uploads/test-image.jpg

如果访问权限设置为 公共读,可以直接访问该 URL 查看文件。


7. 总结

本文介绍了如何使用 Java 将文件上传至阿里云 OSS,包括配置工具类、设置文件权限和生成访问 URL。通过简单的工具类封装,可以轻松实现文件上传功能。

相关推荐
这个昵称不容易6 小时前
SpringBoot 医疗病历交互系统毕设:192 个 Java 文件、256 个接口、22 张表,附真实运行截图
java·springboot·毕设
脚本自动化开发13 小时前
玩影之刃零,两张四千元级显卡怎么挑
后端
Pniubi16 小时前
怎么排查慢SQL,怎么解决?
java·数据库·sql
薛之谦_16 小时前
Java 全栈知识体系:从 IDEA 高效开发到 JVM、并发与 Stream 实战
java·jvm·intellij-idea
用户479492835691517 小时前
从一句话或代码仓到可交互 HTML:开源 Agent 画图技能 Archify v3.2 实测与选型边界
前端·后端·面试
努力的小雨18 小时前
别再复制日志给AI了!我让Codex自己去观测云查报错
后端
afumu20 小时前
Go 写一个只监听 127.0.0.1 的控制服务:鉴权、白名单、危险命令拦截
后端·安全·go
文丑颜不良啊20 小时前
LeetCode2761~2780题目解析
java·leetcode
johnjincaaaa21 小时前
猿人学第 18 题「jsvmp 洞察先机」逆向通关实录
javascript·后端
用户47027840040521 小时前
C语言编译与链接
后端·开源