513 阿裏雲技術社區[雲棲]

OSS移動開發實戰1 (30分鍾快速搭建基於OSS的移動應用)

30分鍾快速搭建移動應用直傳服務

背景

這是一個移動互聯的時代。手機APP上傳的數據會越來越多。把數據存儲的問題交給OSS，讓開發者能更加專注於自己的應用邏輯。
那麼怎麼樣基於OSS構建一個APP存儲係統呢？

目的

本教程就是讓你在30分鍾內搭建一個基於OSS的移動應用數據直傳服務，所謂直傳就是移動應用的數據的上傳和下載直接直連OSS，隻有控製流走用戶自己的服務器。

安全的上傳下載方式（臨時，靈活的賦權鑒權），
成本低（這樣用戶不需要準備很多服務器，因為移動應用直聯雲存儲，隻有控製流走用戶自己的應用服務器。）
高並發，支持海量用戶（OSS有海量的上傳和下載帶寬）
彈性（OSS有無限擴容的存儲空間）
方便（可以方便的對接到媒體轉碼服務-視頻多端適配，圖片處理服務，CDN加速下載等）

架構圖

本教程就是讓你在30分鍾內搭建一個基於OSS的移動應用數據直傳服務

詳細可以參考這裏

角色解析

Android/iOS 應用。即最終用戶手機上的APP；
OSS，即阿裏雲對象存儲，負責存儲APP上傳的數據，可以參考官網https://www.aliyun.com/product/oss；
RAM/STS負責生成臨時上傳憑證
用戶應用服務器，即提供該Android/iOS應用的開發者開發的APP後台服務，管理APP上傳和下載的Token. 甚至是用戶在APP上傳數據元數據信息。

數據流解析

Android/iOS應用不可能直接存儲AccessKeyID/AccessKeySecret，這樣會存在泄密的風險。所以應用必須向用戶的應用服務器申請一個臨時上傳憑證(注意下文將此臨時上傳憑證稱為Token)，注意這個Token是有時效性的，如這個Token的過期時間是30分鍾（這個時間可以由應用服務器指定），那麼在該Android/iOS應用在這30分鍾裏麵，使用這個Token可以從OSS上傳和下載數據， 30分鍾後再重新獲取。
用戶的應用服務器檢測上述請求的合法性，然後返回Token給應用。
手機拿到這個Token後就可以將數據上傳到OSS，或者從OSS下載數據了。

本教程的目的就是，介紹下述紅色和藍色框的內容

應用服務器如何生成這個Token，藍色方框
Android/iOS應用如何取Token，紅色方框

效果

本教程實現了一個APP,如下，大家可以掃描二維碼，安裝一下示例APP程序，這上工具是用Android開發。但是本教程的應用服務器搭建也適用於iOS, 即上述圖藍色的框的內容。

示例程序的體驗

示例程序的最終效果圖如下：

應用服務器：該移動應用對應的後台應用服務器。本教程搭建了一個後台應用服務器：https://oss-demo.aliyuncs.com/app-server/sts.php
上傳Bucket,指的是該移動應用要把數據上傳到哪個Bucket
區域：指的第二步指定的Bucket對應的區域。

示例APP的使用

可以點擊選擇圖片，然後就把文件上傳到OSS，上傳的方法，支持普通上傳和斷點上傳。注意在一些網絡環境差的環境下，最好用斷點上傳。然後可以利用圖片處理服務，可以對將上傳的圖片進行縮略和加水印處理。初始使用請暫時先不要改應用服務器地址和Bucket名字

搭建這樣一個APP上傳和下載的係統，需要準備的東西：

我必須開通了OSS，並且創建了Bucket，在這個例子裏麵的，對應的bucket是：sdk-demo
我必須開通STS服務。開通STS服務其實是為了如何生成上述所描述的Token
我必須搭建這樣一個應用服務器。這在個事例裏麵，我搭建的應用服務器的地址是：https://oss-demo.aliyuncs.com/app-server/sts.php . 注意這個例子本教程是采用PHP編寫的，但是事實上，用戶可以選擇自己喜歡的語言進行編寫，如Java 、Python、 Go、Ruby、Node.js、C#等編寫

為帳號開通STS服務

如果已經有bucket可以忽略這一步，如果沒有bucket，創建Bucket參考官網
第二步操作，開通STS，可以參考如下：
(1)要開通STS服務，首先OSS登陸官網控製台

