آی‌فایل‌دانلودر

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, List<String> includeFilters, List<String> excludeFilters)

فایل‌های مطابق با فیلترهای داده شده را در یک فایل زیپ از راه دور دانلود کنید.

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 File دانلود شده‌ی موقت محلی.

پرتاب‌ها
BuildRetrievalError اگر فایل دانلود نشد

دانلودفایل‌های زیپ‌شده 

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

فایل‌های مطابق با فیلترهای داده شده را در یک فایل زیپ از راه دور دانلود کنید.

یک فایل درون فایل زیپِ راه دور فقط تا جایی دانلود می‌شود که مسیرش با هر یک از فیلترهای شامل شدن مطابقت داشته باشد، اما با فیلترهای حذف شدن مطابقت نداشته باشد.

پارامترها
destDir File : فایلی که محتوای دانلود شده در آن قرار می‌گیرد.

remoteFilePath String : مسیر راه دور فایل برای دانلود، نسبت به یک ریشه خاص پیاده‌سازی.

includeFilters List : فهرستی از فیلترها برای دانلود فایل‌های منطبق.

excludeFilters List : فهرستی از فیلترها برای صرف نظر کردن از دانلود فایل‌های منطبق.

پرتاب‌ها
BuildRetrievalError اگر فایل‌ها دانلود نشدند.
استثنای java.io.IO
IOException

تازه 

public boolean isFresh (File localFile, 
                String remoteFilePath)

تازگی فایل محلی را بررسی کنید. اگر فایل محلی با فایل راه دور یکسان باشد، تازه است. در غیر این صورت، فایل محلی قدیمی است. این عمدتاً برای حافظه پنهان استفاده می‌شود. پیاده‌سازی پیش‌فرض همیشه مقدار درست را برمی‌گرداند، بنابراین اگر فایل تغییرناپذیر باشد، هرگز نیازی به بررسی تازگی آن نخواهد بود.

پارامترها
localFile File : فایل محلی

remoteFilePath String : مسیر فایل راه دور.

بازگشت‌ها
boolean اگر فایل محلی تازه باشد، درست و در غیر این صورت نادرست است.

پرتاب‌ها
خطای بازیابی ساخت در com.android.tradefed.build.Build
BuildRetrievalError

دانلود و انتشار مجوز 

public void releaseDownloadPermit ()

اگر محدودیت همزمانی پشتیبانی می‌شود، مجوز دانلود را صادر کنید.