SpringBoot - 阿里云OSS对象存储简介及简单上传

最新推荐文章于 2025-02-21 10:54:26 发布
原创 最新推荐文章于 2025-02-21 10:54:26 发布 · 2.7k 阅读 · 12 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
标签
#OSS #上传文件
本文介绍了如何使用SpringBoot集成阿里云OSS对象存储服务，包括申请OSS、创建Bucket、配置AccessKey权限。通过SpringBoot实现文件上传、删除等操作，并提供了相关配置代码示例。此外，还提到了基于SMM的初步实践。

OSS是一种分布式文件存储的一个不错选择，对象存储服务（Object Storage Service，OSS）是一种海量、安全、低成本、高可靠的云存储服务，适合存放任意类型的文件。

申请阿里OSS，创建Bucket

oss是收费的，每个bucket是一个存储空间，可以根据不同的项目创建不同的Bucket。

这个AccessKey账号，需要添加如下几个权限

一、入门示例 - 基于SpringBoot

官方文档：OSS - Java SDK官网文档地址

1、引入pom依赖

<!-- 阿里云OSS -->
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.8.0</version>
</dependency>

2、配置文件 - application.properties

# EndPoint
aliyun.oss.file.endpoint=xxxx
# KeyId
aliyun.oss.file.keyid=xxxx
# KeySecret
aliyun.oss.file.keysecret=xxxx
# bucketName
aliyun.oss.file.bucketname=xxxx
# 访问图片的固定前缀
aliyun.oss.file.httpsprefix=xxxx
# 最大上传单个文件大小：默认1M
spring.servlet.multipart.max-file-size=1024MB
# 最大置总上传的数据大小 ：默认10M
spring.servlet.multipart.max-request-size=1024MB

endPoint在哪找？如图：

httpsprefix访问前缀是什么？

比如：
https://jiuyue.oss-cn-chengdu.aliyuncs.com
jiuyue就是bucketName
后面那个就是endpoint

3、创建一个工具类 - 主要用于读取配置文件里的bucketName和固定前缀

@Component
public class OssConstant implements InitializingBean {
    /** 从配置文件中读取bucketName */
    @Value("${aliyun.oss.file.bucketname}")
    private String bucketName;
    /** 从配置文件中读取存储文件的地址前缀 */
    @Value("${aliyun.oss.file.httpsprefix}")
    private String ossHttpsPrefix;

    public static String BUCKET_NAME;
    public static String OSS_HTTPS_PREFIX;

    @Override
    public void afterPropertiesSet() throws Exception {
        BUCKET_NAME = bucketName;
        OSS_HTTPS_PREFIX = ossHttpsPrefix;
    }

}

4、创建一个配置类，主要是配置OSSClient，方便注入

@Configuration
public class OssConfig {
    /** 从配置文件中读取endPoint */
    @Value("${aliyun.oss.file.endpoint}")
    private String ossEndpoint;
    /** 从配置文件中读取KeyId */
    @Value("${aliyun.oss.file.keyid}")
    private String keyId;
    /** 从配置文件中读取KeySecret */
    @Value("${aliyun.oss.file.keysecret}")
    private String keySecret;

    @Bean
    public OSSClient ossClient(){
        return (OSSClient) new OSSClientBuilder().build(ossEndpoint, keyId, keySecret);
    }
}

5、创建一个Controller - 主要功能是上传、删除/批量删除图片、查询图片是否存在

更多api请见官方文档：OSS - Java SDK 官方文档

@RestController
@RequestMapping("/oss")
public class OssController {
    @Autowired
    private OSSClient ossClient;

    /**
     * 上传图片到OSS
     * @param file 图片文件
     * @return 图片访问地址
     */
    @PostMapping("/upload")
    public String ossUpload(MultipartFile file){
        // 获取原始文件名(我一般都是用UUID生成新的文件名)
        String fileName = file.getOriginalFilename();
        // 文件夹名(可以用模块名)
        String folder = "liuchengyin";
        // 文件夹名(根据日期来存储)
        String format = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
        // 文件名 - 使用UUID生成
        String fileNameUUID = UUID.randomUUID().toString().replaceAll("-", "");
        if (fileName != null){
            // 获取原始文件名的后缀，如.jpg .png
            fileNameUUID = folder+ "/" + format + "/" + fileNameUUID + fileName.substring(fileName.lastIndexOf("."));
        } else {
            // 一般来说这种情况是不存在的
            fileNameUUID = folder+ "/" + format + "/" + fileNameUUID + ".jpg";
        }
        try {
            ossClient.putObject(OssConstant.BUCKET_NAME, fileNameUUID, file.getInputStream());
        } catch (IOException e) {
            e.printStackTrace();
        }
        // 返回文件访问地址 - 这里可以封装一个对象，返回访问地址和文件名(也就是fileNameUUID)
        // 这个文件名(fileNameUUID)可以用于查询是否存在、删除等操作
        return OssConstant.OSS_HTTPS_PREFIX + "/" + fileNameUUID;
    }

