阿里云OSS上手指导(下)

本文涉及的产品
对象存储 OSS,标准 - 本地冗余存储 20GB 3个月
对象存储 OSS,标准 - 同城冗余存储 20GB 3个月
对象存储OSS,敏感数据保护2.0 200GB 1年
简介: OSS提供了API和SDK两种方式接入OSS,SDK提供了主流语言的实现。我们就以两种方式展开说明具体接入实现过程。

在上一篇中我们讲了OSS是什么?为什么要用?以及怎样选购和配置。本篇我们主要来看看怎样使用,我们以Java和PHP两种语言来示范。

在OSS控制台右侧的Bucket管理界面上,我们可以看到官方提供的新手入门和API文档:
1.png

现在我们知道官方既提供了API接口方式接入,有提供了SDK集成的方式。官方提供的SDK覆盖了大部分热门的语言技术栈,包括Java、Python、Go、C++、PHP等,很少情况下我们需要自己通过API的方式来接入。但如果你有代码洁癖或者使用的技术栈确实没有SDK,譬如Perl或者Lisp,那可以尝试使用API的方式来接入。

API方式接入OSS

我们就以PHP语言来演示如何通过API的方式接入OSS。首先,在常用入口那儿可以查询到Access Key,包括一对AccessKey ID和AccessKey Secret。无论是通过API还是SDK方式接入,这两个参数都是必须的。

其实,文件上传到OSS上和文件上传到我们自己服务器上的流程,并没有多少区别,我们还是会用HTTP协议,通过FORM表单的形式提交数据。不同在于构建这个header头的参数有些差异罢了。OSS要求我们在header头中,携带一个Authorization参数,用于验证客户端身份。所以重点就是围绕如何构建这个参数,来实现HTTP协议的通信。

既然和我们传统http的form表单上传差异在header上,我们不妨就从header入手。首先定义一个数组来放置我们的header参数:

//GMT时间
$date = gmdate('D, d M Y H:i:s T');
//mime
$mime = 'image/png';
//构建报头
$header = array(
    'Host' => 'oss.aliyuncs.com',
    'Date' => $date,
    'Content-Type' => $mime
);

如上示例定义的header头中,包含了一个Host用于指定HTTP协议送达的主机域,另外,OSS的API文档中,要求我们提供一个Date参数来表示时间,格式使用GMT。最后,Content-Type参数来表明我们上传的文件格式。为了演示方便,我们这里写死为"image/png",表示上传的是png格式的图片。读者可以根据自身业务逻辑来获取并传递这个MIME。

还记得我们上一篇中创建的Bucket名字么?这里就派上用场了,我们得指定文件往哪上传,以为OSS中可能不止一个bucket。通常这个资源标识符是这样的:

仓库(bucket)名称 + 目录名称 + 文件名

假设我们在名为1doc的bucket中有个目录叫做images,现在要上传defult.png文件到这个目录中,那么uri就应该是这样子的:

1doc/images/default.png

我们把这个资源标识符保存到一个变量中,待会使用:

$bucketMame = '1doc';
$menu = '/images/';
$fileName = 'default.png';
$savePath = $bucketName . $menu . $fileName;

那么重点来了,我们要开始准备构建Authorization参数了。

第一步根据API文档中的指导精神,我们遵循HTTP协议,通过PUT方式来上传文件,拼接出请求头:

$signStr = "PUT\n" . $mime . "\n" . $date . "\n" . $savePath;

第二步,通过sha1算法将上面这个待签名的字符串和AccessKey Secret加密,再用base64编码:

$signature = base64_encode(hash_mac('sha1', $signStr, $accessKeySecret, true));

第三步,使用AccessKey ID 与上面的签名字符拼接成最终的Authorization,并加到header头中:

$sign = 'OSS ' . $accessKeyID . ':' . $signture;
$header['Authorization'] = $sign;

接下来的事儿就简单了,就是普通的HTTP请求了。当然,我们先准备好要上传的文件:

$file = file_get_contents('default.png');

然后通过curl来提交请求:

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'http://oss.aliyuncs.com/' . $savePath);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

return $info['http_code'];

对于PHP而言,笔者注意到OSS近来已经支持composer来引入SDK了,相较于早些年自己去加载.php文件要方便的多。所以,除非没有更好的解决方案,笔者还是建议使用SDK来集成。

SDK方式接入OSS

我们用java来演示通过sdk的方式接入OSS。笔者的项目使用Maven构建的,在Maven的pom.xml可以很方便地引入OSS SDK依赖:

<!-- 阿里云oss组件 -->
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.10.2</version>
</dependency>

我们在控制器中定义一个action用来接收客户端的form表单数据,并上传到OSS中:

@RestController
public class ResourceController {
  @PostMapping("upload.do")
    public JsonResult upload(MultipartFile file) {
    //具体上传逻辑
  }
}

现在我们来准备一些参数吧,包括AccessKey ID和AccessKey Secret,还有Bucket名字。

String accessKey = "your key";
String accessSecret = "your secret";
String bucketName = "1doc";
String endpoint = "http://oss-cn-shanghai.aliyuncs.com"

