448      小米  小米6

快速搭建移动应用上传回调服务__移动应用端直传实践_最佳实践_对象存储 OSS-阿里云

背景

快速搭建移动应用直传服务介绍了如何在30分钟内中搭建一个基于OSS的移动应用数据直传服务。移动端开发场景流程图如下：

角色解析

• Android/iOS移动应用负责申请STS凭证，然后使用从应用服务器获取的凭证上传。
• 应用服务器负责为Android/iOS移动应用生成STS凭证。
• OSS负责处理移动应用的数据请求。

问题

对于Android/iOS移动应来说，移动应用只需要执行操作1（申请STS凭证），就能调用多次5(使用该STS凭证上传数据到OSS)。这样就导致了应用服务器根本不知道用户都上传了哪些数据 ，如果那么作为该APP的开发者，就没法对应用上传数据进行管理。所以，有什么问题能让应用服务器感知到Android/iOS移动应用上传的数据呢?

答案

通过使用OSS的上传回调服务，就能解决上述问题，如下图：

即OSS在收到Android/iOS移动的数据（第5步）和在返回用户上传结果（第6步）之间，触发一个上传回调工作。即第5.5步。先回调用户服务器，然后得到应用服务器返回的内容，将这个内容返回给Android/iOS移动应用。

可以参考Callback API文档。

上传回调的作用

• 通过上传回调可以让用户应用服务器知道当前上传文件的基本信息。

  基本信息如下表。返回下述变量的一个或者多个，返回内容格式形式在Android/iOS上传时指定。

• 通过上传回调设定自定义参数，达到信息传递目的。
  假如您是一个开发者，您想知道当前用户所使用的APP版本、当前用户所在的操作系统版本、用户的GPS信息、用户的手机型号。那么您可以在Android/iOS端上传文件时，指定上述自定义参数 ，如x:version指定APP版本，x:system指定操作系统版本，x:gps指定GPS信息，x:phone指定手机型号。这些值会在Android/iOS移动应用上传到OSS时附带上。然后OSS会把这些值放到CallbackBody里面，一起发给应用服务器。这样应用服务器就能收到这些信息，达到信息传递的目的。

在移动应用端设定上传回调

要让OSS在接收上传请求时，触发上传回调，那么移动应用在构造上传请求时必须把两个内容指定到上传请求里面。这两个内容如下：

1. 要回调到哪个服务器callbackUrl，如 https://abc.com/callback.php，注意这个地址必须是公网能够访问的。
2. 上传回调给应用服务器的内容callbackBody。可以是上述OSS返回应用服务器系统变量的一个或者多个。

举个例子。假如您的用户服务器上传回调地是https://abc.com/callback.php。您想获取手机上传的文件名字、文件的大小，并且定义了photo变量是指手机型号，system是指操作系统版本。

iOS指定上传回调示例

OSSPutObjectRequest * request = [OSSPutObjectRequest new];
request.bucketName = @"<bucketName>";
request.objectKey = @"<objectKey>";
request.uploadingFileURL = [NSURL fileURLWithPath:@<filepath>"];
// 设置回调参数
request.callbackParam = @{
                          @"callbackUrl": @"https://abc.com/callback.php",
                          @"callbackBody": @"filename=${object}&size=${size}&photo=${x:photo}&system=${x:system}"
                          };
// 设置自定义变量
request.callbackVar = @{
                        @"x:photo": @"iphone6s",
                        @"x:system": @"ios9.1"
                        };

PutObjectRequest put = new PutObjectRequest(testBucket, testObject, uploadFilePath);
ObjectMetadata metadata = new ObjectMetadata();
metadata.setContentType("application/octet-stream");
put.setMetadata(metadata);
put.setCallbackParam(new HashMap<String, String>() {
    {
        put("callbackUrl", "https://abc.com/callback.php");
        put("callbackBody", "filename=${object}&size=${size}&photo=${x:photo}&system=${x:system}");
    }
});
put.setCallbackVars(new HashMap<String, String>() {
     {
         put("x:photo", "IPOHE6S");
         put("x:system", "YunOS5.0");
     }
});

POST /index.html HTTP/1.0
Host: 121.43.113.8
Connection: close
Content-Length: 81
Content-Type: application/x-www-form-urlencoded
User-Agent: ehttp-client/0.0.1
authorization: kKQeGTRccDKyHB3H9vF+xYMSrmhMZjzzl2/kdD1ktNVgbWEfYTQG0G2SU/RaHBovRCE8OkQDjC3uG33esH2txA==
x-oss-pub-key-url: aHR0cDovL2dvc3NwdWJsaWMuYWxpY2RuLmNvbS9jYWxsYmFja19wdWJfa2V5X3YxLnBlbQ==
filename=test.txt&size=5&photo=iphone6s&system=ios9.1

filename=test.txt&size=5&photo=iphone6s&system=ios9.1