com.google.android.vending.expansion.downloader.impl

Class DownloaderService

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.app.Service

com.google.android.vending.expansion.downloader.impl.CustomIntentService

com.google.android.vending.expansion.downloader.impl.DownloaderService

All Implemented Interfaces:

android.content.ComponentCallbacks, android.content.ComponentCallbacks2, IDownloaderService

public abstract class DownloaderService
extends CustomIntentService
implements IDownloaderService

Performs the background downloads requested by applications that use the Downloads provider. This service does not run as a foreground task, so Android may kill it off at will, but it will try to restart itself if it can. Note that Android by default will kill off any process that has an open file handle on the shared (SD Card) partition if the partition is unmounted.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DownloaderService.GenerateSaveFileError Exception thrown from methods called by generateSaveFile() for any fatal error.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ACTION_DOWNLOAD_COMPLETE Broadcast intent action sent by the download manager when a download completes.
static String	ACTION_DOWNLOAD_STATUS Broadcast intent action sent by the download manager when download status changes.
static String	ACTION_DOWNLOADS_CHANGED
static int	CONTROL_PAUSED This download must pause at the first opportunity.
static int	CONTROL_RUN This download is allowed to run.
static int	DOWNLOAD_REQUIRED
static String	EXTRA_FILE_NAME
static String	EXTRA_IS_WIFI_REQUIRED For intents used to notify the user that a download exceeds a size threshold, if this extra is true, WiFi is required for this download size; otherwise, it is only recommended.
static String	EXTRA_MESSAGE_HANDLER
static String	EXTRA_PACKAGE_NAME
static String	EXTRA_PENDING_INTENT
static String	EXTRA_STATUS_CURRENT_FILE_SIZE
static String	EXTRA_STATUS_CURRENT_PROGRESS
static String	EXTRA_STATUS_STATE Used with DOWNLOAD_STATUS
static String	EXTRA_STATUS_TOTAL_PROGRESS
static String	EXTRA_STATUS_TOTAL_SIZE
static int	LVL_CHECK_REQUIRED
static int	NETWORK_CANNOT_USE_ROAMING The current connection is roaming, and the download can't proceed over a roaming connection.
static int	NETWORK_MOBILE Bit flag for #setAllowedNetworkTypes corresponding to ConnectivityManager.TYPE_MOBILE.
static int	NETWORK_NO_CONNECTION There is no network connectivity.
static int	NETWORK_OK The network is usable for the given download.
static int	NETWORK_RECOMMENDED_UNUSABLE_DUE_TO_SIZE The download exceeds the recommended maximum size for this network, the user must confirm for this download to proceed without WiFi.
static int	NETWORK_TYPE_DISALLOWED_BY_REQUESTOR The app requesting the download specific that it can't use the current network connection.
static int	NETWORK_UNUSABLE_DUE_TO_SIZE The download exceeds the maximum size for this network.
static int	NETWORK_WIFI Bit flag for #setAllowedNetworkTypes corresponding to ConnectivityManager.TYPE_WIFI.
static int	NO_DOWNLOAD_REQUIRED
static int	STATUS_CANCELED This download was canceled
static int	STATUS_CANNOT_RESUME Some possibly transient error occurred, but we can't resume the download.
static int	STATUS_DEVICE_NOT_FOUND_ERROR This download couldn't be completed because no external storage device was found.
static int	STATUS_FILE_ALREADY_EXISTS_ERROR The requested destination file already exists.
static int	STATUS_FILE_DELIVERED_INCORRECTLY The file was delivered incorrectly
static int	STATUS_FILE_ERROR This download couldn't be completed because of a storage issue.
static int	STATUS_FORBIDDEN The requested URL is no longer available
static int	STATUS_HTTP_DATA_ERROR This download couldn't be completed because of an error receiving or processing data at the HTTP level.
static int	STATUS_HTTP_EXCEPTION This download couldn't be completed because of an HttpException while setting up the request.
static int	STATUS_INSUFFICIENT_SPACE_ERROR This download couldn't be completed due to insufficient storage space.
static int	STATUS_PAUSED_BY_APP This download has been paused by the owning app.
static int	STATUS_PENDING This download hasn't stated yet
static int	STATUS_QUEUED_FOR_WIFI This download is waiting for a Wi-Fi connection to proceed.
static int	STATUS_QUEUED_FOR_WIFI_OR_CELLULAR_PERMISSION This download is waiting for a Wi-Fi connection to proceed or for permission to download over cellular.
static int	STATUS_RUNNING This download has started
static int	STATUS_SUCCESS This download has successfully completed.
static int	STATUS_TOO_MANY_REDIRECTS This download couldn't be completed because there were too many redirects.
static int	STATUS_UNHANDLED_HTTP_CODE This download couldn't be completed because of an unspecified unhandled HTTP code.
static int	STATUS_UNHANDLED_REDIRECT This download couldn't be completed because of an HTTP redirect response that the download manager couldn't handle.
static int	STATUS_UNKNOWN_ERROR This download has completed with an error.
static int	STATUS_WAITING_FOR_NETWORK This download is waiting for network connectivity to proceed.
static int	STATUS_WAITING_TO_RETRY This download encountered some network error and is waiting before retrying the request.
static int	VISIBILITY_HIDDEN This download doesn't show in the UI or in the notifications.
static int	VISIBILITY_VISIBLE This download is visible but only shows in the notifications while it's in progress.
static int	VISIBILITY_VISIBLE_NOTIFY_COMPLETED This download is visible and shows in the notifications while in progress and after completion.

