阿里云对象存储服务OSS前后联调

阿里云对象存储服务OSS前后联调

  • 1、为什么要引入阿里云对象存储服务(OSS)?有什么好处?
    • 1.1、什么是对象存储OSS
    • 1.2、OSS工作原理
  • 2、阿里云对象存储-普通上传方式
    • 2.1、时序图
    • 2.2、登录并注册对象存储OSS
  • 3、 通过API接口上传数据对象
    • 3.1、引入依赖
    • 3.2、开通远程RAM访问权限
    • 3.3、编写测试类
    • 3.4、可以看到文件也上传成功
  • 4、 使用阿里云封装的Ali-Cloud OSS SDK进行上传
    • 4.1、引入依赖
    • 4.2、编写application.yml配置文件
    • 4.3、启动类上调用OSSClient方法
    • 4.3、不足
  • 5、阿里云对象存储-服务端签名后直传
    • 5.1、原理图
    • 5.2、controller
    • 5.3、开启Nacos注册和配置中心
    • 5.3、开启服务的注册与发现`@EnableDiscoveryClient`
    • 5.4、配置网关路由协议
  • 6、前后联调
    • 6.1、开启`允许跨域访问`
    • 【注意】

申明: 未经许可,禁止以任何形式转载,若要引用,请标注链接地址
全文共计11577字,阅读大概需要3分钟

1、为什么要引入阿里云对象存储服务(OSS)?有什么好处?

在分布式集群系统中,前端通过浏览器上传图片给服务器存储时存在分库分表的情况,这就涉及到文件存储的情况,在高并发的情况下,考虑到服务器的性能和利用率,都会采用负载均衡来缓解服务器的压力。比如同时有3个商品服务来响应用户的请求,为了减少查询的耗时,采用统一的文件存储来进行读写,可以选择自己搭建文件存储服务器,比如:Fast DFSvsftpd,但是搭建一个专门的服务器的技术和费用成本很高,后期还需要有专人来维护,不是很方便。
目前火热的阿里云对象存储OSS(Object Storage Service)是一个不错的选择。

1.1、什么是对象存储OSS

阿里云对象存储OSS(Object Storage Service)是一款海量、安全、低成本、高可靠的云存储服务。多种存储类型供选择,全面优化存储成本。

OSS具有与平台无关的RESTful API接口,可以在任何应用、任何时间、任何地点存储和访问任意类型的数据。

可以使用阿里云提供的API、SDK接口或者OSS迁移工具轻松地将海量数据移入或移出阿里云OSS。
数据存储到阿里云OSS以后,可以选择标准存储(Standard)作为移动应用、大型网站、图片分享或热点音视频的主要存储方式,也可以选择成本更低、存储期限更长的低频访问存储(Infrequent Access)、归档存储(Archive)、冷归档存储(Cold Archive)作为不经常访问数据的存储方式。

阿里云对象存储服务OSS前后联调_第1张图片

1.2、OSS工作原理

可以将数据以对象(Object)的形式存储在存储空间(Bucket )中,Object指的是一个文件和描述该文件的任何元数据,Bucket是保存Object的容器。

要将Object存储在OSS中,需要先创建Bucket,然后指定Bucket名称以及所在地域(Region)。每个Object都需要定义ObjectName(也称为ObjectKey或者Key),作为Bucket中数据的唯一标识符。Object操作在OSS上具有原子性以及强一致性。

OSS以HTTP RESTful API的形式对外提供服务,访问不同地域需要不同的访问域名(Endpoint)。当请求访问OSS时,OSS通过使用访问密钥(AccessKey Id和AccessKey Secret)对称加密的方法来验证某个请求的发送者身份。

存储空间
存储空间是用户用于存储对象(Object)的容器,所有的对象都必须隶属于某个存储空间。存储空间具有各种配置属性,包括地域、访问权限、存储类型等。用户可以根据实际需求,创建不同类型的存储空间来存储不同的数据。

对象
对象是OSS存储数据的基本单元,也被称为OSS的文件。和传统的文件系统不同,对象没有文件目录层级结构的关系。对象由元信息(Object Meta),用户数据(Data)和文件名(Key)组成,并且由存储空间内部唯一的Key来标识。对象元信息是一组键值对,表示了对象的一些属性,比如最后修改时间、大小等信息,同时用户也可以在元信息中存储一些自定义的信息。

对象名称
在各语言SDK中,ObjectKey、Key以及ObjectName是同一概念,均表示对Object执行相关操作时需要填写的Object名称。例如向某一存储空间上传Object时,ObjectKey表示上传的Object所在存储空间的完整名称,即包含文件后缀在内的完整路径,如填写为abc/efg/123.jpg。

地域
Region表示OSS的数据中心所在物理位置。用户可以根据费用、请求来源等选择合适的地域创建Bucket。一般来说,距离用户更近的Region访问速度更快。详情请参见OSS已经开通的Region。

