448      windows

快速搭建移動應用上傳回調服務__移動應用端直傳實踐_最佳實踐_對象存儲 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