IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

既知の間接的なサブクラス FileDownloadCacheWrapper、GCSFileDownloader FileDownloadCacheWrapper 実装時に FileDownloadCache 機能を提供するラッパークラス IFileDownloader インターフェース。  GCSFileDownloader Google Cloud Storage（GCS）からファイルをダウンロードするためのファイル ダウンローダー。

---

リモート ファイルをダウンロードするためのインターフェース。

概要

パブリック メソッド
default void	acquireDownloadPermit() 同時実行の制限がサポートされている場合は、ダウンロード許可を取得します。
default void	downloadFile(String remoteFilePath, File destFile, long startOffset, long size) 呼び出し元がダウンロードできる downloadFile(String, File) の代替形式 セクションを作成し、特定の宛先ファイルに保存します。
abstract void	downloadFile(String relativeRemotePath, File destFile) downloadFile(String) の代替形式で、呼び出し元が リモート コンテンツを格納する宛先ファイルを指定します。
abstract File	downloadFile(String remoteFilePath) リモート ファイルをローカル ディスク上の一時ファイルにダウンロードします。
default void	downloadZippedFiles(File destDir, String remoteFilePath, includeFilters, excludeFilters) 指定されたフィルタに一致するファイルをリモート zip ファイルにダウンロードします。
default boolean	isFresh(File localFile, String remoteFilePath) ローカル ファイルの更新頻度を確認します。
default void	releaseDownloadPermit() 同時実行の制限がサポートされている場合は、ダウンロード許可を解除します。

パブリック メソッド

acquireDownloadPermit

public void acquireDownloadPermit ()

同時実行の制限がサポートされている場合は、ダウンロード許可を取得します。

downloadFile

public void downloadFile (String remoteFilePath, 
                File destFile, 
                long startOffset, 
                long size)

呼び出し元がダウンロードできる downloadFile(String, File) の代替形式 セクションを作成し、特定の宛先ファイルに保存します。

パラメータ
remoteFilePath	String: ダウンロードするファイルのリモートパス（ 固有のルートです。
destFile	File: ダウンロードしたコンテンツを配置するファイル。存在すべきではありません。
startOffset	long: リモート ファイルの開始オフセット。
size	long: リモート ファイルからダウンロードするバイト数。負の値に設定 ファイル全体をダウンロードします。

例外
BuildRetrievalError	ファイルをダウンロードできなかった場合

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

downloadFile(String) の代替形式で、呼び出し元が リモート コンテンツを格納する宛先ファイルを指定します。

パラメータ
relativeRemotePath	String: ダウンロードするファイルのリモートパス（ 固有のルートです。
destFile	File: ダウンロードしたコンテンツを配置するファイル。存在すべきではありません。

例外
BuildRetrievalError	ファイルをダウンロードできなかった場合

downloadFile

public abstract File downloadFile (String remoteFilePath)

リモート ファイルをローカル ディスク上の一時ファイルにダウンロードします。

パラメータ
remoteFilePath	String: ダウンロードするファイルのリモートパス（実装を基準とする） あります。

戻り値
File	一時的なローカルにダウンロードされた ERROR(/File)。

例外
BuildRetrievalError	ファイルをダウンロードできなかった場合

downloadZippedFiles

public void downloadZippedFiles (File destDir, 
                String remoteFilePath, 
                 includeFilters, 
                 excludeFilters)

指定されたフィルタに一致するファイルをリモート zip ファイルにダウンロードします。

リモート zip ファイル内のファイルは、 一致フィルタは除外されますが、除外フィルタは含まれません。

パラメータ
destDir	File: ダウンロードしたコンテンツを配置するファイル。
remoteFilePath	String: ダウンロードするファイルのリモートパス（実装に対する相対パス） あります。
includeFilters	: 一致するファイルをダウンロードするフィルタのリスト。
excludeFilters	: 一致するファイルのダウンロードをスキップするフィルタのリスト。

例外
BuildRetrievalError	ダウンロードできなかった場合は、
	IOException

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

ローカル ファイルの更新頻度を確認します。ローカル ファイルがリモート ファイルと同じ場合は、最新です。条件 ローカル ファイルが古くなっています。主にキャッシュに使用されます。デフォルトの実装では 常に true を返すため、ファイルが不変の場合、鮮度をチェックする必要はありません。

パラメータ
localFile	File: ローカル ファイル。
remoteFilePath	String: リモート ファイルのパス。

戻り値
boolean	ローカル ファイルが新しい場合は true、それ以外の場合は false。

例外
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

releaseDownloadPermit

public void releaseDownloadPermit ()

同時実行の制限がサポートされている場合は、ダウンロード許可を解除します。