十三.SpringCloudAlibaba极简入门-集成阿里云OSS对象存储

本文涉及的产品
对象存储 OSS,20GB 3个月
对象存储 OSS,恶意文件检测 1000次 1年
对象存储 OSS,内容安全 1000次 1年
简介: 因为在搞项目,需要对接一下OSS,所以一时兴起就做一下整理,本文章讲述的是如何使用阿里云的对象存储作为文件服务器,您需要登录阿里云,注册一个账号。

前言

因为在搞项目,需要对接一下OSS,所以一时兴起就做一下整理,本文章讲述的是如何使用阿里云的对象存储作为文件服务器,您需要登录阿里云,注册一个账号。

1.注册登录阿里云

省略...

2.开通OSS对象存储

点击对象存储oss,前往开通
在这里插入图片描述
点击立即开通
在这里插入图片描述
登录阿里云账号,没有账号自行注册
在这里插入图片描述
同意之后立即开通
在这里插入图片描述
然后进入开通成功页
在这里插入图片描述
注意,没做实名认证的就根据提示做一下实名认证之后再申请开通。

3.创建Bucket

bucket的意思是桶,相当于是一个存储空间,我们创建一个Bucket
在这里插入图片描述
填写相关配置
在这里插入图片描述
填写名称之后,存储类型如果做学习用或访问频率不高就选择“低频访问存储”,读写权限采用公共读,这样任何网络都可以去读取文件内容,然后点击确定
在这里插入图片描述
Endpoint(地域节点)是根据不同地区生成的节点,我们在代码中上传的时候会用到,Bucket 域名 就是该存储空间的访问域名了,用来访问文件的

4.文件管理

在文件管理菜单中可以直接上传以及删除文件
在这里插入图片描述
选择上传的文件
在这里插入图片描述
上传成功之后,点击“详情”按钮就可以看到上传的图片效果了,也可以直接下载
在这里插入图片描述

5.AccessKey子账户创建

我们需要去生成AccessKey,我们可以认为这个是在代码中上传文件所需要的账号信息
在这里插入图片描述
推荐使用子用户AccessKey,因为AccessKey的权限比较高
在这里插入图片描述
点击“创建账户” , 填写名称,勾选使用方式“编程访问”
在这里插入图片描述
到这,子账户就创建成功了,请妥善保管AcessKey和Secret
在这里插入图片描述
接下来我们需要给子账户添加权限,点击左边用户菜单,找到刚才创建的账户,添加权限
在这里插入图片描述
比如我这里给了一个OSS的管理权限,可以满足文件的读写了
在这里插入图片描述
好了,到这里我们的OSS配置就告一段落接下来是Java对象OSS上传文件

最后需要注意,你要做文件上传需要准备好这三个东西:

  • Endpoint(地域节点):oss-cn-beijing.aliyuncs.com ,创建存储空间Bucket时选择不同的地区生成的区域节点

  • 存储空间:temp-bucket-cg , 存储空间的名字

  • AccessKey :创建的文件上传子账户的key
  • Secrect : 创建子账户对应的秘钥

6.Java接入OSS

引入SDK,阿里云提供了OSS的SDK的jar,我们导入都项目中

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

然后根据文档编写代码实现文件的简单上传

public class AliyunOSSTest {
   
   

    public static void main(String[] args) {
   
   
        // Endpoint 地域端点
        String endpoint = "http://oss-cn-chengdu.aliyuncs.com";

        // 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录 https://ram.console.aliyun.com 创建RAM账号。
        String accessKeyId = "你的accessKey";
        String accessKeySecret = "你的秘钥";

        // 创建OSSClient实例。
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

        // 创建PutObjectRequest对象。 ,
        PutObjectRequest putObjectRequest = new PutObjectRequest("存储空间", "a.png",
                new File("C:\\Users\\whale\\Desktop\\搜狗截图20200928203405.png"));

        // 上传文件。
        ossClient.putObject(putObjectRequest);

        // 关闭OSSClient。
        ossClient.shutdown();
    }
}

编写简单测试代码,演示的是本地文件上传,需要填上区域端点,accessKey,serect秘钥,存储空间等,上传成功,观察服务器的文件管理

在这里插入图片描述
在文件管理菜单中可以看到上传的文件

7.Spring Cloud Alibaba OSS对象存储

Spring Cloud Alibaba 对OSS做了封装,用起来更简单,根据官网文档走,导依赖

        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alicloud-oss</artifactId>
        </dependency>

注意:导入了aliyun-oss-spring-boot-starter就不要再去导aliyun-sdk-oss了

