IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader

คลาสย่อยโดยอ้อมที่ทราบ FileDownloadCacheWrapper, GCSFileDownloader FileDownloadCacheWrapper คลาส Wrapper ที่ให้สิ่งอำนวยความสะดวก 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	if file could not be downloaded

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

รูปแบบอื่นของ downloadFile(String) ซึ่งช่วยให้ผู้เรียกใช้ระบุไฟล์ปลายทางที่จะวางเนื้อหาระยะไกลได้

พารามิเตอร์
relativeRemotePath	String: เส้นทางระยะไกลไปยังไฟล์ที่จะดาวน์โหลด โดยสัมพันธ์กับรูทเฉพาะการติดตั้งใช้งาน
destFile	File: ไฟล์ที่จะวางเนื้อหาที่ดาวน์โหลด ไม่ควรมี

การโยน
BuildRetrievalError	if file could not be downloaded

downloadFile

public abstract File downloadFile (String remoteFilePath)

ดาวน์โหลดไฟล์ระยะไกลไปยังไฟล์ชั่วคราวในดิสก์ในเครื่อง

พารามิเตอร์
remoteFilePath	String: เส้นทางระยะไกลไปยังไฟล์ที่จะดาวน์โหลด โดยสัมพันธ์กับรูทที่เจาะจงของการใช้งาน

คิกรีเทิร์น
File	ERROR(/File) ที่ดาวน์โหลดไว้ชั่วคราวในเครื่อง

การโยน
BuildRetrievalError	if file could not be downloaded

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)

ตรวจสอบความใหม่ของไฟล์ในเครื่อง หากไฟล์ในเครื่องเหมือนกับไฟล์ระยะไกล แสดงว่าไฟล์เป็นเวอร์ชันล่าสุด หากไม่เป็นเช่นนั้น แสดงว่าไฟล์ในเครื่องล้าสมัย ซึ่งใช้สำหรับแคชเป็นหลัก การใช้งานเริ่มต้นจะแสดงผลลัพธ์เป็น "จริง" เสมอ ดังนั้นหากไฟล์เป็นแบบคงที่ ก็จะไม่จําเป็นต้องตรวจสอบความใหม่

พารามิเตอร์
localFile	File: ไฟล์ในเครื่อง
remoteFilePath	String: เส้นทางไฟล์ระยะไกล

คิกรีเทิร์น
boolean	จริงหากไฟล์ในเครื่องเป็นไฟล์ล่าสุด หรือเป็นเท็จ

การโยน
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

releaseDownloadPermit

public void releaseDownloadPermit ()

หากรองรับขีดจำกัดการเรียกใช้พร้อมกัน ให้ปล่อยใบอนุญาตการดาวน์โหลด