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

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