オブジェクトのダウンロード

# オブジェクトのダウンロード

このSDKメソッドを使用すると、オブジェクトをダウンロードできます。操作は入力ストリームを返します。

**使用パラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
      <th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
    <tr>
      <td>{{%badge%}}pathToDownload{{%/badge%}}</td>
      <td>{{%bold%}}String{{%/bold%}}</td>
      <td>{{%bold%}}必須{{%/bold%}}パラメータ。オブジェクトをダウンロードする必要がある{{%link href="/ja/cloud-scale/help/stratus/objects/introduction/#path" %}}パス{{%/link%}}を保持します。</td>
    </tr>
    <tr>
      <td>{{%badge%}}newObjectName{{%/badge%}}</td>
      <td>{{%bold%}}String{{%/bold%}}</td>
      <td>{{%bold%}}任意{{%/bold%}}パラメータ。ダウンロード時に指定するオブジェクトの名前を保持します。この値を指定しない場合、オブジェクトは元の名前でダウンロードされます。</td>
    </tr>
		<tr>
			<td>{{%badge%}}versionId{{%/badge%}}</td>
      <td>{{%bold%}}String{{%/bold%}}</td>
			<td>{{%bold%}}任意{{%/bold%}}パラメータ。バケットで{{%link href="/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning" %}}バージョニング{{%/link%}}が有効になっている場合、必要なオブジェクトのバージョンの一意のバージョンIDを保持します。</td>
		</tr>
    <tr>
			<td>{{%badge%}}fromCache{{%/badge%}}</td>
      <td>{{%bold%}}Boolean{{%/bold%}}</td>
			<td>
        <ul>
          <li>{{%bold%}}任意{{%/bold%}}パラメータ。このファイルをキャッシュから取得するかどうかを指定するために使用します。</li>
          <li>{{%bold%}}デフォルト値{{%/bold%}}: false。</li>
        </ul>
      </td>
		</tr>
    <tr>
			<td>{{%badge%}}progress{{%/badge%}}</td>
      <td>{{%bold%}}Function(int, int, Double)?{{%/bold%}}</td>
			<td>オブジェクトのダウンロードの進捗情報を提供するコールバック関数</td>
		</tr>
	</tbody>
</table>

{{%code class="language-javascript"%}}try {
    ZCatalystBucket bucket = stratus.bucket("testing");
    var (response, object) = await bucket.getObject("SunSet.jpeg");
    final downloadsDir = await getExternalStorageDirectory();
    final filePath = downloadsDir!.absolute.path;
    var fileResponse = await object.download(
        pathToDownload: filePath,
        onProgress: (bytesWritten, contentLength, percentage) {
            print("Downloaded Percentage: $percentage");
        },
    );
    print("Download Status: ${fileResponse.statusCode}");
    OpenFile.open(filePath + '/SunSet.jpeg');
}
on ZCatalystException catch (ex) {
    print(ex.toString());
}{{%/code%}}

このSDKメソッドを使用すると、オブジェクトをダウンロードできます。操作は入力ストリームを返します。

使用パラメータ

パラメータ名	データ型	定義
pathToDownload	String	必須パラメータ。オブジェクトをダウンロードする必要があるパスを保持します。
newObjectName	String	任意パラメータ。ダウンロード時に指定するオブジェクトの名前を保持します。この値を指定しない場合、オブジェクトは元の名前でダウンロードされます。
versionId	String	任意パラメータ。バケットでバージョニングが有効になっている場合、必要なオブジェクトのバージョンの一意のバージョンIDを保持します。
fromCache	Boolean	任意パラメータ。このファイルをキャッシュから取得するかどうかを指定するために使用します。デフォルト値: false。
progress	Function(int, int, Double)?	オブジェクトのダウンロードの進捗情報を提供するコールバック関数

copy

         try {
    ZCatalystBucket bucket = stratus.bucket("testing");
    var (response, object) = await bucket.getObject("SunSet.jpeg");
    final downloadsDir = await getExternalStorageDirectory();
    final filePath = downloadsDir!.absolute.path;
    var fileResponse = await object.download(
        pathToDownload: filePath,
        onProgress: (bytesWritten, contentLength, percentage) {
            print("Downloaded Percentage: $percentage");
        },
    );
    print("Download Status: ${fileResponse.statusCode}");
    OpenFile.open(filePath + '/SunSet.jpeg');
}
on ZCatalystException catch (ex) {
    print(ex.toString());
}
    

最終更新日 2026-02-23 18:09:41 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Stratus Component Help Documentation Download an Object Java SDK Node.js SDK Python SDK Web SDK iOS SDK Android SDK REST API