(Android™) Async Upload (Append) Email to an IMAP Mailbox

Use the AppendMailAsync method call to append an email to an IMAP mailbox.

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 assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkImap imap = new CkImap();

    // Connect to an IMAP server.
    // Use TLS
    imap.put_Ssl(true);
    imap.put_Port(993);
    boolean success = imap.Connect("MY-IMAP-DOMAIN");
    if (success != true) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    // Login
    success = imap.Login("MY-IMAP-LOGIN","MY-IMAP-PASSWORD");
    if (success != true) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    // Create a simple email with 2 recipients.
    CkEmail email = new CkEmail();
    email.put_From("support@chilkatsoft.com");
    email.AddTo("Chilkat Sales","sales@chilkatsoft.com");
    email.AddTo("Chilkat GMail","chilkat.support@gmail.com");
    email.put_Body("This is a test email.");
    email.put_Subject("This is a test email.");

    // Imagine we've sent this email via SMTP, and now we want to 
    // save the email to our "Sent" mailbox.  On GMail, the mailbox name
    // for sent email is "[Gmail]/Sent Mail".

    // Call the async version of the AppendMail method to return a task object.
    CkTask task = imap.AppendMailAsync("[Gmail]/Sent Mail",email);
    if (imap.get_LastMethodSuccess() != true) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    // Schedule the task for running on the thread pool.  This changes the task's state
    // from Inert to Live.  The task is now running...
    success = task.Run();
    if (success != true) {
        Log.i(TAG, task.lastErrorText());

        return;
        }

    // -------------------------------------------------------------------------------
    // The following is a general note that applies to all programming languages:
    // -------------------------------------------------------------------------------
    // Your application can keep a reference to the task object and periodically check back later to see if it's finished.
    // If your programming language is one that supports callbacks, then the TaskCompleted callback can
    // be setup to be called when the task completes.  (See the "Async" category on example-code.com for more information.)
    // 
    // NOTE: This is very important:  A TaskCompleted callback runs in the background thread.  
    // (All callbacks from an async task, such as AbortCheck, PercentDone, ProgressInfo, etc. are in the background thread.) 
    // An application that uses TaskCompleted must be very careful.  
    // For example, user interface elements (such as labels, text boxes, etc.) may not be directly
    // accessible from a background thread, and could crash the application if directly accessed.  Also, attempting to debug
    // code running in a background thread from an IDE, especially an older IDE (such as VB6) is likely to crash the IDE.

  }

  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."
  }
}