然后需要在配置文件中配置如下内容

spring:
  cloud:
    alicloud:
      access-key: LTAI4GBU4kV67teSKSzkKpxN
      secret-key: 0f9Djm2Ypds2mMBOma7iuInLqlbJL9
      oss:
        endpoint: http://oss-cn-chengdu.aliyuncs.com

分别是accessKey,秘钥,地域端点,然后编写代码实现文件上传

@SpringBootTest(classes = AdminApplication10200.class)
@RunWith(SpringRunner.class)
public class AliyunOSSTest {
   
   

    @Autowired
    private OSSClient ossClient;

    @Test
    public void uploadTest() throws Throwable {
   
   
        // 创建PutObjectRequest对象:参数 bucket 和 文件名
        PutObjectRequest putObjectRequest = new PutObjectRequest("itsource-hrm", "b.png",
                new File("C:\\Users\\whale\\Desktop\\搜狗截图20200928203405.png"));

        // 上传文件。
        ossClient.putObject(putObjectRequest);

        // 关闭OSSClient。
        ossClient.shutdown();
    }
}

观察云服务器文件管理列表能看到上传的图片,到此文件结束

8.最佳实践-服务签名后浏览器直传

文件上传方案

通常情况下把文件上传到OSS有三种方案

  • 通过web前端直接上传到OSS服务器,这种方式意味着需要把OSS配置参数写死在JS中,有安全隐患
  • 通过web前端把文件上传到后端服务器,后端服务器再把文件上传到OSS,这种方式虽然没有了暴露OSS配置参数的安全隐患,但是文件通过后端中转了一次在上传,性能不高,而且增加了服务的压力
  • OSS最佳实践:后端服务签名后前端直传,即:依然是web前端直接把文件上传到OSS服务器,只是在上传文件之前先请求后端获取OSS配置签名信息,web前端拿到签名信息后和文件一起上传到OSS服务器,这样一来,文件上传既不需要通过后台服务器中转一次,也不会有暴露OSS配置参数的风险。流程如下:
    在这里插入图片描述

    后端服务器签名

    依然需要导入 spring-cloud-starter-alicloud-oss 依赖,然后在yml中配置OSS

    spring:
    cloud:
      alicloud:
        bucket-name: itsource-hrm #上传空间bucket
        access-key: LTAI4GBU4kV..... #你的key
        secret-key: 0f9Djm2Ypds..... #你的秘钥
        oss:
          endpoint: oss-cn-chengdu.aliyuncs.com  #上传端点
    

    请根据你自己的账号进行配置 , 然后编写controller,对OSS做签名

    //OSS文件上传
    @RestController
    public class OSSUploadController {
         
         
      //读取配置
      @Value("${spring.cloud.alicloud.access-key}")
      private String accessId;
      @Value("${spring.cloud.alicloud.secret-key}")
      private String accessKey;
      @Value("${spring.cloud.alicloud.oss.endpoint}")
      private String endpoint;
      @Value("${spring.cloud.alicloud.bucket-name}")
      private String bucket;
    
      @Autowired
      private OSS ossClient;
    
      //服务返回oss签名 ,web拿到签名后,上传文件到OSS
      @GetMapping("/ossSign")
      public JSONResult  ossSign(){
         
         
          // host的格式为 bucketname.endpoint
          String host = "https://" + bucket + "." + endpoint;
    
          // callbackUrl为 上传回调服务器的URL,请将下面的IP和Port配置为您自己的真实信息。
          String callbackUrl = "http://localhost:1040/callback";
    
          // 用户上传文件时指定的前缀。
          String dir = "itsource";
    
          try {
         
         
              long expireTime = 30;
              long expireEndTime = System.currentTimeMillis() + expireTime * 1000;
              Date expiration = new Date(expireEndTime);
    
              // PostObject请求最大可支持的文件大小为5 GB,即CONTENT_LENGTH_RANGE为5*1024*1024*1024。
              PolicyConditions policyConds = new PolicyConditions();
              policyConds.addConditionItem(PolicyConditions.COND_CONTENT_LENGTH_RANGE, 0, 1048576000);
              policyConds.addConditionItem(MatchMode.StartWith, PolicyConditions.COND_KEY, dir);
    
              String postPolicy = ossClient.generatePostPolicy(expiration, policyConds);
              byte[] binaryData = postPolicy.getBytes("utf-8");
              String encodedPolicy = BinaryUtil.toBase64String(binaryData);
              String postSignature = ossClient.calculatePostSignature(postPolicy);
    
              Map<String, String> respMap = new LinkedHashMap<String, String>();
              respMap.put("accessid", accessId);
              respMap.put("policy", encodedPolicy);
              respMap.put("signature", postSignature);
              respMap.put("dir", dir);
              respMap.put("host", host);
              respMap.put("expire", String.valueOf(expireEndTime / 1000));
    
              return JSONResult.ok().put("data",respMap);
          } catch (Exception e) {
         
         
              e.printStackTrace();
              System.out.println(e.getMessage());
          } finally {
         
         
              ossClient.shutdown();
          }
          return null;
      }
    }
    

    以上代码来源于官方案例,使用浏览器访问该controller返回
    在这里插入图片描述

