IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

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

概要

パブリック メソッド

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, List<String> includeFilters, List<String> 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 ダウンロードされた一時的なローカル File。
例外
BuildRetrievalError ファイルをダウンロードできなかった場合

downloadZippedFiles

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

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

リモート zip ファイル内のファイルは、パスが 除外フィルタではなく包含フィルタのいずれかに一致する場合にのみダウンロードされます。

パラメータ
destDir File: ダウンロードしたコンテンツを配置するファイル。
remoteFilePath String: ダウンロードするファイルのリモートパス。実装 固有のルートからの相対パスです。
includeFilters List: 一致するファイルをダウンロードするフィルタのリスト。
excludeFilters List: 一致するファイルのダウンロードをスキップするフィルタのリスト。
例外
BuildRetrievalError ファイルをダウンロードできなかった場合。
java.io.IOException
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 ()

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