(2)登錄管理控製台，點擊：安全令牌快捷配置

(3)會進入到令牌快捷配置頁麵，注意如果沒有開通RAM，會彈出開通的對話框。直接點開通，這個要求實名驗證。做完後跳到本頁麵。點擊開始授權

(4)點擊開始授權後，係統會進行自動授權，請千萬保存如下圖框住的三個參數

點擊保存AK信息後，對話框會關閉。保存好下麵標紅的結果3.

保存這三個參數後。到這一步，STS的開通已經完成了。
注意如果您之前已經點擊這個頁麵創建了AccessKeyId/AccessKeySecrte，彈出的頁麵如下：

點擊如下圖所示的查看

點擊如下圖所示的創建AccessKey

記下如下參數1，2

並記下如下參數3：

保存這三個參數後。到這一步，STS的開通已經完成了。

講解一下應用服務器的搭建。

為了方便大家開發。本教程準備了三個語言的版本示例程序 (Java、PHP、Ruby)

應用服務器代碼示例的下載

PHP: 下載地址
Java: 下載地址
Ruby: 下載地址

應用服務器示例的配置

每個語言包下載下來後，都會有一個配置文件config.json
如下例：

{
"AccessKeyID" : "",
"AccessKeySecret" : "",
"RoleArn" : "",
"TokenExpireTime" : "900",
"PolicyFile": "policy/all_policy.txt"
}

下麵對配置進行講解。

AccessKeyID填寫上述圖標紅的1的內容，即用戶自己在全
AccessKeySecret填寫上述圖片標紅2的內容
RoleArn 填寫上述圖標紅3的內容
TokenExpireTime 指Android/iOS應用取到這個Token的失效時間，注意，最少是900s, 默認值可以不修改，
PolicyFile: 填寫的是該該Token所要擁有的權限列表的文件，默認值可以不改本教程準備了三種最常用token 權限文件，放於policy目錄下麵。分別是 all_policy.txt : 指定了該token擁有對該帳號下,創建Bucket、刪除Bucket、上傳文件、下載文件、刪除文件的權限。 bucket_read_policy.txt ：指定了該token擁有該帳號下，對指定Bucket的權限。 bucket_read_write_policy.txt：指定了該token擁有該帳號下，對指定Bucket的權限。

如果你想要指定這個Token隻能對指定的bucket有讀寫權限，請把（bucket_read_policy.txt、 bucket_read_write_policy.txt）這個文件裏麵$BUCKET_NAME直接替換成指定的bucket名字。

返回的格式解析。

{
    "status":200,
    "AccessKeyId":"STS.3pYjsdgdgagdasdg",
    "AccessKeySecret":"rpnwO9kvEgetGdrddgsR2YrTtI",
    "Security":"CAES+wMIARKAAZhjH0EUOIhJMQBMjRywXq7MQ/cjLYg80Aho1ek0Jm63XMhr9Oc5s˙∂˙∂3qaPer8p1YaX1NTDiCFZWFkvlHf1pQhuxfKBc+mRR9KAbHUefqH+rdjZqjTF7p2m1wJXP8S6k+G2MpHrUe6TYBkJ43GhhTVFMuM3BZajY3VjZWOXBIODRIR1FKZjIiEjMzMzE0MjY0NzM5MTE4NjkxMSoLY2xpZGSSDgSDGAGESGTETqOio6c2RrLWRlbW8vKgoUYWNzOm9zczoqOio6c2RrLWRlbW9KEDExNDg5MzAxMDcyNDY4MThSBTI2ODQyWg9Bc3N1bWVkUm9sZVVzZXJgAGoSMzMzMTQyNjQ3MzkxMTg2OTExcglzZGstZGVtbzI=",
   "Expiration":"2015-12-12T07:49:09Z",
}

status:表示獲取Token的狀態，獲取成功時，返回值是200
AccessKeyId: 表示Android/iOS應用初始化OSSClient獲取的 AccessKeyId
AccessKeySecret: 表示Android/iOS應用初始化OSSClient獲取AccessKeySecret
SecurityToken：表示Android/iOS應用初始化的Token
Expiration: 表示該Token失效的時間。主要在Android SDK會自動判斷是否失效，自動獲取Token
注意上述這四個變量將構成了一個Token。