相对于API的繁琐,java的SDK提供了一个OSSClient来帮我们构建请求客户端,我们稍加封装成一个方法,以供不同的操作使用:

private OSS getClient() {
  return new OSSClientBuilder().build(endpoint, accessKey, accessSecret)
}

我们可以通过这个client去操作OSS文件的上传、下载、更新以及删除等操作,不必关系身份验证等细节问题。

来瞧瞧上传一个文件是多么的简单:

OSS ossClient = getClient();
ossClient.putObject(bucketName, fileName, inputStream);
ossClient.shutdown();

OSSClient对象中提供的putObject()方法用来上传文件,当然putObject有多个重载的方法,以上是以文件流的方式上传。

我们在控制器中接收到来自客户端form表单数据的 MultipartFile,通过getInputStream()方法就可以获得一个文件流,在这里传入就可以了。

除了putObject()方法,OSSClient对象还提供了诸多的操作OSS文件的方法,包括常用的增删改查,诸如此类无需再演示。

此致,祝你OSS用的开心!

相关实践学习
通义万相文本绘图与人像美化
本解决方案展示了如何利用自研的通义万相AIGC技术在Web服务中实现先进的图像生成。
目录
相关文章
|
存储 安全 关系型数据库
阿里云OSS上手指导(上)
随着流量渐渐起来,在图片访问这块就逐渐有压力了,毕竟现在这个年代,手机拍照的像素都是很不错的,虽然你也采用了一些常规的压缩优化手段,但在保证不丧失太多细节的情况下,一张图片的大小很容易也能达到MB吧。然而,所有的文件资源访问带宽都是由你这台主机来承担的,瓶颈会逐渐集中到带宽上。阿里云OSS提供了对象储存解决方案,我们就来了解一下。
1326 0
阿里云OSS上手指导(上)
|
Java API Go
阿里云OSS上手指导(下)
OSS提供了API和SDK两种方式接入OSS,SDK提供了主流语言的实现。我们就以两种方式展开说明具体接入实现过程。
阿里云OSS上手指导(下)
|
1月前
|
存储 人工智能 Cloud Native
阿里云渠道商:OSS与传统存储系统的差异在哪里?
本文对比传统存储与云原生对象存储OSS的架构差异,涵盖性能、成本、扩展性等方面。OSS凭借高持久性、弹性扩容及与云服务深度集成,成为大数据与AI时代的优选方案。
|
3月前
|
存储 运维 安全
阿里云国际站OSS与自建存储的区别
阿里云国际站对象存储OSS提供海量、安全、低成本的云存储解决方案。相比自建存储,OSS具备易用性强、稳定性高、安全性好、成本更低等优势,支持无限扩展、自动冗余、多层防护及丰富增值服务,助力企业高效管理数据。
|
3月前
|
存储 域名解析 前端开发
震惊!不买服务器,还可以用阿里云国际站 OSS 轻松搭建静态网站
在数字化时代,利用阿里云国际站OSS可低成本搭建静态网站。本文详解OSS优势及步骤:创建Bucket、上传文件、配置首页与404页面、绑定域名等,助你快速上线个人或小型业务网站,操作简单,成本低廉,适合初学者与中小企业。
|
机器学习/深度学习 人工智能 专有云
人工智能平台PAI使用问题之怎么将DLC的数据写入到另一个阿里云主账号的OSS中
阿里云人工智能平台PAI是一个功能强大、易于使用的AI开发平台,旨在降低AI开发门槛,加速创新,助力企业和开发者高效构建、部署和管理人工智能应用。其中包含了一系列相互协同的产品与服务,共同构成一个完整的人工智能开发与应用生态系统。以下是对PAI产品使用合集的概述,涵盖数据处理、模型开发、训练加速、模型部署及管理等多个环节。
|
9月前
|
SQL 分布式计算 Serverless
基于阿里云 EMR Serverless Spark 版快速搭建OSS日志分析应用
基于阿里云 EMR Serverless Spark 版快速搭建OSS日志分析应用
240 0
|
分布式计算 Java 开发工具
阿里云MaxCompute-XGBoost on Spark 极限梯度提升算法的分布式训练与模型持久化oss的实现与代码浅析
本文介绍了XGBoost在MaxCompute+OSS架构下模型持久化遇到的问题及其解决方案。首先简要介绍了XGBoost的特点和应用场景,随后详细描述了客户在将XGBoost on Spark任务从HDFS迁移到OSS时遇到的异常情况。通过分析异常堆栈和源代码,发现使用的`nativeBooster.saveModel`方法不支持OSS路径,而使用`write.overwrite().save`方法则能成功保存模型。最后提供了完整的Scala代码示例、Maven配置和提交命令,帮助用户顺利迁移模型存储路径。
|
存储 机器学习/深度学习 弹性计算
阿里云EMR数据湖文件系统问题之OSS-HDFS全托管服务的问题如何解决
阿里云EMR数据湖文件系统问题之OSS-HDFS全托管服务的问题如何解决
226 1

热门文章

最新文章

下一篇
oss云网关配置