Applies only to Roots
The recovery system is designed to rescue failed bulk downloads, in the event of an unexpected error - such as a fatal crash or other external event.
You should not rely on the recovery system to be 100% reliable, even though it is built to be as close to that as possible.
Recoverable regions are identified internally by an int
ID number. All the methods above make use of this ID number, and so (to ensure continuity) the RootRecovery
object returned is internally a singleton.
This number is generated using the following algorithm, which hopefully ensures a unique number:
API Member | Explanation |
---|---|
recoverableRegions
Get a list of all recoverable regions, not just those that have failed
failedRegions
Get a list of recoverable regions that have failed
getRecoverableRegion()
Get a specific region from the recoverable list
getFailedRegion()
Get a specific region from the failed list
cancel()
Safely cancel/remove a recoverable region