qiniuKodo

来自于:厦门软云网络科技有限公司立即使用

概述

qiniuKodo 模块封装了七牛云对象存储服务Kodo。

七牛云海量存储系统(KODO)是自主研发的非结构化数据存储管理平台,支持中心和边缘存储。平台经过多年大规模用户验证已跻身先进技术行列,并广泛应用于海量数据管理的各类场景。

使用前需了解七牛云对象存储相关内容,可查看七牛云对象存储文档

环境要求

1.ios系统版本:ios8.0及以上, 请注意编译时在编译界面的高级设置里面选择支持的系统版本。

2.Android: 编译时需勾选“使用升级环境编译”。

3.必须注册有七牛云用户账户,并开通Kodo服务。

使用此模块之前先配置 config 文件,配置方法如下:

  • 名称:qiniuKodo
  • 参数:ak、sk、bucket
  • 配置示例:
<feature name="qiniuKodo">
        <param name="ak" value="iJ5ZmJWfOQhgb2XqSrZX8u****" />
        <param name="sk" value="7oU6uvT0jguujAA8tf9ROG******" />
        <param name="bucket" value="module-dev" />
</feature>
  • 字段描述:

    ak:七牛云账号生成的Access Key ID,用于标识用户,用户将 AccessKey 放入访问请求,以便七牛云存储识别访问者的身份 [API密钥管理]

    sk:七牛云账号生成的Secret Access Key,用于加密签名字符串和服务器端验证签名字符串的密钥 [API密钥管理]

    bucket:七牛云的存储空间,是资源的组织管理单位,一个资源必然位于某个空间中。可以为每个空间设置一系列的属性,以对资源提供合理的管理动作。存储空间管理

模块接口

putObject

上传文件

putObject({params}, callback(ret, err))

params

token:

  • 类型:字符串
  • 描述:(可选项)上传文件所需的签名,从服务端获取的上传token

objectKey:

  • 类型:字符串
  • 描述:文件存储在云上的命名,如:test.jpg

filePath:

  • 类型:字符串
  • 描述:上传对象,需上传本地文件路径,支持fs://、widget://等文件路径协议及真实路径

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    eventType: 'onComplete',    //字符串类型;事件类型
                             //取值范围:
                             //onComplete(成功)
                             //onProgress(进度)
                             //onError(失败)
    percent: '',             //字符串类型;上传进度,仅onProgress有值
    key: '',           //字符串类型;文件在云上的命名。仅onComplete有值
    status: '',           //字符串类型;状态码。仅onComplete有值
    requestID: '',           //字符串类型;七牛服务器生成的请求ID,用来跟踪请求信息,如果使用过程中出现问题,请反馈此ID。onComplete有值
}

示例代码

var qiniu = api.require('qiniuKodo');
qiniu.putObject({
    objectKey: "test.jpg",
    filePath: "widget://image/test.jpg"
}, function(ret, err){      
    if( ret ){
        alert( JSON.stringify( ret ) );
    }else{
        alert( JSON.stringify( err ) );
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本