访问域名
Endpoint表示OSS对外服务的访问域名。OSS以HTTP RESTful API的形式对外提供服务,当访问不同的Region的时候,需要不同的域名。通过内网和外网访问同一个Region所需要的Endpoint也是不同的。例如杭州Region的外网Endpoint是oss-cn-hangzhou.aliyuncs.com,内网Endpoint是oss-cn-hangzhou-internal.aliyuncs.com。具体的内容请参见各个Region对应的Endpoint。

访问密钥
AccessKey简称AK,指的是访问身份验证中用到的AccessKeyId和AccessKeySecret。OSS通过使用AccessKeyId和AccessKeySecret对称加密的方法来验证某个请求的发送者身份。AccessKeyId用于标识用户;AccessKeySecret是用户用于加密签名字符串和OSS用来验证签名字符串的密钥,必须保密。

2、阿里云对象存储-普通上传方式

用户通过自己的简单后台应用服务器将数据以对象的形式存储在OSS上
阿里云对象存储服务OSS前后联调_第2张图片

2.1、时序图

阿里云对象存储服务OSS前后联调_第3张图片

2.2、登录并注册对象存储OSS

官网地址:https://www.aliyun.com/product/oss?spm=5176.19720258.J_3207526240.33.e93976f4FQUO0P
阿里云对象存储服务OSS前后联调_第4张图片

创建bucket

https://oss.console.aliyun.com/overview
阿里云对象存储服务OSS前后联调_第5张图片

填写Bucket的名称,地域,存储类型的基本信息

阿里云对象存储服务OSS前后联调_第6张图片

点进实例后,会看到

阿里云对象存储服务OSS前后联调_第7张图片

先简单测试一下本地上传

阿里云对象存储服务OSS前后联调_第8张图片

可以看到上传成功了

阿里云对象存储服务OSS前后联调_第9张图片
通过URL地址可以直接访问的到:https://gulimall-jerry-jy.oss-cn-hangzhou.aliyuncs.com/5b5e74d0978360a1.jpg

3、 通过API接口上传数据对象

3.1、引入依赖

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

阿里云对象存储服务OSS前后联调_第10张图片

3.2、开通远程RAM访问权限

RAM(Resource Acess Management)资源访问控制:RAM 用户是一个身份实体,它通常代表您的组织中需要访问云资源的人员或应用程序。
https://ram.console.aliyun.com/users/new
若开通 Open API 调用访问,请及时保存 AccessKey 信息,页面关闭后将无法再次获取信息。
阿里云对象存储服务OSS前后联调_第11张图片

3.3、编写测试类

 @Test
    public void testUpload() {
        // Endpoint以华东1(杭州)为例,其它Region请按实际情况填写。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
        String accessKeyId = "LTAI5tQRCX6FBx77qqhepLo9";
        String accessKeySecret = "UGvWNebBJusYPTIv9kRfBsEckthRqF";
        // 填写Bucket名称,例如examplebucket。
        String bucketName = "gulimall-jerry-jy";
        // 填写Object完整路径,完整路径中不能包含Bucket名称,例如exampledir/exampleobject.txt。
        String objectName = "9.png";
        // 填写本地文件的完整路径,例如D:\\localpath\\examplefile.txt。
        // 如果未指定本地路径,则默认从示例程序所属项目对应本地路径中上传文件流。
        String filePath = "C:\\Users\\15718\\Desktop\\png\\9.png";

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

        try {
            InputStream inputStream = new FileInputStream(filePath);
            // 创建PutObject请求。
            ossClient.putObject(bucketName, objectName, inputStream);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        } finally {
            if (ossClient != null) {
                System.out.println("上传完成!");
                ossClient.shutdown();
            }
        }
    }

阿里云对象存储服务OSS前后联调_第12张图片

3.4、可以看到文件也上传成功

阿里云对象存储服务OSS前后联调_第13张图片

可以通过URL访问图片:https://gulimall-jerry-jy.oss-cn-hangzhou.aliyuncs.com/9.png

4、 使用阿里云封装的Ali-Cloud OSS SDK进行上传

4.1、引入依赖

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

阿里云对象存储服务OSS前后联调_第14张图片

4.2、编写application.yml配置文件

spring:
	cloud: 
	    alicloud:
	      access-key: LTAI5tQRCX6FBx77qqhepLo9
	      secret-key: UGvWNebBJusYPTIv9kRfBsEckthRqF
	      oss:
	        endpoint: oss-cn-hangzhou.aliyuncs.com

阿里云对象存储服务OSS前后联调_第15张图片

4.3、启动类上调用OSSClient方法

可以看到控制台打印了【上传成功】
阿里云对象存储服务OSS前后联调_第16张图片
去阿里云控制台检查下是否成功
阿里云对象存储服务OSS前后联调_第17张图片
通过【URL】https://gulimall-jerry-jy.oss-cn-hangzhou.aliyuncs.com/8.png
也能正常访问,证明上传成功

4.3、不足

通过我们自己的应用服务器上传数据到OSS,如果前端访问的数据量过大,过造成应用服务器的性能瓶颈,最好的办法是采用服务端签名后直传

