全部產品
Search
文件中心

Object Storage Service:iOS範圍下載

更新時間:Aug 23, 2024

如果僅需要檔案中的部分資料,您可以使用範圍下載,下載指定範圍內的資料。

注意事項

  • 使用本文樣本前您需要先通過自訂網域名、STS等方式建立OSSClient,具體請參見初始化

    說明

    所建立儲存空間的所屬地區取決於初始化配置的endpoint地區資訊。

  • 要下載檔案,您必須有ossGetObject許可權。具體操作,請參見為RAM使用者授權自訂的權限原則

範圍下載適用於下載較大的Object。如果在要求標頭中使用Range參數,則返回訊息中會包含整個檔案的長度和此次返回的範圍。

範例程式碼

以下代碼用於範圍下載:

OSSGetObjectRequest * request = [OSSGetObjectRequest new];
// 填寫Bucket名稱,例如examplebucket。
request.bucketName = @"examplebucket";
// 填寫不包含Bucket名稱在內的Object完整路徑,例如exampledir/exampleobject.txt。
request.objectKey = @"exampledir/exampleobject.txt";
request.range = [[OSSRange alloc] initWithStart:1 withEnd:99]; // bytes=1-99
// request.range = [[OSSRange alloc] initWithStart:-1 withEnd:99]; // bytes=-99
// request.range = [[OSSRange alloc] initWithStart:10 withEnd:-1]; // bytes=10-
request.downloadProgress = ^(int64_t bytesWritten, int64_t totalBytesWritten, int64_t totalBytesExpectedToWrite) {
    NSLog(@"%lld, %lld, %lld", bytesWritten, totalBytesWritten, totalBytesExpectedToWrite);
};
OSSTask * getTask = [client getObject:request];
[getTask continueWithBlock:^id(OSSTask *task) {
    if (!task.error) {
        NSLog(@"download object success!");
        OSSGetObjectResult * getResult = task.result;
        NSLog(@"download result: %@", getResult.downloadedData);
    } else {
        NSLog(@"download object failed, error: %@" ,task.error);
    }
    return nil;
}];
// [getTask waitUntilFinished];
// [request cancel];

相關文檔