SpringBoot集成阿里云存储OSS效劳

前言

该文章会先简单的介绍一下阿里云的OSS存储，然后演示如何在SpringBoot项目中集成OSS，每一步都有记录，保证初学者也能看懂。

文章目录

前言1、阿里云存储OSS是什么？2、SpringBoot项目集成OSS

2.1、新建一个SpringBoot项目，引入阿里云和swagger依赖2.2、配置application.propertiese文件2.3、编写Java代码

3、Swagger中测试文件上传PS

1、阿里云存储OSS是什么？

官方介绍：阿里云对象存储OSS（Object Storage Service）是一款海量、安全、低本钱、高可靠的云存储效劳，提供99.9999999999%(12个9)的数据耐久性，99.995%的数据可用性。多种存储类型供选择，全面优化存储本钱。
简单来说OSS就是一个在线的存储空间，类似阿里云盘之类的。

2、SpringBoot项目集成OSS

前提：创建好阿里云账号，开通OSS效劳，创建好Bucket，然后需要阿里云的四个属性：地域节点、id、秘钥、项目名称，这些步骤都很简单的，不会的小伙伴可以去百度哦，

2.1、新建一个SpringBoot项目，引入阿里云和swagger依赖

1. <dependencies><!-- 阿里云oss依赖 --><dependency><groupId>com.aliyun.oss</groupId><artifactId>aliyun-sdk-oss</artifactId></dependency><!-- 日期工具栏依赖 --><dependency><groupId>joda-time</groupId><artifactId>joda-time</artifactId></dependency></dependencies><!--swagger--><dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger2</artifactId><version>2.7.0</version></dependency><!--swagger ui--><dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger-ui</artifactId><version>2.7.0</version></dependency>

复制代码

2.2、配置application.propertiese文件

1. #效劳端口
2. server.port=8002#效劳名
3. spring.application.name=service-oss
5. #环境设置：dev、test、prod
6. spring.profiles.active=dev
8. #阿里云 OSS（配置bucket信息）
9. aliyun.oss.file.endpoint=oss-cn-beijing.aliyuncs.com #地域节点
10. aliyun.oss.file.keyid=LTAI5tXLU13zKh4VHzXyz        #ID
11. aliyun.oss.file.keysecret=ZgmX5vSqlMF4H5nliXErLxhDQ703HF #秘钥
12. aliyun.oss.file.bucketname=aly-item-eric #项目名称

复制代码

2.3、编写Java代码

1、创建一个常量工具类：ConstantPropertiesUtil

1. packagecom.atguigu.oss.utils;importorg.springframework.beans.factory.InitializingBean;importorg.springframework.beans.factory.annotation.Value;importorg.springframework.stereotype.Component;/**
2. * 获取阿里云信息的工具类
3. *      该类的执行流程：
4. *          类加载后，先加载四个变量，再分别赋值
5. *          接着执行重写的方法
6. *
7. * @author Eric
8. * @create 2022-04-24 23:30
9. */@ComponentpublicclassConstantPropertiesUtilimplementsInitializingBean{//当项目一启动，就会执行该接口的重写方法@Value("${aliyun.oss.file.endpoint}")privateString endpoint;//地域节点@Value("${aliyun.oss.file.keyid}")privateString keyId;//id@Value("${aliyun.oss.file.keysecret}")privateString keySecret;//秘钥@Value("${aliyun.oss.file.bucketname}")privateString bucketName;//项目名称publicstaticString END_POINT;publicstaticString ACCESS_KEY_ID;publicstaticString ACCESS_KEY_SECRET;publicstaticString BUCKET_NAME;@OverridepublicvoidafterPropertiesSet()throwsException{
10.         END_POINT = endpoint;
11.         ACCESS_KEY_ID = keyId;
12.         ACCESS_KEY_SECRET = keySecret;
13.         BUCKET_NAME = bucketName;}}

复制代码

2、创建service层
OssService接口

