com.android.repository.api

Interface Downloader

All Known Implementing Classes:

FakeDownloader, LocalFileAwareDownloader

public interface Downloader

Implementations provide a general mechanism for downloading files.

Method Summary

Modifier and Type	Method and Description
java.io.InputStream	downloadAndStream(java.net.URL url, ProgressIndicator indicator) Gets a stream associated with the content at the given URL.
void	downloadFully(java.net.URL url, java.io.File target, java.lang.String checksum, ProgressIndicator indicator) Downloads the content at the given URL to the given file.
java.io.File	downloadFully(java.net.URL url, ProgressIndicator indicator) Downloads the content at the given URL to a temporary file and returns a handle to that file.
static java.lang.String	hash(java.io.InputStream in, long fileSize, ProgressIndicator progress) Hash the given input stream.

Method Detail

downloadAndStream

@Nullable
java.io.InputStream downloadAndStream(@NonNull
                                                java.net.URL url,
                                                @NonNull
                                                ProgressIndicator indicator)
                                         throws java.io.IOException

Gets a stream associated with the content at the given URL. This could be achieved by downloading the file completely, streaming it directly, or some combination.

Parameters:

url - The URL to fetch.

indicator - Facility for showing download progress and logging.

Returns:

An InputStream corresponding to the specified content, or null if the download is cancelled.

Throws:

java.io.IOException

downloadFully

@Nullable
java.io.File downloadFully(@NonNull
                                     java.net.URL url,
                                     @NonNull
                                     ProgressIndicator indicator)
                              throws java.io.IOException

Downloads the content at the given URL to a temporary file and returns a handle to that file.

Parameters:

url - The URL to fetch.

indicator - Facility for showing download progress and logging.

Returns:

The temporary file, or null if the download is cancelled.

Throws:

java.io.IOException

downloadFully

void downloadFully(@NonNull
                   java.net.URL url,
                   @NonNull
                   java.io.File target,
                   @Nullable
                   java.lang.String checksum,
                   @NonNull
                   ProgressIndicator indicator)
            throws java.io.IOException

Downloads the content at the given URL to the given file.

Parameters:

url - The URL to fetch.

target - The location to download to.

checksum - If specified, first check target to see if the given checksum matches the existing file. If so, returns immediately.

indicator - Facility for showing download progress and logging.

Throws:

java.io.IOException

hash

@NonNull
static java.lang.String hash(@NonNull
                                      java.io.InputStream in,
                                      long fileSize,
                                      @NonNull
                                      ProgressIndicator progress)
                               throws java.io.IOException

Hash the given input stream.

Parameters:

in - The stream to hash. It will be fully consumed but not closed.

fileSize - The expected length of the stream, for progress display purposes.

progress - The indicator will be updated with the expected completion fraction.

Returns:

The sha1 hash of the input stream.

Throws:

java.io.IOException - IF there's a problem reading from the stream.