to top
Android APIs
public abstract class

RestoreObserver

extends Object
java.lang.Object
   ↳ android.app.backup.RestoreObserver

Class Overview

Callback class for receiving progress reports during a restore operation. These methods will all be called on your application's main thread.

Summary

Public Constructors
RestoreObserver()
Public Methods
void onUpdate(int nowBeingRestored, String currentPackage)
An indication of which package is being restored currently, out of the total number provided in the restoreStarting(int) callback.
void restoreFinished(int error)
The restore process has completed.
void restoreStarting(int numPackages)
The restore operation has begun.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public RestoreObserver ()

Added in API level 8

Public Methods

public void onUpdate (int nowBeingRestored, String currentPackage)

Added in API level 8

An indication of which package is being restored currently, out of the total number provided in the restoreStarting(int) callback. This method is not guaranteed to be called: if the transport is unable to obtain data for one or more of the requested packages, no onUpdate() call will occur for those packages.

Parameters
nowBeingRestored The index, between 1 and the numPackages parameter to the restoreStarting(int) callback, of the package now being restored. This may be non-monotonic; it is intended purely as a rough indication of the backup manager's progress through the overall restore process.
currentPackage The name of the package now being restored.

public void restoreFinished (int error)

Added in API level 8

The restore process has completed. This method will always be called, even if no individual package restore operations were attempted.

Parameters
error Zero on success; a nonzero error code if the restore operation as a whole failed.

public void restoreStarting (int numPackages)

Added in API level 8

The restore operation has begun.

Parameters
numPackages The total number of packages being processed in this restore operation.