SpringBoot集成阿里云存储OSS服务

该文章简单的介绍一下阿里云的OSS存储，然后演示如何在SpringBoot项目中集成OSS，每一步操作都记录好了文章目录前言一、pandas是什么？总结前言提示：这里可以添加本文要记录的大概内容：例如：随着人工智能的不断发展，机器学习这门技术也越来越重要，很多人都开启了学习机器学习，本文就介绍了机器学习的基础内容。提示：以下是本篇文章正文内容，下面案例可供参考一、pandas是什么？示例：pand

Eric-x

7233人浏览 · 2022-04-30 15:35:56

Eric-x · 2022-04-30 15:35:56 发布

前言

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

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

官方介绍：阿里云对象存储OSS（Object Storage Service）是一款海量、安全、低成本、高可靠的云存储服务，提供99.9999999999%(12个9)的数据持久性，99.995%的数据可用性。多种存储类型供选择，全面优化存储成本。

简单来说OSS就是一个在线的存储空间，类似阿里云盘之类的。

2、SpringBoot项目集成OSS

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

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

<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文件

#服务端口
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=LTAI5tXLU13zKh4VHzXyz	#ID
aliyun.oss.file.keysecret=ZgmX5vSqlMF4H5nliXErLxhDQ703HF #秘钥
aliyun.oss.file.bucketname=aly-item-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;

/**
 * 获取阿里云信息的工具类
 *      该类的执行流程：
 *          类加载后，先加载四个变量，再分别赋值
 *          接着执行重写的方法
 *
 * @author Eric
 * @create 2022-04-24 23:30
 */
@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接口

/**
 * @author Eric
 * @create 2022-04-24 23:39
 */
public interface OssService {
    //上传头像到oss
    String uploadFileAvatar(MultipartFile file);
}

OssServiceImpl实现类


/**
 * @author Eric
 * @create 2022-04-24 23:40
 */
@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、创建控制器

/**
 * @author Eric
 * @create 2022-04-24 23:51
 */
 @Api(tags = "阿里云文件管理")
@RestController
@RequestMapping("/eduoss/fileoss")
@CrossOrigin    //解决跨域
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=123456