    /**
     * 删除OSS里的文件/文件夹(文件夹内不能有文件)
     * @param fileName 文件名 - 完整文件名包括文件夹名，如：liuchengyin/2021-03-23/f624048f7ca8466881f825365e3308d4.jpg
     * @return
     */
    @PostMapping("/delete")
    public String ossDelete(String fileName){
        ossClient.deleteObject(OssConstant.BUCKET_NAME, fileName);
        return "删除成功！";
    }

    /**
     * 批量删除OSS里的文件
     * @param fileNames 文件名集合 - 完整文件名包括文件夹名，如：liuchengyin/2021-03-23/f624048f7ca8466881f825365e3308d4.jpg
     * @return
     */
    @PostMapping("/deleteBatch")
    public List<String> ossDeleteBatch(@RequestBody List<String> fileNames){
        DeleteObjectsResult deleteObjectsResult = ossClient.deleteObjects(new DeleteObjectsRequest(OssConstant.BUCKET_NAME).withKeys(fileNames));
        // 返回的就是删除成功的图片名集合(图片不存在，也会返回)
        return deleteObjectsResult.getDeletedObjects();
    }

    /**
     * 查询OSS里的文件是否存在
     * @param fileName 文件名 - 完整文件名包括文件夹名，如：liuchengyin/2021-03-23/f624048f7ca8466881f825365e3308d4.jpg
     * @return 是否存在:true or false
     */
    @GetMapping("/exist")
    public Boolean isExist(String fileName) {
        return ossClient.doesObjectExist(OssConstant.BUCKET_NAME, fileName);
    }
}

使用postman测试上传文件的方式：

Github地址：SpringBoot - OSS对象存储Demo

Gitee地址：SpringBoot - OSS对象存储Demo

 

二、入门示例 - 基于SMM

这是刚学SSM没多久时写的文章，相当于上面那个不是太完整(懒得删)。

1、引入pom依赖

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

2、代码测试

public class FileUpload {
	// 上传文件流的方式 - 常用
    public static void main(String[] args) throws FileNotFoundException {
        // Endpoint以成都为例，其它Region请按实际情况填写。
        String endpoint = "http://oss-cn-chengdu.aliyuncs.com";
        // 云账号AccessKey有所有API访问权限，建议遵循阿里云安全最佳实践，创建并使用RAM子账号进行API访问或日常运维
        String accessKeyId = "Xxxxxx";
        String accessKeySecret = "Aaaaaaaa";
        // 创建OSSClient实例
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
        // 上传文件流 - 文件地址
        InputStream inputStream = new FileInputStream("f:\\成果.jpg");
        // 存储BucketName、上传到OSS的文件名
        ossClient.putObject("liuchengyin", "狗哥.jpg", inputStream);
        // 关闭OSSClient
        ossClient.shutdown();
    }
}

 

 

使用Spring管理OSSClient

1、在Spring配置文件中添加如下

<!--阿里云OSS  -->
<bean id="ossClient" class="com.aliyun.oss.OSSClient">
	<!-- Endpoint以成都为例，其它Region请按实际情况填写 -->
	<constructor-arg index="0" value="oss-cn-chengdu.aliyuncs.com"></constructor-arg>
	<!-- AccessKeyID -->
	<constructor-arg index="1" value="AccessKeyID"></constructor-arg>
	<!-- AccessKeySecret -->
	<constructor-arg index="2" value="AccessKeySecret"></constructor-arg>
</bean>

2、上传后端代码示例

@Controller
public class uploadController{
	// 注入OSSClient
	@Autowired
	private OSSClient ossClient;

	/**
	 * 上传图片
	 * @param file 文件
	 * @param folder 文件所在文件夹名
	 */
	@PostMapping("/upload")
	public String ossUpload(@RequestParam("file") MultipartFile file,String folder){
		// BucketName
		String bucketName = "liuchengyin";
		// 获取原始的文件名
		String fileName = file.getOriginalFilename();
		// 使用UUID来处理文件名随机
		fileName = folder + "/" + UUID.randomUUID() + file.getOriginalFilename();
	
		try{
			ossClient.putObject(bucketName,fileName,file.getInputStream());
		}.cathc(Exception e){
			e.printStackTrace();
		}
		// 返回图片地址
		return "https://" + bucketName + ".oss-cn-chengdu.aliyuncs.com/" + fileName;
	}
}