1. /**
2. * @author Eric
3. * @create 2022-04-24 23:39
4. */publicinterfaceOssService{//上传头像到ossStringuploadFileAvatar(MultipartFile file);}

复制代码

OssServiceImpl实现类

1. /**
2. * @author Eric
3. * @create 2022-04-24 23:40
4. */@ServicepublicclassOssServiceImplimplementsOssService{//上传头像到oss@OverridepublicStringuploadFileAvatar(MultipartFile file){//工具类获取值：分别是：地域节点、id、秘钥、项目名称String endpoint =ConstantPropertiesUtil.END_POINT;String accessKeyId =ConstantPropertiesUtil.ACCESS_KEY_ID;String accessKeySecret =ConstantPropertiesUtil.ACCESS_KEY_SECRET;String bucketName =ConstantPropertiesUtil.BUCKET_NAME;try{// 创建OSS实例。OSS ossClient =newOSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);//获取上传文件输入流InputStream inputStream = file.getInputStream();//获取文件名称String fileName = file.getOriginalFilename();//1、在文件名称里面添加随机唯一值（因为假设上传文件名称相同的话，后面的问价会将前面的文件给覆盖了）String uuid = UUID.randomUUID().toString().replaceAll("-","");//因为生成后的值有横岗，我们就把它去除，不交换也可以，也没有错
5.             fileName = uuid + fileName;//2、把文件装置日期停止分类： 2022/10/11/1.jpg//获取当前日期String datePath =newDateTime().toString("yyyy/MM/dd");//在依赖中引入了该工具类//拼接
6.             fileName = datePath +"/"+ fileName;//调用oss方法实现上传//参数一：Bucket名称  参数二：上传到oss文件途径和文件名称  比如 /aa/bb/1.jpg 或者直接使用文件名称  参数三：上传文件的流
7.             ossClient.putObject(bucketName,fileName,inputStream);//关闭OSSClient
8.             ossClient.shutdown();//把上传之后的文件途径返回//需要把上传到阿里云途径返回    https://edu-guli-eric.oss-cn-beijing.aliyuncs.com/1.jpgString url =" https://"+bucketName+"."+endpoint+"/"+fileName;return url;}catch(IOException e){
9.             e.printStackTrace();returnnull;}}}

复制代码

3、创建控制器

1. /**
2. * @author Eric
3. * @create 2022-04-24 23:51
4. */@Api(tags ="阿里云文件管理")@RestController@RequestMapping("/eduoss/fileoss")@CrossOrigin//处置跨域publicclassOssController{@AutowiredprivateOssService ossService;//上传头像到OSS@PostMapping@ApiOperation(value ="上传头像到OSS")publicRuploadOssFile(MultipartFile file){//获取上传的文件  通过 MultipartFileString url = ossService.uploadFileAvatar(file);//返回上传图片的途径returnR.ok().message("文件上传胜利").data("url",url);}}

复制代码

4、启动SpirngBoot项目，有可能会报这个错

这是因为在配置文件中没有加数据库的配置，而SpringBoot项目会默认扫描数据库配置的
处置方式1：在@SpringBootApplication注解上加上exclude，解除自动加载DataSourceAutoConfiguration

1. @SpringBootApplication(exclude =DataSourceAutoConfiguration.class)

复制代码

方法2、在application配置文件中加上数据源即可。

1. # mysql数据库连接
2. spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
3. spring.datasource.url=jdbc:mysql://localhost:3306/eric?serverTimezone=GMT%2B8
4. spring.datasource.username=root
5. spring.datasource.password=123456

复制代码

3、Swagger中测试文件上传

1、翻开swagger网页：http://localhost:8002/swagger-ui.html 选择文件上传

2、去到阿里云查看文件上传是否胜利

可以看到文件已经上传胜利了，并且该文件也是有路劲的，可以凭仗该URL访问和下载了，非常的方便。

PS

假设在操作过程中有不懂的可以在下方留言哦，作者看到会第一时间恢复。
扩展：
SpringBoot集成 腾讯云云点播效劳 /视频上传：https://blog.csdn.net/weixin_47316183/article/details/127739422?spm=1001.2014.3001.5502
SpringBoot集成 腾讯云存储COS 效劳：https://blog.csdn.net/weixin_47316183/article/details/127739385?spm=1001.2014.3001.5502
SpringBoot集成 阿里云视频播效劳 /视频上传：https://blog.csdn.net/weixin_47316183/article/details/124768041
SpringBoot集成 阿里云存储OSS 效劳：https://blog.csdn.net/weixin_47316183/article/details/124512424