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, 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 ダウンロードできなかった場合は、

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

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

パラメータ
localFile File: ローカル ファイル。

remoteFilePath String: リモート ファイルのパス。

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

例外
BuildRetrievalError

releaseDownloadPermit

public void releaseDownloadPermit ()

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