IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

מחלקות משנה לא ישירות מוכרות ‫AndroidBuildDownloader, ‏ CasFileDownloader, ‏ FileDownloadCacheWrapper, ‏ GCSFileDownloader AndroidBuildDownloader IFileDownloader שמחלץ קבצים מ-Android Build API.  CasFileDownloader כלי להורדת קבצים כדי להוריד קבצים מ-RBE CAS.  FileDownloadCacheWrapper מחלקה עוטפת שמספקת מתקני FileDownloadCache תוך הטמעה של הממשק IFileDownloader.  GCSFileDownloader כלי להורדת קבצים מ-Google Cloud Storage‏ (GCS).

---

ממשק להורדת קובץ מרוחק.

סיכום

‫methods ציבוריים
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() אם יש תמיכה במגבלת מקבילות, צריך לבטל את הרשאת ההורדה.

‫methods ציבוריים

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: מספר הבייטים להורדה מהקובץ המרוחק. מגדירים ערך שלילי כדי להוריד את הקובץ כולו.

הקפצת הודעות שגיאה (throw)
BuildRetrievalError	אם אי אפשר להוריד את הקובץ

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

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

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

הקפצת הודעות שגיאה (throw)
BuildRetrievalError	אם אי אפשר להוריד את הקובץ

downloadFile

public abstract File downloadFile (String remoteFilePath)

מוריד קובץ מרוחק לקובץ זמני בדיסק המקומי.

פרמטרים
remoteFilePath	‫String: הנתיב המרוחק לקובץ להורדה, ביחס לשורש ספציפי להטמעה.

החזרות
File	הקובץ הזמני שהורד File.

הקפצת הודעות שגיאה (throw)
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: רשימת מסננים לדילוג על הורדת קבצים תואמים.

הקפצת הודעות שגיאה (throw)
BuildRetrievalError	אם אי אפשר להוריד קבצים.
	java.io.IOException
IOException

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

בודקים את רמת העדכניות של הקובץ המקומי. אם הקובץ המקומי זהה לקובץ המרוחק, הוא עדכני. אם לא, הקובץ המקומי לא עדכני. הוא משמש בעיקר למטמון. ההטמעה שמוגדרת כברירת מחדל תמיד תחזיר את הערך True, כך שאם הקובץ הוא בלתי ניתן לשינוי, לא תהיה צורך לבדוק את הטריות שלו.

פרמטרים
localFile	‫File: קובץ מקומי.
remoteFilePath	‫String: הנתיב של הקובץ המרוחק.

החזרות
boolean	‫True אם הקובץ המקומי חדש, אחרת False.

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

releaseDownloadPermit

public void releaseDownloadPermit ()

אם יש תמיכה במגבלת מקבילות, צריך לבטל את אישור ההורדה.