IFileDownloader

public interface IFileDownloader

com.android.tradefed.build.IFileDownloader


Interfaz para descargar un archivo remoto.

Resumen

Métodos públicos

default void acquireDownloadPermit()

Si se admite el límite de simultaneidad, toma un permiso de descarga.

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

Es una forma alternativa de downloadFile(String,File) que permite que el llamador descargue una sección del archivo y la guarde en un archivo de destino específico.

abstract void downloadFile(String relativeRemotePath, File destFile)

Es una forma alternativa de downloadFile(String) que permite que la persona que llama especifique el archivo de destino en el que se debe colocar el contenido remoto.

abstract File downloadFile(String remoteFilePath)

Descarga un archivo remoto en un archivo temporal del disco local.

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

Descarga los archivos que coinciden con los filtros proporcionados en un archivo ZIP remoto.

default boolean isFresh(File localFile, String remoteFilePath)

Verifica la actualización del archivo local.

default void releaseDownloadPermit()

Si se admite el límite de simultaneidad, libera un permiso de descarga.

Métodos públicos

acquireDownloadPermit

public void acquireDownloadPermit ()

Si se admite el límite de simultaneidad, toma un permiso de descarga.

downloadFile

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

Es una forma alternativa de downloadFile(String,File) que permite que el llamador descargue una sección del archivo y la guarde en un archivo de destino específico.

Parámetros
remoteFilePath String: Es la ruta de acceso remota al archivo que se descargará, relativa a una raíz específica de la implementación.

destFile File: Es el archivo en el que se colocará el contenido descargado. No debe existir.

startOffset long: Es el desplazamiento de inicio en el archivo remoto.

size long: Es la cantidad de bytes que se descargarán del archivo remoto. Establece un valor negativo para descargar todo el archivo.

Arroja
BuildRetrievalError Si no se pudo descargar el archivo

downloadFile

public abstract void downloadFile (String relativeRemotePath, 
                File destFile)

Es una forma alternativa de downloadFile(String) que permite que la persona que llama especifique el archivo de destino en el que se debe colocar el contenido remoto.

Parámetros
relativeRemotePath String: Es la ruta de acceso remota al archivo que se descargará, relativa a una raíz específica de la implementación.

destFile File: Es el archivo en el que se colocará el contenido descargado. No debe existir.

Arroja
BuildRetrievalError Si no se pudo descargar el archivo

downloadFile

public abstract File downloadFile (String remoteFilePath)

Descarga un archivo remoto en un archivo temporal del disco local.

Parámetros
remoteFilePath String: Es la ruta de acceso remota al archivo que se descargará, relativa a una raíz específica de la implementación.

Muestra
File Es el File descargado local temporal.

Arroja
BuildRetrievalError Si no se pudo descargar el archivo

downloadZippedFiles

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

Descarga los archivos que coinciden con los filtros proporcionados en un archivo ZIP remoto.

Un archivo dentro del archivo ZIP remoto solo se descarga si su ruta de acceso coincide con alguno de los filtros de inclusión, pero no con los de exclusión.

Parámetros
destDir File: Es el archivo en el que se colocará el contenido descargado.

remoteFilePath String: Es la ruta de acceso remota al archivo que se descargará, relativa a una raíz específica de la implementación.

includeFilters List: Es una lista de filtros para descargar los archivos coincidentes.

excludeFilters List: Es una lista de filtros para omitir la descarga de archivos coincidentes.

Arroja
BuildRetrievalError Si no se pudieron descargar los archivos
java.io.IOException
IOException

isFresh

public boolean isFresh (File localFile, 
                String remoteFilePath)

Verifica la actualización del archivo local. Si el archivo local es el mismo que el archivo remoto, está actualizado. De lo contrario, el archivo local está desactualizado. Se usa principalmente para la caché. La implementación predeterminada siempre devolverá verdadero, por lo que, si el archivo es inmutable, nunca será necesario verificar su actualización.

Parámetros
localFile File: Archivo local.

remoteFilePath String: Es la ruta de acceso del archivo remoto.

Muestra
boolean Es verdadero si el archivo local está actualizado; de lo contrario, es falso.

Arroja
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

releaseDownloadPermit

public void releaseDownloadPermit ()

Si se admite el límite de simultaneidad, libera un permiso de descarga.