qiniuKodo

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

putObject

概述

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及更高版本