5、阿里云对象存储-服务端签名后直传

5.1、原理图

阿里云对象存储服务OSS前后联调_第18张图片

5.2、controller

package com.jerry.gulimall.thirdparty.controller;

import com.aliyun.oss.OSS;
import com.aliyun.oss.common.utils.BinaryUtil;
import com.aliyun.oss.model.MatchMode;
import com.aliyun.oss.model.PolicyConditions;
import com.jerry.common.utils.R;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.beans.factory.annotation.Value;
import java.util.Date;
import java.util.Map;
import java.text.SimpleDateFormat;
import java.util.LinkedHashMap;

/**
 * @author 金阳
 * @description
 * @create 2022-07-22 1:24
 */



@RestController
public class OssController {

    @Autowired
    OSS ossClient;

    @Value("${spring.cloud.alicloud.oss.endpoint}")
    private String endpoint;
    @Value("${spring.cloud.alicloud.oss.bucket}")
    private String bucket;

    @Value("${spring.cloud.alicloud.access-key}")
    private String accessId;


    @RequestMapping("/oss/policy")
    public R policy() {



        //https://gulimall-hello.oss-cn-beijing.aliyuncs.com/hahaha.jpg

        String host = "https://" + bucket + "." + endpoint; // host的格式为 bucketname.endpoint
        // callbackUrl为 上传回调服务器的URL,请将下面的IP和Port配置为您自己的真实信息。
//        String callbackUrl = "http://88.88.88.88:8888";
        String format = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
        String dir = format + "/"; // 用户上传文件时指定的前缀。

        Map<String, String> respMap = null;
        try {
            long expireTime = 30;
            long expireEndTime = System.currentTimeMillis() + expireTime * 1000;
            Date expiration = new Date(expireEndTime);
            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);

            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));
            // respMap.put("expire", formatISO8601Date(expiration));


        } catch (Exception e) {
            // Assert.fail(e.getMessage());
            System.out.println(e.getMessage());
        }

        return R.ok().put("data",respMap);
    }
}

5.3、开启Nacos注册和配置中心

编写application.yml

spring:
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
    alicloud:
      access-key: LTAI5tQRCX6FBx77qqhepLo9
      secret-key: UGvWNebBJusYPTIv9kRfBsEckthRqF
      oss:
        endpoint: oss-cn-hangzhou.aliyuncs.com
        bucket: gulimall-jerry-jy

  application:
    name: gulimall-third-party

server:
  port: 30000

配置bootstrap.properties

spring.application.name=gulimall-third-party
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
spring.cloud.nacos.config.namespace=0b0b4ca3-539e-44ed-ab10-1f9ac6af6458


spring.cloud.nacos.config.ext-config[0].data-id=oss.yml
spring.cloud.nacos.config.ext-config[0].group=DEFAULT_GROUP
spring.cloud.nacos.config.ext-config[0].refresh=true

完成Nacos Server配置

阿里云对象存储服务OSS前后联调_第19张图片

配置详情

阿里云对象存储服务OSS前后联调_第20张图片

5.3、开启服务的注册与发现@EnableDiscoveryClient

阿里云对象存储服务OSS前后联调_第21张图片

5.4、配置网关路由协议

        - id: third_party_route
          uri: lb://gulimall-third-party
          predicates:
            - Path=/api/thirdparty/**
          filters:
            - RewritePath=/api/thirdparty/(?<segment>.*),/$\{segment}

阿里云对象存储服务OSS前后联调_第22张图片

访问http://localhost:88/api/thirdparty/oss/policy可以看到能响应json数据,说明服务的注册与发现功能正常

阿里云对象存储服务OSS前后联调_第23张图片

6、前后联调

6.1、开启允许跨域访问

阿里云对象存储服务OSS前后联调_第24张图片

要允许浏览器提交的所有的请求和允许所有的请求头访问OSS

阿里云对象存储服务OSS前后联调_第25张图片

先启动后端项目,再启动前端项目,上传我们的本地图片,可以看到是,图片回显是成功的

阿里云对象存储服务OSS前后联调_第26张图片

去阿里云控制台检查,可以看到能正常接受用户上传的图片

阿里云对象存储服务OSS前后联调_第27张图片

【注意】


图片预览没用回显,发现是
请求网址: https://gulimall-jerry-jy.https//oss-cn-hangzhou.aliyuncs.com/2022-07-22/41168c92-c4b5-4be0-8f5d-8bcade308477_1.png
这里多了一个https

阿里云对象存储服务OSS前后联调_第28张图片

经检查:原因是在application.yml中的endpoint配置多了一个https://应该去掉

阿里云对象存储服务OSS前后联调_第29张图片

Nacos Server中的oss.yml记得也要修改

阿里云对象存储服务OSS前后联调_第30张图片

再次上传图片,发送请求,能正常回显了,响应头也是正常

阿里云对象存储服务OSS前后联调_第31张图片

你可能感兴趣的:(SpringBoot,SpringCloud,阿里云,云计算)