Cancelling a file upload or download using Java 2 API

tfrysinger

I have implemented a file upload and download capability in my Android app using the example approaches posted on GitHub. However, I need a way to interrupt the process to support the notion of 'cancel' by the user. There doesn't seem to be a way to do this? Once I get this far:

FileMetadata metadata = dbxClient.files().uploadBuilder(uploadPath + "/" + localFile.getName()) 
.withMode(WriteMode.OVERWRITE) 
.withClientModified(new Date(localFile.lastModified())) 
.uploadAndFinish(in, progressListener);

This blocks internally to the API until the upload is complete. I realize I can use the 'limit' setting in a loop like this:

while ((size - uploaded) > CHUNKED_UPLOAD_CHUNK_SIZE)  { 
    dbxClient.files()
   .uploadSessionAppendV2(cursor)
   .uploadAndFinish(in, CHUNKED_UPLOAD_CHUNK_SIZE, progressListener); 
    uploaded += CHUNKED_UPLOAD_CHUNK_SIZE; 
    cursor = new UploadSessionCursor(sessionId, uploaded); 
}

And then check for an interrupted condition prior to initializing 'cursor' again, is this the only way? It means a delay to the user depending on how big "CHUNKED_UPLOAD_CHUNK_SIZE" is, and I'd rather not have to play games optimizing this value on the relatively low chance that the user cancels. I'd rather be able to interrupt the process whenever it needs to be interrupted.

Greg-DB

When using the Dropbox API v2 Java SDK, you can cancel an in-progress upload by using the DbxUploader.abort method. That's available on its sub-classes for various use cases, such as UploadUploader, UploadSessionStartUploader, UploadSessionAppendV2Uploader, and UploadSessionFinishUploader. 

For example, you can get the UploadUploader from upload or UploadBuilder.start (as opposed to directly chaining on uploadAndFinish).

That would look something like this: first, set up and save your uploader:

UploadUploader uploader = dbxClient.files().uploadBuilder(path)
                        .withMode(WriteMode.OVERWRITE)
                        .withClientModified(new Date(localFile.lastModified()))
                        .start();

Then, start the upload (maybe on another thread):

fileMetadata = uploader.uploadAndFinish(in, progressListener);

And if/when you need to cancel that upload:

if (someCondition) {
    uploader.abort();
}

The DbxDownloader class doesn't offer an abort method, but you can use DbxDownloader.getInputStream to get an InputStream so you can more directly control if/when/how much data to read from it. 

Hope this helps!