资讯详情

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的云存储服务、低成本、高可靠的云存储服务.999999999%(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

3、Swagger中测试文件上传

1、打开swagger网页:http://localhost:8002/swagger-ui.html 选择文件上传 2、去到阿里云查看文件上传是否成功 可以看到文件已经上传成功了,并且该文件也是有路劲的,可以凭借该URL访问和下载了,非常的方便。


PS

如果在操作过程中有不懂的可以在下方留言哦,作者看到会第一时间恢复。

关于阿里云视频点播可以看这篇文章哦:SpringBoot集成阿里云视频点播服务

标签: 荧光法溶解氧传感器oos6137zkh矩形电连接器

锐单商城拥有海量元器件数据手册IC替代型号,打造 电子元器件IC百科大全!

锐单商城 - 一站式电子元器件采购平台