文章目录该文章会先简单的介绍一下阿里云的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项目集成OSS2.1、新建一个SpringBoot项目，引入阿里云和swagger依赖前提：创建好阿里云账号，开通OSS服务，创建好Bucket，然后需要阿里云的四个属性：地域节点、id、秘钥、项目名称，这些步骤都很简答的，不会的小伙伴可以去百度哦，
2.2、配置application.propertiese文件com.aliyun.oss aliyun-sdk-oss joda-time joda-time io.springfox springfox-swagger2 2.7.0 io.springfox springfox-swagger-ui 2.7.0
#服务端口 server.port=8002 #服务名 spring.application.name=service-oss #环境设置：dev、test、prod spring.profiles.active=dev #阿里云 OSS（配置bucket信息） aliyun.oss.file.endpoint=oss-cn-beijing.aliyuncs.com #地域节点 aliyun.oss.file.keyid=LTAI5tXLU1N3zKh4VWEHzXyz #ID aliyun.oss.file.keysecret=ZgmmX5vSqlMF4HnliXErLxhDQ703HF #秘钥 aliyun.oss.file.bucketname=aly-project-eric #项目名称2.3、编写Java代码
1、创建一个常量工具类：ConstantPropertiesUtil
package com.atguigu.oss.utils;
import org.springframework.beans.factory.InitializingBean;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
@Component
public class ConstantPropertiesUtil implements InitializingBean { //当项目一启动，就会执行该接口的重写方法
@Value("${aliyun.oss.file.endpoint}")
private String endpoint;//地域节点
@Value("${aliyun.oss.file.keyid}")
private String keyId;//id
@Value("${aliyun.oss.file.keysecret}")
private String keySecret;//秘钥
@Value("${aliyun.oss.file.bucketname}")
private String bucketName;//项目名称
public static String END_POINT;
public static String ACCESS_KEY_ID;
public static String ACCESS_KEY_SECRET;
public static String BUCKET_NAME;
@Override
public void afterPropertiesSet() throws Exception {
END_POINT = endpoint;
ACCESS_KEY_ID = keyId;
ACCESS_KEY_SECRET = keySecret;
BUCKET_NAME = bucketName;
}
}
2、创建service层
OssService接口
public interface OssService {
//上传头像到oss
String uploadFileAvatar(MultipartFile file);
}
OssServiceImpl实现类
@Service
public class OssServiceImpl implements OssService {
//上传头像到oss
@Override
public String uploadFileAvatar(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 = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
//获取上传文件输入流
InputStream inputStream = file.getInputStream();
//获取文件名称
String fileName = file.getOriginalFilename();
//1、在文件名称里面添加随机唯一值（因为如果上传文件名称相同的话，后面的问价会将前面的文件给覆盖了）
String uuid = UUID.randomUUID().toString().replaceAll("-","");//因为生成后的值有横岗，我们就把它去除，不替换也可以，也没有错
fileName = uuid + fileName;
//2、把文件安装日期进行分类： 2022/10/11/1.jpg
//获取当前日期
String datePath = new DateTime().toString("yyyy/MM/dd");//在依赖中引入了该工具类
//拼接
fileName = datePath + "/" + fileName;
//调用oss方法实现上传
//参数一：Bucket名称 参数二：上传到oss文件路径和文件名称 比如 /aa/bb/1.jpg 或者直接使用文件名称 参数三：上传文件的流
ossClient.putObject(bucketName,fileName,inputStream);
//关闭OSSClient
ossClient.shutdown();
//把上传之后的文件路径返回
//需要把上传到阿里云路径返回 https://edu-guli-eric.oss-cn-beijing.aliyuncs.com/1.jpg
String url = " https://"+bucketName+"."+endpoint+"/"+fileName;
return url;
} catch (IOException e) {
e.printStackTrace();
return null;
}
}
}
3、创建控制器
@RestController
@RequestMapping("/eduoss/fileoss")
@CrossOrigin //解决跨域
@Api(tags = "阿里云文件管理")
public class OssController {
@Autowired
private OssService ossService;
//上传头像到OSS
@PostMapping
@ApiOperation(value = "上传头像到OSS")
public R uploadOssFile(MultipartFile file){
//获取上传的文件 通过 MultipartFile
String url = ossService.uploadFileAvatar(file);//返回上传图片的路径
return R.ok().message("文件上传成功").data("url",url);
}
}
4、启动SpirngBoot项目，有可能会报这个错
这是因为在配置文件中没有加数据库的配置，而SpringBoot项目会默认扫描数据库配置的
解决方式1：在@SpringBootApplication注解上加上exclude，解除自动加载DataSourceAutoConfiguration
@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
方法2、在application配置文件中加上数据源即可。
# mysql数据库连接 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/eric?serverTimezone=GMT%2B8 spring.datasource.username=root spring.datasource.password=1234563、Swagger中测试文件上传
1、打开swagger网页：http://localhost:8002/swagger-ui.html
2、去到阿里云之前创建的项目查看文件上传是否成功
可以看到文件已经上传成功了，并且该文件也是有路劲的，可以凭借该URL访问和下载了，非常的方便。
PS
如果在操作过程中有不懂的可以在下方留言哦，作者看到会第一时间恢复。
