クライアントがネットワーク経由でリソースをダウンロードする際に、ネットワークの変動などの理由でダウンロードが中断されることがあります。この場合、再開可能なダウンロードを実行して、未完了の部分からダウンロードを続行できます。この方法により、時間とトラフィックを節約できます。
注意事項
このトピックのサンプルコードを実行する前に、カスタムドメイン名の使用や Security Token Service (STS) の利用などの方法で OSSClient インスタンスを作成する必要があります。詳細については、「初期化 (Android SDK)」をご参照ください。
例
次のサンプルコードは、再開可能なダウンロードを実行する方法の例です。
// バケット名を指定します。例: examplebucket。
// オブジェクトの完全なパスを指定します。バケット名は含めないでください。例: exampledir/exampleobject.txt。
String objectKey = "exampledir/exampleobject.txt";
// オブジェクトのダウンロード先となるローカルファイルの完全なパスを指定します。
String localFile = "/storage/emulated/0/oss/examplefile.txt";
ResumableDownloadRequest request = new ResumableDownloadRequest(bucketName, objectKey, localFile);
// パートサイズをバイト単位で設定します。デフォルトのパートサイズは 256 KB (256 * 1024 バイト) です。特別な要件がない場合は、このパラメーターを設定する必要はありません。
request.setPartSize(256*1024);
// 再開可能なダウンロードを有効にします。
request.setEnableCheckPoint(true);
// ブレークポイント記録ファイルの完全なパスを設定します。このパラメーターは、前回の中断でブレークポイント記録ファイルが生成された場合にのみ、ダウンロードを再開するために必要です。
request.setCheckPointFilePath("/storage/emulated/0/oss");
request.setProgressListener(new OSSProgressCallback() {
@Override
public void onProgress(Object request, long currentSize, long totalSize) {
Log.d("ResumableDownload", "currentSize: " + currentSize + " totalSize: " + totalSize);
}
});
OSSAsyncTask task = oss.asyncResumableDownload(request, new OSSCompletedCallback<ResumableDownloadRequest, ResumableDownloadResult>() {
@Override
public void onSuccess(ResumableDownloadRequest request, ResumableDownloadResult result) {
Log.d("ResumableDownload", "DownloadSuccess");
}
@Override
public void onFailure(ResumableDownloadRequest request, ClientException clientException, ServiceException serviceException) {
// リクエスト例外。
if (clientException != null) {
// ネットワークエラーなど、クライアント側の例外が発生しました。
clientException.printStackTrace();
}
if (serviceException != null) {
// サーバー側の例外が発生しました。
Log.e("ErrorCode", serviceException.getErrorCode());
Log.e("RequestId", serviceException.getRequestId());
Log.e("HostId", serviceException.getHostId());
Log.e("RawMessage", serviceException.getRawMessage());
}
}
});