阿里云OSS上手指导(下)-阿里云开发者社区

开发者社区> 开发与运维> 正文
登录阅读全文

阿里云OSS上手指导(下)

简介: 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用的开心!

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

其他文章