(Android™) Get IMAP UID from Email Header

Demonstrates how to get the IMAP UID from an email header. After fetching an email or header using IMAP, the UID is contained in the ckx-imap-uid header field.

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.

    CkImap imap = new CkImap();

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

    // Login
    success = imap.Login("login","password");
    if (success != true) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    // Select an IMAP mailbox
    success = imap.SelectMailbox("Inbox");
    if (success != true) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    boolean fetchUids = true;
    // Get the message UIDs of all the emails in the mailbox
    CkMessageSet messageSet = imap.Search("ALL",fetchUids);
    if (imap.get_LastMethodSuccess() != true) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    CkEmailBundle bundle = imap.FetchHeaders(messageSet);
    if (imap.get_LastMethodSuccess() != true) {

        Log.i(TAG, imap.lastErrorText());
        return;
        }

    // The UID of each fetched email header is available 
    // in the ckx-imap-uid header field.
    int i = 0;
    int szBundle = bundle.get_MessageCount();
    CkMessageSet msOneMsg = new CkMessageSet();
    while (i < szBundle) {
        CkEmail email = bundle.GetEmail(i);

        // Build a message set containing one UID
        String uidStr = email.getHeaderField("ckx-imap-uid");
        msOneMsg.FromCompactString(uidStr);

        // Move this message to some other folder.
        success = imap.MoveMessages(msOneMsg,"someOtherFolder");
        if (success != true) {
            Log.i(TAG, imap.lastErrorText());
            // Exit the loop...
            i = szBundle;
            }

        i = i + 1;
        }

    // Disconnect from the IMAP server.
    success = imap.Disconnect();


  }

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