springboot 整合阿里云oss
congge_study的博客
04-22 1万+
springboot 整合阿里云oss
10分钟学会阿里OSS对象存储
千锋教育
08-10 3199
阿里云对象存储OSS，简单地说就是我们花钱在阿里购买一块存储空间，然后我们就可以将图片、音频、视频等各种文件资源存储在对象存储OSS服务器上。进入阿里云官网后，首先就是注册和登录，我们可以使用自己的支付宝账号登录，可以在阿里云手机客户端扫码登录，或者用账号密码登录，总之阿里云提供了多种登录形式。其实实现文件存储的技术有很多，如果我们在网上搜索一下，你会发现实现的技术简直是五花八门，比如有一种技术叫FastDFS就可以实现文件存储，但该方案需要自己搭建服务器，非常的麻烦。当然，首先我们得购买OSS服务！
OSS对象资源管理
fly的博客
09-15 1222
OSS 是“Object Storage Service”的缩写，中文常称为“对象存储服务”。OSS 是一种互联网云存储服务，主要用于海量数据的存储与管理。相较于，OSS更灵活，不用将文件存储于本地磁盘或服务器中，并且可以实现文件共享，它通过简单的RESTful接口提供高可用、高可靠、安全、低成本的数据存储能力，支持多种数据的存储需求，如图片、视频、音频文件以及各类文档等，在当今市场上应用广泛。
如何获取 OSS AccessKeyId、AccessKeySecret
热门推荐
星海IT学习之路
03-02 3万+
开通阿里云oss：https://www.aliyun.com 1、点击概览 — AccessKey oss控制台官网链接：https://oss.console.aliyun.com/overview 2、出现下图，选择开始使用子用户Access Key 3、填写用户名，并点击确定 4、这时会给你的手机发送验证码确认是否是本人操作，填写验证码后，用户创建成功 5、创建完毕后，会出现下面的页面，我们可以看到创建的accessKeyId、AccessKeySecret 博主提示：这一步建议复制下这
什么是OSS对象存储？
A_captain_608的博客
11-02 1万+
OSS对象存储，基本概念、使用特性与优缺点介绍
后端之路——阿里云OSS云存储
m0_73991249的博客
07-04 1万+
全名叫“阿里云对象存储OSS”，就是云存储，前端发文件到服务器，服务器不用再存到本地磁盘，可以直接传给“阿里云OSS”，存在网上。
spring boot上传阿里云对象存储OSS快速上手（一、控制台简介）
一起码代码
11-18 6490
简介： 1.阿里云对象存储OSS其实就是一个文件存储的服务 2.在我们的开发过程中会遇到类似于头像上传这样需要上传图片的需求，我们需要自己搭建自己的存储图片的服务器，编写相关的实现代码，而阿里云oss可以帮助我们节省开发时间，快速实现这个功能。 3.对于开发者来说也有必要掌握这一项技能 虽然OSS是收费的，但是我们用来个人开发学习几乎就是免费的，可能一分钱都不用花。 阿里云地址： https://www.aliyun.com/ 首先使用支付宝账号登录阿里云，为了能够正常使用oss不出问题，先进行充
Web项目实战 | 购物系统v2.0 | 开发记录（十）SpringBoot整合阿里云OSS对象存储服务 | Web将上传的商品图片保存到阿里云，同时将地址保存到数据库
希望每天都能进步一点点
02-22 1002
SpringBoot整合OSS对象存储服务的简要记录，在web项目里实现将图片上传到远程服务器，同时在将远程的图片地址存储到数据库，这使得远程图片能够直接加载在页面，相比直接保存到本地服务器上来说，大大节省了网络带宽的消耗，同时提升的网站的访问速度，降低了服务器的负荷。
阿里云-对象存储OSS
码赛客1024的博客
10-27 5028
本文保姆级的讲解了使用阿里云OSS对象存储服务。
OSS简单介绍
迷雾总会解
01-10 8793
阿里云对象存储OSS（Object Storage Service）是一款海量、安全、低成本、高可靠的云存储服务，可提供99.9999999999%（12个9）的数据持久性，99.995%的数据可用性。多种存储类型供选择，全面优化存储成本。
阿里云OSS
路遥知马力，日久见人心
02-06 6962
本篇博客对阿里云OSS的基本概念和使用进行总结，旨在快速上手该云存储产品，更为详细的内容可以参考官方文档，日后再进行补充
阿里云OSS（对象存储）
Mr_FunnyNiu的博客
06-18 3954
​ 阿里云对象存储服务（Object Storage Service，简称OSS）为您提供基于网络的数据存取服务。使用OSS，您可以通过网络随时存储和调用包括文本、图片、音频和视频等在内的各种非结构化数据文件。阿里云OSS将数据文件以对象（object）的形式上传到存储空间（bucket）中。创建一个或者多个存储空间，向每个存储空间中添加一个或多个文件。通过获取已上传文件的地址进行文件的分享和下载。通过修改存储空间或文件的属性或元信息来设置相应的访问权限。
oss存储使用
weixin_43018183的博客
12-13 3615
阿里云提供了5种使用oss存储的方式，包括控制台、命令行、图形化管理工具ossbrowser、SDK、REST API；这里仅对在下常用的命令行、javasdk进行一些说明，其他的不一一详细说明，感兴趣的可以去官网看相关文档和指导视频。
云存储 （OSS、CPFS 和 NAS）
HaoHao_010的博客
11-19 4408
OSS适合海量数据存储、静态文件存储以及大数据分析。它是云存储中的标准解决方案，广泛应用于备份、归档和非结构化数据存储。CPFS是高性能计算和大数据分析的理想选择，尤其适用于对吞吐量和低延迟有高要求的应用，如科学计算和机器学习。NAS更适合本地或局域网内的文件共享、文档存储及多用户协作，是企业和家庭用户集中管理文件的常见选择。选择合适的存储方案时，企业和个人应根据实际需求，结合数据类型、访问模式、性能要求以及预算等因素，做出最优决策。
OSS详解
故里的博客
05-24 5682
OSS详解
OSS（对象存储服务）
最新发布
HBryce24的博客
02-21 3949
OSS通过扁平化结构、分布式冗余和RESTful API，实现了海量非结构化数据的高效管理，成为现代云计算中不可或缺的存储解决方案。其设计权衡了扩展性、成本与一致性，适用于Web规模的应用场景。OSS（Object Storage Service）是一种基于对象的存储架构，适用于存储图片、视频、日志、备份文件等非结构化数据。与传统存储方式（如块存储、文件存储）不同，OSS以。是一种用于存储和管理非结构化数据的云存储服务，其核心设计面向海量数据的高扩展性、高可靠性和低成本存储。
OSS对象存储
Ravenich的博客
04-17 3457
OSS对象存储
阿里云 OSS介绍
weixin_64051447的博客
06-21 5565
比如网站的 图片、视频等文件就可以存放在 OSS 中（海量数据，自己维护起来麻烦，交给其他人去维护），每次从 OSS 中获取即可。OSS 具有与平台无关的 RESTful API 接口，可以在任意应用、任意时间、任意地点 存储与访问 任何类型的数据。简单地理解：OSS 基于网络提供数据存储服务，通过网络可以随时存储、获取 文本、图片、音频、视频等 非结构化数据。对象是 OSS 存储的基本单位，由元信息（Object Meta）、数据（Data）、文件名（key）组成。存储类型分为：标准、低频访问、归档。
【阿里云OSS】对象存储，保姆级教学
lklalmq的博客
11-23 6743
JavaEE项目中需要对图片视频等静态资源进行上传下载，这里用到阿里云对象存储服务（Object Storage Service，简称OSS），OSS可以通过网络随时存取包括但不限于文本、图片、音视频等各种非结构化数据文件，还有Excel表，CSV、数据库表等结构化数据文件。将文件以对象的形式上传到存储空间（bucket）中。
阿里云 OSS
xiaowei20091124的专栏
08-31 8533
比如网站的 图片、视频等文件就可以存放在 OSS 中（海量数据，自己维护起来麻烦，交给其他人去维护），每次从 OSS 中获取即可。OSS 具有与平台无关的 RESTful API 接口，可以在任意应用、任意时间、任意地点 存储与访问 任何类型的数据。简单地理解：OSS 基于网络提供数据存储服务，通过网络可以随时存储、获取 文本、图片、音频、视频等 非结构化数据。对象是 OSS 存储的基本单位，由元信息（Object Meta）、数据（Data）、文件名（key）组成。存储类型分为：标准、低频访问、归档。..
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值