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) downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters) downloadZippedFiles (File destDir, String remoteFilePath, includeFilters, excludeFilters)

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

default boolean isFresh (File localFile, String remoteFilePath)

ローカル ファイルの鮮度を確認します。

default void releaseDownloadPermit ()

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

公開メソッド

取得ダウンロード許可

public void acquireDownloadPermit ()

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

ダウンロードファイル

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

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

パラメーター
remoteFilePath String : ダウンロードするファイルへのリモート パス (実装固有のルートを基準とする)。

destFile File : ダウンロードしたコンテンツを配置するファイル。存在すべきではありません。

startOffset long : リモート ファイルの開始オフセット。

size long : リモート ファイルからダウンロードするバイト数。ファイル全体をダウンロードするには、負の値に設定します。

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

ダウンロードファイル

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

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

パラメーター
relativeRemotePath String : ダウンロードするファイルへのリモート パス (実装固有のルートを基準とする)。

destFile File : ダウンロードしたコンテンツを配置するファイル。存在すべきではありません。

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

ダウンロードファイル

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ファイルをダウンロードできなかった場合。
IO例外

新鮮です

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 ()

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