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

אם יש תמיכה במגבלת בו-זמניות, משחררים את היתר ההורדה.

שיטות ציבוריות

רכישותDownloadPermit

public void acquireDownloadPermit ()

אם יש תמיכה במגבלת בו-זמניות, משתמשים באישור להורדה.

הורדת הקובץ

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

צורה חלופית של downloadFile(String, File), שמאפשרת לקורא להוריד בקטע של הקובץ ולשמור אותו בקובץ יעד ספציפי.

פרמטרים
remoteFilePath String: הנתיב המרוחק אל הקובץ להורדה, ביחס הרמה הבסיסית (root) הספציפית להטמעה.
destFile File: הקובץ שבו יש למקם את התוכן שהורדתם. לא אמור להיות קיים.
startOffset long: היסט ההתחלה בקובץ המרוחק.
size long: מספר הבייטים להורדה מהקובץ המרוחק. צריך להגדיר אותו לערך שלילי כדי להוריד את הקובץ כולו.
קליעות
BuildRetrievalError אם לא ניתן להוריד את הקובץ

הורדת הקובץ

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

צורה חלופית של downloadFile(String), שמאפשרת לקורא לציין את קובץ יעד, שבו יש למקם את התוכן המרוחק.

פרמטרים
relativeRemotePath String: הנתיב המרוחק אל הקובץ להורדה, ביחס הרמה הבסיסית (root) הספציפית להטמעה.
destFile File: הקובץ שבו יש למקם את התוכן שהורדתם. לא אמור להיות קיים.
קליעות
BuildRetrievalError אם לא ניתן להוריד את הקובץ

הורדת הקובץ

public abstract File downloadFile (String remoteFilePath)

הורדת קובץ מרוחק לקובץ זמני בכונן המקומי.

פרמטרים
remoteFilePath String: הנתיב המרוחק אל הקובץ להורדה, ביחס להטמעה שורש ספציפי.
החזרות
File קובץ מקומי זמני שירד ERROR(/File).
קליעות
BuildRetrievalError אם לא ניתן להוריד את הקובץ

הורדה ZippedFiles

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

יש להוריד את הקבצים שתואמים למסננים הנתונים בקובץ ZIP מרוחק.

מתבצעת הורדה של קובץ בתוך קובץ ה-ZIP המרוחק רק לנתיב שלו תואם לאחד או יותר לכלול מסננים אך לא את מסנני ההחרגה.

פרמטרים
destDir File: הקובץ שבו יש למקם את התוכן שהורדתם.
remoteFilePath String: הנתיב המרוחק אל הקובץ להורדה, ביחס להטמעה שורש ספציפי.
includeFilters : רשימת מסננים להורדת קבצים תואמים.
excludeFilters : רשימת מסננים לדילוג על הורדת קבצים תואמים.
קליעות
BuildRetrievalError אם לא ניתן להוריד את הקבצים.
חריגת IO

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

אם יש תמיכה במגבלת בו-זמניות, משחררים את היתר ההורדה.