WEB前端上传文件

前端的上传文件之间需要先访问后端服务获取签名,然后把签名作为参数和文件一起提交到OSS,我这里使用的是ElementUI的Upload组件做例:

  • 上传组件
    <el-upload
      class="upload-demo"
      action="http://itsource-hrm.oss-cn-chengdu.aliyuncs.com"
      :data="dataObj"
      :before-upload="beforeUpload"
      :on-success="handleUploadSuccess"
      :on-preview="handlePreview"
      :on-remove="handleRemove"
      :file-list="fileList"
      list-type="picture">
      <el-button size="small" type="primary">点击上传</el-button>
      <div slot="tip" class="el-upload__tip">只能上传jpg/png文件,且不超过500kb</div>
    </el-upload>
    
    解释一下:
  1. action是上传到OSS的端点
  2. :data="dataObj"是需要提交的数据,即:从后台服务器获取到的签名信息
  3. :before-upload="beforeUpload" :选择文件上传之前触发的函数,我们需要在这个函数中发Ajax请求到后端服务器获取签名,然后赋值给 dataObj
  4. :on-success="handleUploadSuccess" : 上传成功之后的结果处理
  • JS部分
    export default {
         
         
      name: 'singleUpload',
      data() {
         
         
        return {
         
         
          url:'',
          fileList: [],
          dataObj: {
         
             //提交到OSS的参数
            policy: '',
            signature: '',
            key: '',
            ossaccessKeyId: '',
            dir: '',
            host: ''
          }
        };
      },
      methods: {
         
         
        handleRemove(file, fileList) {
         
         
        },
        handlePreview(file, fileList) {
         
         
        },
        beforeUpload(file) {
         
         
          let $this = this;
          //请求服务器签名
          axios.get('/ossSign').then(function(response){
         
         
            //设置相关的参数
            $this.dataObj.policy = response.data.policy;
            $this.dataObj.signature = response.data.signature;
            $this.dataObj.ossaccessKeyId = response.data.accessid;
            //上传的文件名,使用UUID处理一下
            {
         
         mathJaxContainer[0]}{
         
         filename}';
            $this.dataObj.dir = response.data.dir;
            $this.dataObj.host = response.data.host;
          }).catch(function (error) {
         
         
            console.log(error);
          });
        },
        handleUploadSuccess(res, file) {
         
         
          this.fileList.pop();
          //上传的完整的文件地址
          var urlPath = this.dataObj.host + '/' + this.dataObj.key.replace("${filename}",file.name) ;
          this.url = urlPath;
        }
      }
    }
    
    beforeUpload做的事情很简单,就是去服务器获取一个签名,然后赋值给dataObj即可,文件提交上传的时候自然就带上了签名的函数,最后在handleUploadSuccess方法中处理一下结果。

后续的动作就是把文件的地址根据业务情况保存到数据库表中,以后根据这个地址就可以访问文件了

OSS配置跨域

最后一步,配置OSS跨域,因为是WEB端向OSS服务器提交上传请求,所以要配置OSS跨域,否则是上传不了的,登录阿里云,找到跨域访问
在这里插入图片描述
配置跨域,“ * ” 代表允许所有的域名
在这里插入图片描述
到这里就结束了,最后启动程序,完成文件上传测试
在这里插入图片描述
登录OSS,文件列表
在这里插入图片描述

