(Java) Upload (Append) Email to an IMAP Mailbox and get the UID of the Appended Email

Upload / append an email to an IMAP mailbox and get the UID of the appended email.

Chilkat Java Downloads Java Libs for Windows, MacOS, Linux, Alpine Linux, Solaris Java Libs for Android

import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    // 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("imap.someMailServer.com");
    if (success != true) {
        System.out.println(imap.lastErrorText());
        return;
        }

    // Login
    success = imap.Login("myLogin","myPassword");
    if (success != true) {
        System.out.println(imap.lastErrorText());
        return;
        }

    // Check the capabilities of the IMAP server.
    String cap = imap.capability();
    System.out.println("IMAP capabilities: " + cap);

    // If the capabilities string contains the substring "UIDPLUS", then 
    // the UID of the appended email will be available in the AppendUid property (see below).

    // For example, the GMail IMAP server has these capabilities (at this current time)
    // * CAPABILITY IMAP4rev1 UNSELECT IDLE NAMESPACE QUOTA ID XLIST CHILDREN 
    // X-GM-EXT-1 UIDPLUS COMPRESS=DEFLATE ENABLE MOVE CONDSTORE ESEARCH UTF8=ACCEPT 
    // APPENDLIMIT=35882577 LIST-EXTENDED LIST-STATUS

    CkEmail email = new CkEmail();

    // Load the email from a .eml file.
    success = email.LoadEml("myEmail.eml");
    if (success != true) {
        System.out.println(email.lastErrorText());
        return;
        }

    success = imap.AppendMail("Inbox",email);
    if (success != true) {
        System.out.println(imap.lastErrorText());
        return;
        }

    // If the IMAP server supports the UIDPLUS extension, then the 
    // imap.AppendUid will contain the UID of the appended email.
    // Otherwise AppendUid will be 0.
    System.out.println("UID of appended email: " + imap.get_AppendUid());

    // If the IMAP server does NOT have UIDPLUS, then a program can 
    // first select the mailbox, get the value of the UidNext property,
    // and then append.  The appended email SHOULD have a UID equal to 
    // the UidNext that was obtained just prior to appending (assuming no other
    // program is simultaneously appending an email to the same mailbox).

    // Note: It is not required to select a mailbox to append.  The select is only
    // done for the purpose of obtaining the UIDNEXT value.
    success = imap.SelectMailbox("Inbox");
    if (success != true) {
        System.out.println(imap.lastErrorText());
        return;
        }

    int uidNext = imap.get_UidNext();

    success = imap.AppendMail("Inbox",email);
    if (success != true) {
        System.out.println(imap.lastErrorText());
        return;
        }

    System.out.println("The UID of the appended email SHOULD be " + uidNext);

    System.out.println("Email uploaded to Inbox!");

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