Fields inherited from class android.app.Service

START_CONTINUATION_MASK, START_FLAG_REDELIVERY, START_FLAG_RETRY, START_NOT_STICKY, START_REDELIVER_INTENT, START_STICKY, START_STICKY_COMPATIBILITY

Fields inherited from class android.content.Context

ACCESSIBILITY_SERVICE, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, AUDIO_SERVICE, BIND_ABOVE_CLIENT, BIND_ADJUST_WITH_ACTIVITY, BIND_ALLOW_OOM_MANAGEMENT, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_IMPORTANT, BIND_NOT_FOREGROUND, BIND_WAIVE_PRIORITY, CLIPBOARD_SERVICE, CONNECTIVITY_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, DEVICE_POLICY_SERVICE, DOWNLOAD_SERVICE, DROPBOX_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, KEYGUARD_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MEDIA_ROUTER_SERVICE, MODE_APPEND, MODE_ENABLE_WRITE_AHEAD_LOGGING, MODE_MULTI_PROCESS, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NFC_SERVICE, NOTIFICATION_SERVICE, NSD_SERVICE, POWER_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, STORAGE_SERVICE, TELEPHONY_SERVICE, TEXT_SERVICES_MANAGER_SERVICE, UI_MODE_SERVICE, USB_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_P2P_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Fields inherited from interface com.google.android.vending.expansion.downloader.IDownloaderService

FLAGS_DOWNLOAD_OVER_CELLULAR

Fields inherited from interface android.content.ComponentCallbacks2

TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN

Constructor Summary

Constructors

Constructor and Description
DownloaderService()

Method Summary

Methods

