Cancelling a file upload or download using Java 2 API

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! 

Hi - that helps a lot on the upload area.

For the download, I'm not sure I follow how getting a reference to the InputStream helps here. I suppose if I could read from it in "chunks" similar to upload, I could check every "chunk" to see if a cancel had been indicated, but I'm not sure how to do that.

Do you have a small code example to share?

Thanks!

Is something like this appropriate?

                DbxDownloader<FileMetadata> downloader = dbxClient.files().downloadBuilder(dropboxPath + "/" + localFile)
                        .start();
                InputStream inputStream = downloader.getInputStream();
                int count;
                long bytesWritten = 0;
                boolean keepGoin = true;
                byte data[] = new byte[WRITE_BUFFER];
                while ( keepGoin && ((count = inputStream.read(data, 0, WRITE_BUFFER)) != -1)) {
                    outputStream.write(data, 0, count);
                    bytesWritten += count;
                    progressListener.onProgress(bytesWritten);
                    if ( listener != null ) {
                        keepGoin = listener.cancelFileOperation();
                    }
                }
                if ( bytesWritten != size) {
                    // Means we were interrupted
                    throw new UserCancelException(InTouch.getInstance().getString(R.string.interrupted_exception_cancel_xfer));
                }

Apologies I didn't have a code sample for that handy, but yes, what you just shared looks like what I had in mind.

Greg - 

Once I issue .start(), do I need to do anything other than close the streams to correctly end this transaction?

You should just use DbxDownloader.close when you're finished with the downloader (which will close the InputStream returned by getInputStream for you), in addition to closing any streams you opened yourself.