代碼示例的運行方法

對於PHP版本

PHP運行的,將包下載 後，然後修改好config.json這個文件。直接運行php sts.php 即能生成Token，將程序部署到指定的地址。

對於JAVA版本 (依賴於java 1.7)

下載編譯好的jar 包，下載地址： 
下載後解壓：
運行方法：java  -jar oss-token-server.jar (port)
如果不指定port（端口）， 直接運行java –jar  oss-token-server.jar , 程序會監聽7080端口
如果想讓程序執行在9000端口，運行java –jar oss-token-server.jar 9000 , 其他端口也類似。

體驗自己的APP上傳應用服務器


1. 把把程序部署起來後，記下應用服務器地址如 ：https://abc.com:8080, 將示例程序裏麵的應用服務器修改成上述地址

2. 選擇自己數據要上傳到哪個bcuket及區域，修改示例APP程序裏麵相應Bucket及區域。

3. 點擊設置按鈕，將配置加載。

4. 選擇圖片，設置上傳OSS文件名，上傳。然後就可以在Android上體驗OSS服務了。這樣你就能通Android 示例程序將數據直接上傳到OSS了 

5. 上傳成功後，可以看一下數據是否在OSS上了

核心代碼解析-OSS初始化

下麵講解一下如何利用Android/iOS SDK跟自己的應用服務器，請求Token

Android版本

//初始化一個OssService用來上傳下
public OssService initOSS(String endpoint, String bucket, UIDisplayer displayer) {
    OSSCredentialProvider credentialProvider;
    //使用自己的獲取STSToken的類
//從應用服務器控件裏麵讀取應用服務器地址
    String stsServer = ((EditText) findViewById(R.id.stsserver)).getText().toString();
    //STSGetter類，封裝如何跟從應用服務器取數據，必須繼承於OSSFederationCredentialProvider這個類。 取Token這個取決於你所寫的APP跟應用服務器數據的協議設計。
    if (stsServer .equals("")) {
        credentialProvider = new STSGetter();
    }else {
        credentialProvider = new STSGetter(stsServer);
    }
//獲取控件上的bucket名字
    bucket = ((EditText) findViewById(R.id.bucketname)).getText().toString();

//初始化OSSClient 
    ClientConfiguration conf = new ClientConfiguration();
    conf.setConnectionTimeout(15 * 1000); // 連接超時，默認15秒
    conf.setSocketTimeout(15 * 1000); // socket超時，默認15秒
    conf.setMaxConcurrentRequest(5); // 最大並發請求書，默認5個
    conf.setMaxErrorRetry(2); // 失敗後最大重試次數，默認2次
    OSS oss = new OSSClient(getApplicationContext(), endpoint, credentialProvider, conf);
    return new OssService(oss, bucket, displayer);
}

iOS版本


// 初始化一個OSSClient實例
- (void)ossInit {
    // 構造一個獲取STSToken的憑證提供器
    id<OSSCredentialProvider> credential = [[OSSFederationCredentialProvider alloc] initWithFederationTokenGetter:^OSSFederationToken * {
        // 實現一個函數，同步返回從server獲取到的STSToken
        return [self getFederationToken];
    }];

    // 用endpoint、憑證提供器初始化一個OSSClient
    client = [[OSSClient alloc] initWithEndpoint:endPoint credentialProvider:credential];
}

核心代碼解析-移動應用從應用服務器取Token

具體APP從就應用服務器取Token方法，必須寫到public OSSFederationToken getFederationToken() { } 這個函數裏麵。
注意這個函數的邏輯依賴於可以自己設定，但是最終結果必須返回這樣一個變量 return new OSSFederationToken(ak, sk, token, expiration);
其中ak, sk, token, expiration 必須是從應用服務器返回的Body獲取的。

在本例子裏，示例如下，注意用戶可以自定義自己的移動應用跟自己應用服務器之前的協議。

Android版本

