すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:進捗バー

最終更新日:Dec 19, 2023

進行状況バーを使用して、オブジェクトのアップロードまたはダウンロードの進行状況を示すことができます。 このトピックでは、ダウンロードタスクの進行状況を照会する方法について説明します。

使用上の注意

  • このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba Cloudサービスを使用してOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSでサポートされているリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

  • このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSecurity Token Service (STS) を使用してOSSClientインスタンスを作成する場合は、「OSSClientインスタンスの作成」をご参照ください。

サンプルコード

次のサンプルコードは、ダウンロードの進行状況を照会する方法の例を示しています。

#include <alibabacloud/oss/OssClient.h>
名前空間listaCloud::OSSを使用します。void ProgressCallback(size_t increment, int64_t transfered, int64_t total, void * userData)
{
    // incrementは、このコールバックから受信したデータのサイズを指定します。 
    // transferedは、ダウンロードしたデータのサイズを指定します。 
    // totalは、ダウンロードするオブジェクトの合計サイズを指定します。 
    std::cout << "ProgressCallback[" << userData << "] => " <<
                 increment <<"、" << transfered <<"、" << total << std::endl;
}

int main(void)
{
    /* OSSへのアクセスに使用されるアカウントに関する情報を初期化します。 */
            
    /* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 */
    std::stringエンドポイント="https://oss-cn-hangzhou.aliyuncs.com";
    /* バケットの名前を指定します。 例: examplebucket. */
    std::string BucketName = "examplebucket";
    /* オブジェクトのフルパスを指定します。 オブジェクトのフルパスにバケット名を含めないでください。 例: exampledir/exampleobject.txt。 */
    std::string ObjectName = "exampledir/exampleobject.txt";

    /* ネットワークリソースなどのリソースを初期化します。 */
    InitializeSdk();

    ClientConfiguration conf;
    /* 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClientクライアント (Endpoint, credentialsProvider, conf);
  
    /* オブジェクトを照会します。 */
    GetObjectRequestリクエスト (BucketName, ObjectName);
    TransferProgress progressCallback = { ProgressCallback , nullptr };
    request.setTransferProgress(progressCallback);

    auto outcome = client.GetObject (リクエスト);

    if (!outcome.isSuccess()) {    
        /* 例外を処理します。 */
        std::cout << "getObject fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
         return -1;  
    }

    /* ネットワークリソースなどのリソースを解放します。 */
    ShutdownSdk();
    0を返します。} 

参考資料

オブジェクトのダウンロード中にプログレスバーを使用する方法の完全なサンプルコードについては、GitHubをご覧ください。