Skip to content

Commit 83d63e8

Browse files
committed
Refined doc.
1 parent dbc9726 commit 83d63e8

File tree

1 file changed

+9
-8
lines changed

1 file changed

+9
-8
lines changed

docs/README.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -25,14 +25,19 @@ Android SDK只包含了最终用户使用场景中的必要功能。相比服务
2525

2626
在使用Android SDK开发基于七牛云存储的应用之前,请注意理解合适的开发场景。客户端属于不可控的场景,非一般用户在拿到客户端后可能会对其进行反向工程,因此客户端程序中不可包含任何可能导致安全漏洞的业务逻辑和关键信息。
2727

28-
我们推荐的安全模型如下所示
28+
我们推荐的安全模型如下所示
2929

3030
![安全模型](http://developer.qiniu.com/docs/v6/api/overview/img/token.png)
3131

3232
开发者需要合理划分客户端程序和业务服务器的职责范围。分发给最终用户的客户端程序中不应有需要使用管理凭证及SecretKey的场景。这些可能导致安全风险的使用场景均应被设计为在业务服务器上进行。
3333

3434
更多的相关内容请查看[编程模型](http://developer.qiniu.com/docs/v6/api/overview/programming-model.html)[安全机制](http://developer.qiniu.com/docs/v6/api/overview/security.html)
3535

36+
<a name="security"></a>
37+
## 安全性
38+
39+
该SDK未包含凭证生成相关的功能。开发者对安全性的控制应遵循[安全机制](http://developer.qiniu.com/docs/v6/api/overview/security.html)中建议的做法,即客户端应向业务服务器请求上传和下载凭证,而不是直接在客户端使用AccessKey/SecretKey生成对应的凭证。在客户端使用SecretKey会导致严重的安全隐患。
40+
3641
<a name="load"></a>
3742
## 接入SDK
3843

@@ -97,7 +102,7 @@ class ResumableIO {
97102

98103
分片上传机制也提供了对一个文件并发上传的能力。
99104

100-
> 目前底层采用AsyncTask来完成异步操作,系统底层默认是使用单线程来串行运行所有的AsyncTask,所以如果需要真正意义上的多线程上传,需要将AsyncTask放入线程池, 详细操作请参考[这里](http://developer.android.com/reference/android/os/AsyncTask.html)
105+
目前本SDK的实现采用AsyncTask来进行异步操作,而Android系统底层默认是使用单线程来串行运行所有的AsyncTask,所以如果需要真正意义上的多线程上传,需要将AsyncTask放入线程池, 详细操作请参考[这里](http://developer.android.com/reference/android/os/AsyncTask.html)
101106

102107
<a name="upload-config"></a>
103108
### 高级设置
@@ -110,16 +115,12 @@ class ResumableIO {
110115
extra.params = new HashMap<String, String>();
111116
extra.params.put("x:a", "bb"); // 设置一个自定义变量
112117
```
113-
114118
<a name="response"></a>
115119
#### 上传后续动作
116120

117-
关于上传后可以进行哪些后续动作,请查看[上传后续动作](http://developer.qiniu.com/docs/v6/api/overview/up/response/)。上传的后续动作的设置通过在`PutExtra`中设置相应的参数来进行。对于Android开发者而言,这些后续动作都有各自的合适使用场景:[自定义响应内容](http://developer.qiniu.com/docs/v6/api/overview/up/response/response-body.html)[变量](http://developer.qiniu.com/docs/v6/api/overview/up/response/vars.html)[数据预处理](http://developer.qiniu.com/docs/v6/api/overview/up/response/persistent-op.html)[回调](http://developer.qiniu.com/docs/v6/api/overview/up/response/callback.html)
118-
119-
对这些后续动作的合理组合使用可以大幅降低业务流程复杂度,并提升业务的健壮性。
120-
121+
关于上传后可以进行哪些后续动作,请查看[上传后续动作](http://developer.qiniu.com/docs/v6/api/overview/up/response/)。上传的后续动作的设置通过在`PutExtra`中设置相应的参数来进行。对于Android开发者而言,这些后续动作都有各自的合适使用场景:[自定义响应内容](http://developer.qiniu.com/docs/v6/api/overview/up/response/response-body.html)[变量](http://developer.qiniu.com/docs/v6/api/overview/up/response/vars.html)[数据预处理](http://developer.qiniu.com/docs/v6/api/overview/up/response/persistent-op.html)[回调](http://developer.qiniu.com/docs/v6/api/overview/up/response/callback.html)。对这些后续动作的合理组合使用可以大幅降低业务流程复杂度,并提升业务的健壮性。
121122

122-
完整的可设置参数和规格请参见[上传策略规格](http://developer.qiniu.com/docs/v6/api/reference/security/put-policy.html)
123+
开发者可以在生成上传凭证前通过配置上传策略以控制上传后续动作,该工作在业务服务器端进行,因此非本SDK的功能范畴。完整的内容请参见[上传策略规格](http://developer.qiniu.com/docs/v6/api/reference/security/put-policy.html)
123124

124125
<a name="var"></a>
125126
#### 变量

0 commit comments

Comments
 (0)