Android™

Load .eml and Examine the Structure, Attachments, and Related Items

See more Email Object Examples

Demonstrates how to load examine the MIME structure of a .eml, and also examine the attachment and related item filenames, attached messages, and multipart/report and DSN information. Android™

// 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);

    boolean success = false;

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

    String emlPath = "C:/AAWorkarea/beatrix/roesner.eml";

    CkMime mime = new CkMime();

    success = mime.LoadMimeFile(emlPath);
    if (success == false) {
        Log.i(TAG, mime.lastErrorText());
        return;
        }

    Log.i(TAG, "---- MIME structure ----");
    Log.i(TAG, mime.getStructure("text"));
    Log.i(TAG, "------------------------");

    CkEmail email = new CkEmail();
    success = email.LoadEml(emlPath);

    // Was this a signed and/or encrypted email?
    // If so, then loading the .eml automatically unwraps
    // (i.e. verifies signatures and decrypts) and the resultant
    // email is what existed prior to signing/encrypting.
    Log.i(TAG, "Email was Signed: " + String.valueOf(email.get_ReceivedSigned()));
    Log.i(TAG, "Email was Encrypted: " + String.valueOf(email.get_ReceivedEncrypted()));
    if (email.get_ReceivedSigned() == true) {
        Log.i(TAG, "Signature(s) valid = " + String.valueOf(email.get_SignaturesValid()));
        }

    if (email.get_ReceivedEncrypted() == true) {
        Log.i(TAG, "Decrypted successfully = " + String.valueOf(email.get_Decrypted()));
        }

    int i = 0;
    int numAttach = email.get_NumAttachments();
    Log.i(TAG, "Number of attachments = " + String.valueOf(numAttach));

    while (i < numAttach) {
        Log.i(TAG, "---- Attachment " + String.valueOf(i));

        // Examine the filename (if any)
        Log.i(TAG, "filename: " + email.getAttachmentFilename(i));
        // Examine the content-ID (if any)
        Log.i(TAG, "Content-ID: " + email.getAttachmentContentID(i));
        // Examine the content-type
        Log.i(TAG, "Content-Type: " + email.getAttachmentContentType(i));
        // Examine the content-disposition
        Log.i(TAG, "Content-Disposition" + email.getAttachmentHeader(i,"content-disposition"));
        // Examine the attachment size:
        Log.i(TAG, "Size (in bytes) of the attachment: " + String.valueOf(email.GetAttachmentSize(i)));

        i = i + 1;
        }

    Log.i(TAG, "--");

    // Now for the related items.

    // Note: A MIME sub-part can potentially be both a related item AND an attachment.
    // The typical case is when the item is contained under the multipart/related enclosure and 
    // the item also has a "Content-Disposition" header indicating "attachment".
    // The location within multipart/related makes it a "related item", yet the Content-Disposition can also make it semantically an attachment.
    // Related items and attachments are not necessarily mutually exclusive.

    int numRelated = email.get_NumRelatedItems();
    Log.i(TAG, "Number of related items = " + String.valueOf(numRelated));
    i = 0;
    while (i < numRelated) {
        Log.i(TAG, "---- Related Item " + String.valueOf(i));

        // Examine the filename (if any)
        Log.i(TAG, "filename: " + email.getRelatedFilename(i));
        // Examine the content-ID (if any)
        Log.i(TAG, "Content-ID: " + email.getRelatedContentID(i));
        // Examine the content-type
        Log.i(TAG, "Content-Type: " + email.getRelatedContentType(i));
        // Examine the content-location (if any)
        Log.i(TAG, "Content-Location" + email.getRelatedContentLocation(i));

        i = i + 1;
        }

    // The email could also have attached messages.
    // An attached message is another email that was attached to this email.
    CkEmail em = new CkEmail();
    int numAttachedMessages = email.get_NumAttachedMessages();
    Log.i(TAG, "Number of attached messages = " + String.valueOf(numAttachedMessages));
    i = 0;
    while (i < numAttachedMessages) {
        Log.i(TAG, "---- Attached message " + String.valueOf(i));

        // Examine the attached email
        email.GetAttachedEmail(i,em);
        Log.i(TAG, "from: " + em.ck_from());
        Log.i(TAG, "subject: " + em.subject());
        i = i + 1;
        }

    // An email could also be a multipart/report email. 
    // This is a DSN (Delivery Status Notification)
    // The NumReports property indicates how many "reports" exist.
    int numReports = email.get_NumReports();
    Log.i(TAG, "Number of reports = " + String.valueOf(numReports));
    i = 0;
    while (i < numReports) {
        Log.i(TAG, "---- Report " + String.valueOf(i));
        // Get the raw report data...
        Log.i(TAG, email.getReport(i));
        i = i + 1;
        }

    // If the email is a multipart/report, then the information
    // from the message/delivery-status part of the email can be retrieved:
    if (email.IsMultipartReport() == true) {

        Log.i(TAG, "--- Delivery Status Information:");
        Log.i(TAG, "Status: " + email.getDeliveryStatusInfo("Status"));
        Log.i(TAG, "Action: " + email.getDeliveryStatusInfo("Action"));
        Log.i(TAG, "Reporting-MTA: " + email.getDeliveryStatusInfo("Reporting-MTA"));

        CkJsonObject jsonDsnInfo = new CkJsonObject();
        email.GetDsnInfo(jsonDsnInfo);
        jsonDsnInfo.put_EmitCompact(false);
        Log.i(TAG, jsonDsnInfo.emit());
        }


  }

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