Modifier and Type	Method and Description
String	generateSaveFile(String filename, long filesize) Creates a filename (where the file should be saved) from info about a download.
String	generateTempSaveFileName(String fileName) Returns the filename (where the file should be saved) from info about a download
abstract String	getAlarmReceiverClassName()
int	getControl()
String	getLogMessageForNetworkError(int networkError)
int	getNetworkAvailabilityState(DownloadsDB db)
abstract String	getPublicKey()
abstract byte[]	getSALT()
int	getStatus()
boolean	handleFileUpdated(DownloadsDB db, int index, String filename, long fileSize) The APK has been updated and a filename has been sent down from the Market call.
static boolean	isStatusClientError(int status) Returns whether the status is a client error (i.e.
static boolean	isStatusCompleted(int status) Returns whether the download has completed (either with success or error).
static boolean	isStatusError(int status) Returns whether the status is an error (i.e.
static boolean	isStatusInformational(int status) Returns whether the status is informational (i.e.
static boolean	isStatusServerError(int status) Returns whether the status is a server error (i.e.
static boolean	isStatusSuccess(int status) Returns whether the status is a success (i.e.
boolean	isWiFi()
void	notifyUpdateBytes(long totalBytesSoFar)
android.os.IBinder	onBind(android.content.Intent paramIntent)
void	onClientUpdated(android.os.Messenger clientMessenger) Call this when you get IDownloaderClient.onServiceConnected(Messenger m) from the DownloaderClient to register the client with the service.
void	onCreate()
void	onDestroy()
protected void	onHandleIntent(android.content.Intent intent) This is the main thread for the Downloader.
void	requestAbortDownload() Request that the service abort the current download.
void	requestContinueDownload() Request that the service continue a paused download, when in any paused or failed state, including IDownloaderClient.STATE_PAUSED_BY_REQUEST.
void	requestDownloadStatus() Requests that the download status be sent to the client.
void	requestPauseDownload() Request that the service pause the current download.
void	setDownloadFlags(int flags) Set the flags for this download (e.g.
protected boolean	shouldStop()
static int	startDownloadServiceIfRequired(android.content.Context context, android.content.Intent intent, Class<?> serviceClass)
static int	startDownloadServiceIfRequired(android.content.Context context, android.app.PendingIntent pendingIntent, Class<?> serviceClass)
static int	startDownloadServiceIfRequired(android.content.Context context, android.app.PendingIntent pendingIntent, String classPackage, String className) Starts the download if necessary.
void	updateLVL(android.content.Context context) Updates the LVL information from the server.

Methods inherited from class com.google.android.vending.expansion.downloader.impl.CustomIntentService

onStart, onStartCommand, setIntentRedelivery

Methods inherited from class android.app.Service

dump, getApplication, onConfigurationChanged, onLowMemory, onRebind, onTaskRemoved, onTrimMemory, onUnbind, startForeground, stopForeground, stopSelf, stopSelf, stopSelfResult

Methods inherited from class android.content.ContextWrapper

attachBaseContext, bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkUriPermission, checkUriPermission, clearWallpaper, createPackageContext, databaseList, deleteDatabase, deleteFile, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getAssets, getBaseContext, getCacheDir, getClassLoader, getContentResolver, getDatabasePath, getDir, getExternalCacheDir, getExternalFilesDir, getFilesDir, getFileStreamPath, getMainLooper, getObbDir, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getResources, getSharedPreferences, getSystemService, getTheme, getWallpaper, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, grantUriPermission, isRestricted, openFileInput, openFileOutput, openOrCreateDatabase, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, revokeUriPermission, sendBroadcast, sendBroadcast, sendOrderedBroadcast, sendOrderedBroadcast, sendStickyBroadcast, sendStickyOrderedBroadcast, setTheme, setWallpaper, setWallpaper, startActivities, startActivities, startActivity, startActivity, startInstrumentation, startIntentSender, startIntentSender, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context

getString, getString, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, registerComponentCallbacks, unregisterComponentCallbacks

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NETWORK_OK

public static final int NETWORK_OK

The network is usable for the given download.

See Also:

Constant Field Values

NETWORK_NO_CONNECTION

public static final int NETWORK_NO_CONNECTION

There is no network connectivity.

See Also:

Constant Field Values

NETWORK_UNUSABLE_DUE_TO_SIZE

public static final int NETWORK_UNUSABLE_DUE_TO_SIZE

The download exceeds the maximum size for this network.

See Also:

Constant Field Values

NETWORK_RECOMMENDED_UNUSABLE_DUE_TO_SIZE

public static final int NETWORK_RECOMMENDED_UNUSABLE_DUE_TO_SIZE

The download exceeds the recommended maximum size for this network, the user must confirm for this download to proceed without WiFi.

See Also:

Constant Field Values

NETWORK_CANNOT_USE_ROAMING

public static final int NETWORK_CANNOT_USE_ROAMING

The current connection is roaming, and the download can't proceed over a roaming connection.

See Also:

Constant Field Values

NETWORK_TYPE_DISALLOWED_BY_REQUESTOR

public static final int NETWORK_TYPE_DISALLOWED_BY_REQUESTOR

The app requesting the download specific that it can't use the current network connection.

See Also:

Constant Field Values

EXTRA_IS_WIFI_REQUIRED

public static final String EXTRA_IS_WIFI_REQUIRED

For intents used to notify the user that a download exceeds a size threshold, if this extra is true, WiFi is required for this download size; otherwise, it is only recommended.

See Also:

Constant Field Values

EXTRA_FILE_NAME

public static final String EXTRA_FILE_NAME

See Also:

Constant Field Values

EXTRA_STATUS_STATE

public static final String EXTRA_STATUS_STATE

Used with DOWNLOAD_STATUS

See Also:

Constant Field Values

EXTRA_STATUS_TOTAL_SIZE

public static final String EXTRA_STATUS_TOTAL_SIZE

See Also:

Constant Field Values

EXTRA_STATUS_CURRENT_FILE_SIZE

public static final String EXTRA_STATUS_CURRENT_FILE_SIZE

See Also:

Constant Field Values

EXTRA_STATUS_TOTAL_PROGRESS

public static final String EXTRA_STATUS_TOTAL_PROGRESS

See Also:

Constant Field Values

EXTRA_STATUS_CURRENT_PROGRESS

public static final String EXTRA_STATUS_CURRENT_PROGRESS

See Also:

Constant Field Values

ACTION_DOWNLOADS_CHANGED

public static final String ACTION_DOWNLOADS_CHANGED

See Also:

Constant Field Values

ACTION_DOWNLOAD_COMPLETE

public static final String ACTION_DOWNLOAD_COMPLETE

Broadcast intent action sent by the download manager when a download completes.

See Also:

Constant Field Values

ACTION_DOWNLOAD_STATUS

public static final String ACTION_DOWNLOAD_STATUS

Broadcast intent action sent by the download manager when download status changes.

See Also:

Constant Field Values

STATUS_PENDING

public static final int STATUS_PENDING

This download hasn't stated yet

See Also:

Constant Field Values

STATUS_RUNNING

public static final int STATUS_RUNNING

This download has started

See Also:

Constant Field Values

STATUS_PAUSED_BY_APP

public static final int STATUS_PAUSED_BY_APP

This download has been paused by the owning app.

See Also:

Constant Field Values

STATUS_WAITING_TO_RETRY

public static final int STATUS_WAITING_TO_RETRY

This download encountered some network error and is waiting before retrying the request.

See Also:

Constant Field Values

STATUS_WAITING_FOR_NETWORK

public static final int STATUS_WAITING_FOR_NETWORK

This download is waiting for network connectivity to proceed.

See Also:

Constant Field Values

STATUS_QUEUED_FOR_WIFI_OR_CELLULAR_PERMISSION

public static final int STATUS_QUEUED_FOR_WIFI_OR_CELLULAR_PERMISSION

This download is waiting for a Wi-Fi connection to proceed or for permission to download over cellular.

See Also:

Constant Field Values

STATUS_QUEUED_FOR_WIFI

public static final int STATUS_QUEUED_FOR_WIFI

This download is waiting for a Wi-Fi connection to proceed.

See Also:

Constant Field Values

STATUS_SUCCESS

public static final int STATUS_SUCCESS

This download has successfully completed. Warning: there might be other status values that indicate success in the future. Use isSucccess() to capture the entire category.

See Also:

Constant Field Values

STATUS_FORBIDDEN

public static final int STATUS_FORBIDDEN

The requested URL is no longer available

See Also:

Constant Field Values

STATUS_FILE_DELIVERED_INCORRECTLY

public static final int STATUS_FILE_DELIVERED_INCORRECTLY

The file was delivered incorrectly

See Also:

Constant Field Values

STATUS_FILE_ALREADY_EXISTS_ERROR

public static final int STATUS_FILE_ALREADY_EXISTS_ERROR

The requested destination file already exists.

See Also:

Constant Field Values

STATUS_CANNOT_RESUME

public static final int STATUS_CANNOT_RESUME

Some possibly transient error occurred, but we can't resume the download.

See Also:

Constant Field Values

STATUS_CANCELED

public static final int STATUS_CANCELED

This download was canceled

See Also:

Constant Field Values

STATUS_UNKNOWN_ERROR

public static final int STATUS_UNKNOWN_ERROR

This download has completed with an error. Warning: there will be other status values that indicate errors in the future. Use isStatusError() to capture the entire category.

See Also:

Constant Field Values

STATUS_FILE_ERROR

public static final int STATUS_FILE_ERROR

This download couldn't be completed because of a storage issue. Typically, that's because the filesystem is missing or full. Use the more specific STATUS_INSUFFICIENT_SPACE_ERROR and STATUS_DEVICE_NOT_FOUND_ERROR when appropriate.

See Also:

Constant Field Values

STATUS_UNHANDLED_REDIRECT

public static final int STATUS_UNHANDLED_REDIRECT

This download couldn't be completed because of an HTTP redirect response that the download manager couldn't handle.

See Also:

Constant Field Values

STATUS_UNHANDLED_HTTP_CODE

public static final int STATUS_UNHANDLED_HTTP_CODE

This download couldn't be completed because of an unspecified unhandled HTTP code.

See Also:

Constant Field Values

STATUS_HTTP_DATA_ERROR

public static final int STATUS_HTTP_DATA_ERROR

This download couldn't be completed because of an error receiving or processing data at the HTTP level.

See Also:

Constant Field Values

STATUS_HTTP_EXCEPTION

public static final int STATUS_HTTP_EXCEPTION

This download couldn't be completed because of an HttpException while setting up the request.

See Also:

Constant Field Values

STATUS_TOO_MANY_REDIRECTS

public static final int STATUS_TOO_MANY_REDIRECTS

This download couldn't be completed because there were too many redirects.

See Also:

Constant Field Values

STATUS_INSUFFICIENT_SPACE_ERROR

public static final int STATUS_INSUFFICIENT_SPACE_ERROR

This download couldn't be completed due to insufficient storage space. Typically, this is because the SD card is full.

See Also:

Constant Field Values

STATUS_DEVICE_NOT_FOUND_ERROR

public static final int STATUS_DEVICE_NOT_FOUND_ERROR

This download couldn't be completed because no external storage device was found. Typically, this is because the SD card is not mounted.

See Also:

Constant Field Values

CONTROL_RUN

public static final int CONTROL_RUN

This download is allowed to run.

See Also:

Constant Field Values

CONTROL_PAUSED

public static final int CONTROL_PAUSED

This download must pause at the first opportunity.

See Also:

Constant Field Values

VISIBILITY_VISIBLE

public static final int VISIBILITY_VISIBLE

This download is visible but only shows in the notifications while it's in progress.

See Also:

Constant Field Values

VISIBILITY_VISIBLE_NOTIFY_COMPLETED

public static final int VISIBILITY_VISIBLE_NOTIFY_COMPLETED

This download is visible and shows in the notifications while in progress and after completion.

See Also:

Constant Field Values

VISIBILITY_HIDDEN

public static final int VISIBILITY_HIDDEN

This download doesn't show in the UI or in the notifications.

See Also:

Constant Field Values

NETWORK_MOBILE

public static final int NETWORK_MOBILE

Bit flag for #setAllowedNetworkTypes corresponding to ConnectivityManager.TYPE_MOBILE.

See Also:

Constant Field Values

NETWORK_WIFI

public static final int NETWORK_WIFI

Bit flag for #setAllowedNetworkTypes corresponding to ConnectivityManager.TYPE_WIFI.

See Also:

Constant Field Values

NO_DOWNLOAD_REQUIRED

public static final int NO_DOWNLOAD_REQUIRED

See Also:

Constant Field Values

LVL_CHECK_REQUIRED

public static final int LVL_CHECK_REQUIRED

See Also:

Constant Field Values

DOWNLOAD_REQUIRED

public static final int DOWNLOAD_REQUIRED

See Also:

Constant Field Values

EXTRA_PACKAGE_NAME

public static final String EXTRA_PACKAGE_NAME

See Also:

Constant Field Values

EXTRA_PENDING_INTENT

public static final String EXTRA_PENDING_INTENT

See Also:

Constant Field Values

EXTRA_MESSAGE_HANDLER

public static final String EXTRA_MESSAGE_HANDLER

See Also:

Constant Field Values

Constructor Detail

DownloaderService

public DownloaderService()

Method Detail

isStatusInformational

public static boolean isStatusInformational(int status)

Returns whether the status is informational (i.e. 1xx).

isStatusSuccess

public static boolean isStatusSuccess(int status)

Returns whether the status is a success (i.e. 2xx).

isStatusError

public static boolean isStatusError(int status)

Returns whether the status is an error (i.e. 4xx or 5xx).

isStatusClientError

public static boolean isStatusClientError(int status)

Returns whether the status is a client error (i.e. 4xx).

isStatusServerError

public static boolean isStatusServerError(int status)

Returns whether the status is a server error (i.e. 5xx).

isStatusCompleted

public static boolean isStatusCompleted(int status)

Returns whether the download has completed (either with success or error).

onBind

public android.os.IBinder onBind(android.content.Intent paramIntent)

Overrides:

onBind in class CustomIntentService

isWiFi

public boolean isWiFi()

startDownloadServiceIfRequired

public static int startDownloadServiceIfRequired(android.content.Context context,
                                 android.content.Intent intent,
                                 Class<?> serviceClass)
                                          throws android.content.pm.PackageManager.NameNotFoundException

Throws:

android.content.pm.PackageManager.NameNotFoundException

startDownloadServiceIfRequired

public static int startDownloadServiceIfRequired(android.content.Context context,
                                 android.app.PendingIntent pendingIntent,
                                 Class<?> serviceClass)
                                          throws android.content.pm.PackageManager.NameNotFoundException

Throws:

android.content.pm.PackageManager.NameNotFoundException

startDownloadServiceIfRequired

public static int startDownloadServiceIfRequired(android.content.Context context,
                                 android.app.PendingIntent pendingIntent,
                                 String classPackage,
                                 String className)
                                          throws android.content.pm.PackageManager.NameNotFoundException

Starts the download if necessary. This function starts a flow that does ` many things. 1) Checks to see if the APK version has been checked and the metadata database updated 2) If the APK version does not match, checks the new LVL status to see if a new download is required 3) If the APK version does match, then checks to see if the download(s) have been completed 4) If the downloads have been completed, returns NO_DOWNLOAD_REQUIRED The idea is that this can be called during the startup of an application to quickly ascertain if the application needs to wait to hear about any updated APK expansion files. Note that this does mean that the application MUST be run for the first time with a network connection, even if Market delivers all of the files.

Parameters:

context -

thisIntent -

Returns:

true if the app should wait for more guidance from the downloader, false if the app can continue

Throws:

android.content.pm.PackageManager.NameNotFoundException

requestAbortDownload

public void requestAbortDownload()

Description copied from interface: IDownloaderService

Request that the service abort the current download. The service should respond by changing the state to IDownloaderClient.STATE_ABORTED.

Specified by:

requestAbortDownload in interface IDownloaderService

requestPauseDownload

public void requestPauseDownload()

Description copied from interface: IDownloaderService

Request that the service pause the current download. The service should respond by changing the state to IDownloaderClient.STATE_PAUSED_BY_REQUEST.

Specified by:

requestPauseDownload in interface IDownloaderService

setDownloadFlags

public void setDownloadFlags(int flags)

Description copied from interface: IDownloaderService

Set the flags for this download (e.g. DownloaderService.FLAGS_DOWNLOAD_OVER_CELLULAR).

Specified by:

setDownloadFlags in interface IDownloaderService

requestContinueDownload

public void requestContinueDownload()

Description copied from interface: IDownloaderService

Request that the service continue a paused download, when in any paused or failed state, including IDownloaderClient.STATE_PAUSED_BY_REQUEST.

Specified by:

requestContinueDownload in interface IDownloaderService

getPublicKey

public abstract String getPublicKey()

getSALT

public abstract byte[] getSALT()

getAlarmReceiverClassName

public abstract String getAlarmReceiverClassName()

updateLVL

public void updateLVL(android.content.Context context)

Updates the LVL information from the server.

Parameters:

context -

handleFileUpdated

public boolean handleFileUpdated(DownloadsDB db,
                        int index,
                        String filename,
                        long fileSize)

The APK has been updated and a filename has been sent down from the Market call. If the file has the same name as the previous file, we do nothing as the file is guaranteed to be the same. If the file does not have the same name, we download it if it hasn't already been delivered by Market.

Parameters:

index - the index of the file from market (0 = main, 1 = patch)

filename - the name of the new file

fileSize - the size of the new file

Returns:

onHandleIntent

protected void onHandleIntent(android.content.Intent intent)

This is the main thread for the Downloader. This thread is responsible for queuing up downloads and other goodness.

Specified by:

onHandleIntent in class CustomIntentService

onDestroy

public void onDestroy()

Overrides:

onDestroy in class CustomIntentService

getNetworkAvailabilityState

public int getNetworkAvailabilityState(DownloadsDB db)

onCreate

public void onCreate()

Overrides:

onCreate in class CustomIntentService

generateTempSaveFileName

public String generateTempSaveFileName(String fileName)

Returns the filename (where the file should be saved) from info about a download

generateSaveFile

public String generateSaveFile(String filename,
                      long filesize)
                        throws DownloaderService.GenerateSaveFileError

Creates a filename (where the file should be saved) from info about a download.

Throws:

DownloaderService.GenerateSaveFileError

getLogMessageForNetworkError

public String getLogMessageForNetworkError(int networkError)

Returns:

a non-localized string appropriate for logging corresponding to one of the NETWORK_* constants.

getControl

public int getControl()

getStatus

public int getStatus()

notifyUpdateBytes

public void notifyUpdateBytes(long totalBytesSoFar)

shouldStop

protected boolean shouldStop()

Specified by:

shouldStop in class CustomIntentService

requestDownloadStatus

public void requestDownloadStatus()

Description copied from interface: IDownloaderService

Requests that the download status be sent to the client.

Specified by:

requestDownloadStatus in interface IDownloaderService

onClientUpdated

public void onClientUpdated(android.os.Messenger clientMessenger)

Description copied from interface: IDownloaderService

Call this when you get IDownloaderClient.onServiceConnected(Messenger m) from the DownloaderClient to register the client with the service. It will automatically send the current status to the client.

Specified by:

onClientUpdated in interface IDownloaderService