JavaScript-SDK之如何实现安装?-问答-阿里云开发者社区-阿里云

开发者社区> 问答> 正文

JavaScript-SDK之如何实现安装?

2017-10-19 09:31:22 1883 0

SDK安装



要求


  • 开通阿里云OSS服务,如果您还没不了解阿里云OSS服务,请登录OSS产品主页了解。

  • 创建AccessKeyId和AccessKeySecret,由于云账号AccessKey有所有API访问权限,建议遵循阿里云安全最佳实践。如果部署在服务端可以使用RAM子账号或STS来进行API访问或日常运维管控操作,如果部署在客户端请使用STS方式来进行API访问。详情请参见访问控制


环境要求


OSS JavaScript SDK基于 Node.js环境构建,通过 BrowserifyBabel产生适用于浏览器的代码。用户在浏览器中和Node.js环境中都可以使用OSS JavaScript SDK。
但是由于浏览器环境的特殊性,有一些功能无法使用:
  • 流式上传:浏览器中无法设置chunked编码,用分片上传替代
  • 操作本地文件:浏览器中不能直接操作本地文件系统,用签名URL的方式下载
  • Bucket相关的操作(listBuckets/BucketACL/BucketLogging等),由于OSS暂时不支持Bucket相关的跨域请求,Bucket相关的操作可以在控制台进行


使用方式


OSS JavaScript SDK同时支持同步和异步的使用方式,参考 这篇文章
  • 同步方式:类似协程的方式,基于Generator Function,使用co和yield
  • 异步方式:类似callback的方式,API接口返回Promise,使用.then()处理返回结果,使用.catch()处理错误

在同步方式中,使用new OSS()创建client,在异步方式中,使用new OSS.Wrapper()创建client。
下面分别举例,先上传一个文件,然后立即下载这个文件:

同步方式
// var client = new OSS(...);
var co = require('co');
co(function* () {
  var r1 = client.put('object', '/tmp/file');
  console.log('put success: %j', r1);
  var r2 = client.get('object');
  console.log('get success: %j', r2);
}).catch(function (err) {
  console.error('error: %j', err);
});



异步方式
// var client = new OSS.Wrapper(...);
client.put('object', '/tmp/file').then(function (r1) {
  console.log('put success: %j', r1);
  return client.get('object');
}).then(function (r2) {
  console.log('get success: %j', r2);
}).catch(function (err) {
  console.error('error: %j', err);
});


安装



在浏览器中使用


支持的浏览器:
  • IE(>=10)和Edge
  • 主流版本的Chrome/Firefox/Safari
  • 主流版本的Android/iOS/WindowsPhone

在浏览器中使用只需要在网页标签中包含如下<script>标签: <script src="http://gosspublic.alicdn.com/aliyun-oss-sdk-4.3.0.min.js"></script>

就可以在代码中使用OSS.Wrapper对象: <script type="text/javascript">
  var client = new OSS.Wrapper({
    region: '<oss region>',
    //云账号AccessKey有所有API访问权限,建议遵循阿里云安全最佳实践,创建并使用STS方式来进行API访问
    accessKeyId: '<Your accessKeyId(STS)>',
    accessKeySecret: '<Your accessKeySecret(STS)>',
    stsToken: '<Your securityToken(STS)>',
    bucket: '<Your bucket name>'
  });
</script>



使用Node.js


支持的Node.js版本:
  • 4.x
  • 5.x

首先使用 npm安装SDK的开发包: npm install ali-oss

然后在你的程序中使用: var OSS = require('ali-oss');
var client = new OSS({
  region: '<oss region>',
  //云账号AccessKey有所有API访问权限,建议遵循阿里云安全最佳实践,部署在服务端使用RAM子账号或STS,部署在客户端使用STS。
  accessKeyId: '<Your accessKeyId>',
  accessKeySecret: '<Your accessKeySecret>',
  bucket: '<Your bucket name>'
});


如果使用npm遇到网络问题,可以使用淘宝提供的npm镜像: cnpm

使用Bower


对于Web项目,你也可以通过 Bower安装SDK: bower install ali-oss

然后在网页中添加<script>标签: <script src="bower_components/ali-oss/dist/aliyun-oss-sdk.min.js"></script>

取消 提交回答
全部回答(0)
相关问答

145

回答

【新手入门】云服务器linux使用手册

fanyue88888 2012-11-26 17:14:18 159471浏览量 回答数 145

119

回答

OSS存储服务-客户端工具

newegg11 2012-05-17 15:37:18 301160浏览量 回答数 119

22

回答

爬虫数据管理【问答合集】

我是管理员 2018-08-10 16:37:41 148561浏览量 回答数 22

31

回答

[@倚贤][¥20]刚学完html/css/js的新手学习servlet、jsp需要注意哪些问题?

弗洛伊德6 2018-10-27 21:52:43 147559浏览量 回答数 31

43

回答

【精品问答集锦】Python热门问题

小六码奴 2019-05-30 15:27:34 142938浏览量 回答数 43

82

回答

OSS入门教程

belle.zhoux 2014-07-07 17:14:27 158443浏览量 回答数 82

251

回答

阿里云LNAMP(Linux + Nginx + Apache + MySQL + PHP)环境一键安装脚本

云代维 2014-02-14 15:26:06 309435浏览量 回答数 251

8

回答

mail.aliyun.com邮箱android手机客户端设置方法

jack_yang 2013-04-24 09:01:34 123811浏览量 回答数 8

24

回答

【精品问答】python技术1000问(1)

问问小秘 2019-11-15 13:25:00 483550浏览量 回答数 24

2

回答

区域选择帮助

fanyue88888 2012-12-07 15:54:30 205455浏览量 回答数 2
+关注
3598
文章
840
问答
问答排行榜
最热
最新
相关电子书
更多
JS零基础入门教程(上册)
立即下载
性能优化方法论
立即下载
手把手学习日志服务SLS,云启实验室实战指南
立即下载