相关实践学习
借助OSS搭建在线教育视频课程分享网站
本教程介绍如何基于云服务器ECS和对象存储OSS,搭建一个在线教育视频课程分享网站。
相关文章
|
1月前
|
分布式计算 大数据 MaxCompute
MaxCompute产品使用合集之使用pyodps读取OSS(阿里云对象存储)中的文件的步骤是什么
MaxCompute作为一款全面的大数据处理平台,广泛应用于各类大数据分析、数据挖掘、BI及机器学习场景。掌握其核心功能、熟练操作流程、遵循最佳实践,可以帮助用户高效、安全地管理和利用海量数据。以下是一个关于MaxCompute产品使用的合集,涵盖了其核心功能、应用场景、操作流程以及最佳实践等内容。
|
5天前
|
弹性计算 负载均衡 定位技术
阿里云服务器地域怎么选?看这一篇文章就够了,小白入门
阿里云服务器地域选择应考虑速度延迟、内网互通、价格差异和备案限制。建议用户根据所在地区就近选择,以减少网络延迟。同一地域内的产品可实现内网互通,不同地域间则无法跨地域部署负载均衡或使用内网连接。价格因地域而异,部分区域可能有优惠。此外,若需在中国内地进行网站经营性备案,需选择特定地域如北京或深圳。详细信息参考阿里云官方页面。
27 5
阿里云服务器地域怎么选?看这一篇文章就够了,小白入门
|
9天前
|
存储 DataWorks 关系型数据库
DataWorks产品使用合集之在使用数据集成中的同步任务从mysql同步表到oss,存储为csv时,最终生成的文件中没有表头,这个属性可以在哪里配置么
DataWorks作为一站式的数据开发与治理平台,提供了从数据采集、清洗、开发、调度、服务化、质量监控到安全管理的全套解决方案,帮助企业构建高效、规范、安全的大数据处理体系。以下是对DataWorks产品使用合集的概述,涵盖数据处理的各个环节。
|
21天前
|
弹性计算 Kubernetes 监控
【阿里云弹性计算】阿里云 ECS 与 Kubernetes 集成:轻松管理容器化应用
【5月更文挑战第28天】阿里云ECS与Kubernetes集成,打造强大容器管理平台,简化应用部署,实现弹性扩展和高效资源管理。通过Kubernetes声明式配置在ECS上快速部署,适用于微服务和大规模Web应用。结合监控服务确保安全与性能,未来将深化集成,满足更多业务需求,引领容器化应用管理新趋势。
201 2
|
24天前
|
存储 Prometheus 运维
【阿里云云原生专栏】云原生下的可观测性:阿里云 ARMS 与 Prometheus 集成实践
【5月更文挑战第25天】阿里云ARMS与Prometheus集成,为云原生环境的可观测性提供强大解决方案。通过集成,二者能提供全面精准的应用监控,统一管理及高效告警,助力运维人员及时应对异常。集成示例代码展示配置方式,但需注意数据准确性、监控规划等问题。这种集成将在云原生时代发挥关键作用,不断进化以优化用户体验,推动业务稳定发展。
142 0
|
26天前
|
开发工具 iOS开发
阿里云本机一键登录集成
阿里云本机一键登录集成
37 0
|
1月前
|
Cloud Native 关系型数据库 分布式数据库
数据库性能诊断工具DBdoctor通过阿里云PolarDB产品生态集成认证
DBdoctor(V3.1.0)成功通过阿里云PolarDB分布式版(V2.3)集成认证,展现优秀兼容性和稳定性。此工具是聚好看科技的内核级数据库性能诊断产品,运用eBPF技术诊断SQL执行,提供智能巡检、根因分析和优化建议。最新版V3.1.1增加了对PolarDB-X和OceanBase的支持,以及基于cost的索引诊断功能。PolarDB-X是阿里巴巴的高性能云原生分布式数据库,兼容MySQL生态。用户可通过提供的下载地址、在线试用链接和部署指南体验DBdoctor。
201 0
|
1月前
|
运维 Java Serverless
Serverless 应用引擎产品使用之数据文件(例如sdxl)超过了OSS(对象存储服务)的单个上传大小限制(5GB)如何解决
阿里云Serverless 应用引擎(SAE)提供了完整的微服务应用生命周期管理能力,包括应用部署、服务治理、开发运维、资源管理等功能,并通过扩展功能支持多环境管理、API Gateway、事件驱动等高级应用场景,帮助企业快速构建、部署、运维和扩展微服务架构,实现Serverless化的应用部署与运维模式。以下是对SAE产品使用合集的概述,包括应用管理、服务治理、开发运维、资源管理等方面。
|
1月前
|
存储 JSON 前端开发
Javaweb之SpringBootWeb案例之阿里云OSS服务集成的详细解析
Javaweb之SpringBootWeb案例之阿里云OSS服务集成的详细解析
63 0
|
1月前
|
存储 开发工具 对象存储
Javaweb之SpringBootWeb案例之阿里云OSS服务入门的详细解析
Javaweb之SpringBootWeb案例之阿里云OSS服务入门的详细解析
40 0

热门文章

最新文章