(Android™) Cancel Async Task if not Completed after a Max Time

Demonstrates how to wait a maximum amount of time for an asynchronous task to completed. If not completed in the allotted amount of time, the task is cancelled.

Chilkat Android™ Downloads Android™ Java Libraries Android C/C++ Libraries

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    boolean success;
    CkHttp http = new CkHttp();

    // Set some timeouts, in seconds:
    http.put_ConnectTimeout(15);
    http.put_ReadTimeout(15);

    // Wait a max time of 2 seconds for the task.
    // In this example, it's an unreasonably small amount of time,
    // which means the task will get cancelled.
    int waitMaxMs = 2000;

    // We're just going to download for 2 seconds and then cancel.
    // Substitute your own URL with a large enough file for testing..
    String downloadUrl = "http://download.mono-project.com/archive/4.6.1/windows-installer/mono-4.6.1.5-gtksharp-2.12.38-win32-0.msi";

    CkTask task = http.DownloadAsync(downloadUrl,"qa_output/mono.msi");
    task.Run();

    // Wait a maximum of waitMaxMs for the task (i.e. the HTTP download) to complete.
    // The Wait method returns when the task has been canceled, aborted, or completed, or when the max allotted time has passed.
    task.Wait(waitMaxMs);

    // At this point, the download may or may not have completed.  
    // Rather than checking the Task status, we can call task.Cancel because
    // if the Task is no longer running (because it already completed, was canceled or aborted), then the 
    // call to Cancel is a NO-OP (meaning it does nothing and the Task's status is unaffected).
    // Also, task.Cancel returns true if the task was in the "queued" or "running" state and was canceled or aborted. 
    // The method returns false if the task has any other status.
    boolean wasCanceled = task.Cancel();
    if (wasCanceled == true) {
        Log.i(TAG, "The HTTP download took too long and was canceled.");
        }
    else {
        // Find out what happened.
        if (task.get_StatusInt() == 7) {
            // The task completed, which means the background thread's call to Download completed
            // with success or failure.  Find out which...
            success = task.GetResultBool();
            if (success == true) {
                Log.i(TAG, "Download successful!");
                }
            else {
                Log.i(TAG, "Download failed prior to waitMaxMs...");
                Log.i(TAG, task.resultErrorText());
                }

            }
        else {
            // The task must've been canceled or aborted by some other means..
            Log.i(TAG, "Task did not complete.  Final status: " + task.status());
            }

        }


  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}