public OSSFederationToken getFederationToken() {
    String stsJson;
    OkHttpClient client = new OkHttpClient();
    Request request = new Request.Builder().url(stsServer).build();
    try {
        Response response = client.newCall(request).execute();
        if (response.isSuccessful()) {
            stsJson = response.body().string();
        } else {
            throw new IOException("Unexpected code " + response);
        }
    }
    catch (IOException e) {
        e.printStackTrace();
        Log.e("GetSTSTokenFail", e.toString());
        return null;
    }

    try {
        JSONObject jsonObjs = new JSONObject(stsJson);
        String ak = jsonObjs.getString("AccessKeyId");
        String sk = jsonObjs.getString("AccessKeySecret");
        String token = jsonObjs.getString("SecurityToken");
        String expiration = jsonObjs.getString("Expiration");
        return new OSSFederationToken(ak, sk, token, expiration);
    }
    catch (JSONException e) {
        Log.e("GetSTSTokenFail", e.toString());
        e.printStackTrace();
        return null;
    }}

iOS版本


NSURL * url = [NSURL URLWithString:STSServer];
NSURLRequest * request = [NSURLRequest requestWithURL:url];
OSSTaskCompletionSource * tcs = [OSSTaskCompletionSource taskCompletionSource];
NSURLSession * session = [NSURLSession sharedSession];
NSURLSessionTask * sessionTask = [session dataTaskWithRequest:request
                                            completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                                                if (error) {
                                                    [tcs setError:error];
                                                    return;
                                                }
                                                [tcs setResult:data];
                                            }];
[sessionTask resume];

// 實現這個回調需要同步返回Token，所以要waitUntilFinished
[tcs.task waitUntilFinished];

if (tcs.task.error) {
    // 如果網絡請求出錯，返回nil表示無法獲取到Token。該次請求OSS會失敗。
    return nil;
} else {
    // 從網絡請求返回的內容中解析JSON串拿到Token的各個字段，組成STSToken返回
    NSDictionary * object = [NSJSONSerialization JSONObjectWithData:tcs.task.result
                                                            options:kNilOptions
                                                              error:nil];
    OSSFederationToken * token = [OSSFederationToken new];ni
    token.tAccessKey = [object objectForKey:@"AccessKeyId"];
    token.tSecretKey = [object objectForKey:@"AccessKeySecret"];
    token.tToken = [object objectForKey:@"SecurityToken"];
    token.expirationTimeInGMTFormat = [object objectForKey:@"Expiration"];

    return token;
}

OSS相關功能的代碼，可以查看示例程序的實現

該Android示例程序的源碼下載地址

該iOS示例程序的源碼下載地址

應用服務器代碼示例的下載

PHP: 下載地址
Java: 下載地址
Ruby: 下載地址

最後更新：2017-04-01 13:38:49

OSS移動開發實戰1 (30分鍾快速搭建基於OSS的移動應用)

30分鍾快速搭建移動應用直傳服務

背景

目的

架構圖

角色解析

數據流解析

本教程的目的就是，介紹下述紅色和藍色框的內容

效果

示例程序的體驗

示例APP的使用

搭建這樣一個APP上傳和下載的係統，需要準備的東西：

為帳號開通STS服務

講解一下應用服務器的搭建。

應用服務器代碼示例的下載

應用服務器示例的配置

代碼示例的運行方法

體驗自己的APP上傳應用服務器

核心代碼解析-OSS初始化

核心代碼解析-移動應用從應用服務器取Token

OSS相關功能的代碼，可以查看示例程序的實現

應用服務器代碼示例的下載

上一篇：分享 Visualizing MBTA Data

下一篇： nginx內部鎖的實現

相關內容

熱門內容

最新內容

OSS移動開發實戰1 (30分鍾快速搭建基於OSS的移動應用)

30分鍾快速搭建移動應用直傳服務

背景

目的

架構圖

角色解析

數據流解析

本教程的目的就是，介紹下述紅色和藍色框的內容

效果

示例程序的體驗

示例APP的使用

搭建這樣一個APP上傳和下載的係統 ，需要準備的東西：

為帳號開通STS服務

講解一下應用服務器的搭建。

應用服務器代碼示例的下載

應用服務器示例的配置

代碼示例的運行方法

體驗自己的APP上傳應用服務器

核心代碼解析-OSS初始化

核心代碼解析-移動應用從應用服務器取Token

OSS相關功能的代碼，可以查看示例程序的實現

應用服務器代碼示例的下載

上一篇： 分享 Visualizing MBTA Data

下一篇： nginx內部鎖的實現

相關內容

熱門內容

最新內容

搭建這樣一個APP上傳和下載的係統，需要準備的東西：

上一篇：分享 Visualizing MBTA Data