Creates a new DownloadStream, allowing a file to be downloaded from a GData service using standard InputStream API.
As well as the standard GIO errors, calls to the InputStream API on a DownloadStream can also return any relevant specific error from ServiceError, or PROTOCOL_ERROR in the general case.
If a Cancellable is provided in cancellable
, the download operation may be cancelled at any time
from another thread using cancel. In this case, any ongoing network activity will be stopped, and any pending
or future calls to InputStream API on the
DownloadStream will return CANCELLED. Note that the Cancellable objects
which can be passed to individual InputStream operations will not cancel the download operation proper
if cancelled — they will merely cancel that API call. The only way to cancel the download operation completely is using this
cancellable
.
service |
a Service |
domain |
the AuthorizationDomain to authorize the download, or |
download_uri |
the URI to download; this must be HTTPS |
cancellable |
a Cancellable for the entire download stream, or |
a new InputStream, or |