阿里云OSS上手指导(下)

本文涉及的产品
对象存储 OSS,20GB 3个月
对象存储 OSS,恶意文件检测 1000次 1年
对象存储 OSS,内容安全 1000次 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>
&lt;groupId&gt;com.aliyun.oss&lt;/groupId&gt;
&lt;artifactId&gt;aliyun-sdk-oss&lt;/artifactId&gt;
&lt;version&gt;3.10.2&lt;/version&gt;

</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用的开心!

相关实践学习
借助OSS搭建在线教育视频课程分享网站
本教程介绍如何基于云服务器ECS和对象存储OSS,搭建一个在线教育视频课程分享网站。
相关文章
|
5月前
|
机器学习/深度学习 人工智能 专有云
人工智能平台PAI使用问题之怎么将DLC的数据写入到另一个阿里云主账号的OSS中
阿里云人工智能平台PAI是一个功能强大、易于使用的AI开发平台,旨在降低AI开发门槛,加速创新,助力企业和开发者高效构建、部署和管理人工智能应用。其中包含了一系列相互协同的产品与服务,共同构成一个完整的人工智能开发与应用生态系统。以下是对PAI产品使用合集的概述,涵盖数据处理、模型开发、训练加速、模型部署及管理等多个环节。
|
1月前
|
分布式计算 Java 开发工具
阿里云MaxCompute-XGBoost on Spark 极限梯度提升算法的分布式训练与模型持久化oss的实现与代码浅析
本文介绍了XGBoost在MaxCompute+OSS架构下模型持久化遇到的问题及其解决方案。首先简要介绍了XGBoost的特点和应用场景,随后详细描述了客户在将XGBoost on Spark任务从HDFS迁移到OSS时遇到的异常情况。通过分析异常堆栈和源代码,发现使用的`nativeBooster.saveModel`方法不支持OSS路径,而使用`write.overwrite().save`方法则能成功保存模型。最后提供了完整的Scala代码示例、Maven配置和提交命令,帮助用户顺利迁移模型存储路径。
|
4月前
|
存储 机器学习/深度学习 弹性计算
阿里云EMR数据湖文件系统问题之OSS-HDFS全托管服务的问题如何解决
阿里云EMR数据湖文件系统问题之OSS-HDFS全托管服务的问题如何解决
|
5月前
|
消息中间件 分布式计算 DataWorks
DataWorks产品使用合集之如何使用Python和阿里云SDK读取OSS中的文件
DataWorks作为一站式的数据开发与治理平台,提供了从数据采集、清洗、开发、调度、服务化、质量监控到安全管理的全套解决方案,帮助企业构建高效、规范、安全的大数据处理体系。以下是对DataWorks产品使用合集的概述,涵盖数据处理的各个环节。
|
5月前
|
存储 运维 安全
阿里云OSS的优势
【7月更文挑战第19天】阿里云OSS的优势
231 2
|
5月前
|
存储 API 开发工具
阿里云OSS
【7月更文挑战第19天】阿里云OSS
201 1
|
5月前
|
存储 弹性计算 对象存储
预留空间是什么?阿里云OSS对象存储预留空间说明
阿里云OSS预留空间是预付费存储产品,提供折扣价以锁定特定容量,适用于抵扣有地域属性的Bucket标准存储费用及ECS快照费。通过购买预留空间,如500GB通用预留+100GB标准-本地冗余存储包,用户可优化成本。
224 4
|
5月前
|
人工智能 对象存储
【阿里云AI助理】自家产品提供错误答案。阿里云OSS 资源包类型: 下行流量 地域: 中国内地通用 下行流量包规格: 300 GB 套餐: 下行流量包(中国内地) ,包1年。那么这个是每月300GB,1年是3600GB的流量;还是1年只有300GB的流量?
自家产品提供错误答案。阿里云OSS 资源包类型: 下行流量 地域: 中国内地通用 下行流量包规格: 300 GB 套餐: 下行流量包(中国内地) ,包1年。那么这个是每月300GB,1年是3600GB的流量;还是1年只有300GB的流量?
135 1
|
6月前
|
SQL 分布式计算 DataWorks
DataWorks产品使用合集之如何将CSV文件从阿里云OSS同步到ODPS表,并且使用列作为表分区
DataWorks作为一站式的数据开发与治理平台,提供了从数据采集、清洗、开发、调度、服务化、质量监控到安全管理的全套解决方案,帮助企业构建高效、规范、安全的大数据处理体系。以下是对DataWorks产品使用合集的概述,涵盖数据处理的各个环节。
DataWorks产品使用合集之如何将CSV文件从阿里云OSS同步到ODPS表,并且使用列作为表分区
|
7月前
|
SQL 分布式计算 监控
基于阿里云 EMR Serverless Spark 版快速搭建OSS日志分析应用
本文演示了使用 EMR Serverless Spark 产品搭建一个日志分析应用的全流程,包括数据开发和生产调度以及交互式查询等场景。
56606 7
基于阿里云 EMR Serverless Spark 版快速搭建OSS日志分析应用