Objective-C

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. Objective-C

#import <NSString.h>
#import <CkoMime.h>
#import <CkoEmail.h>
#import <CkoJsonObject.h>

BOOL success = NO;

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

NSString *emlPath = @"C:/AAWorkarea/beatrix/roesner.eml";

CkoMime *mime = [[CkoMime alloc] init];

success = [mime LoadMimeFile: emlPath];
if (success == NO) {
    NSLog(@"%@",mime.LastErrorText);
    return;
}

NSLog(@"%@",@"---- MIME structure ----");
NSLog(@"%@",[mime GetStructure: @"text"]);
NSLog(@"%@",@"------------------------");

CkoEmail *email = [[CkoEmail alloc] init];
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.
NSLog(@"%@%d",@"Email was Signed: ",email.ReceivedSigned);
NSLog(@"%@%d",@"Email was Encrypted: ",email.ReceivedEncrypted);
if (email.ReceivedSigned == YES) {
    NSLog(@"%@%d",@"Signature(s) valid = ",email.SignaturesValid);
}

if (email.ReceivedEncrypted == YES) {
    NSLog(@"%@%d",@"Decrypted successfully = ",email.Decrypted);
}

int i = 0;
int numAttach = [email.NumAttachments intValue];
NSLog(@"%@%d",@"Number of attachments = ",numAttach);

while (i < numAttach) {
    NSLog(@"%@%d",@"---- Attachment ",i);

    // Examine the filename (if any)
    NSLog(@"%@%@",@"filename: ",[email GetAttachmentFilename: [NSNumber numberWithInt: i]]);
    // Examine the content-ID (if any)
    NSLog(@"%@%@",@"Content-ID: ",[email GetAttachmentContentID: [NSNumber numberWithInt: i]]);
    // Examine the content-type
    NSLog(@"%@%@",@"Content-Type: ",[email GetAttachmentContentType: [NSNumber numberWithInt: i]]);
    // Examine the content-disposition
    NSLog(@"%@%@",@"Content-Disposition",[email GetAttachmentHeader: [NSNumber numberWithInt: i] fieldName: @"content-disposition"]);
    // Examine the attachment size:
    NSLog(@"%@%d",@"Size (in bytes) of the attachment: ",[[email GetAttachmentSize: [NSNumber numberWithInt: i]] intValue]);

    i = i + 1;
}

NSLog(@"%@",@"--");

// 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.NumRelatedItems intValue];
NSLog(@"%@%d",@"Number of related items = ",numRelated);
i = 0;
while (i < numRelated) {
    NSLog(@"%@%d",@"---- Related Item ",i);

    // Examine the filename (if any)
    NSLog(@"%@%@",@"filename: ",[email GetRelatedFilename: [NSNumber numberWithInt: i]]);
    // Examine the content-ID (if any)
    NSLog(@"%@%@",@"Content-ID: ",[email GetRelatedContentID: [NSNumber numberWithInt: i]]);
    // Examine the content-type
    NSLog(@"%@%@",@"Content-Type: ",[email GetRelatedContentType: [NSNumber numberWithInt: i]]);
    // Examine the content-location (if any)
    NSLog(@"%@%@",@"Content-Location",[email GetRelatedContentLocation: [NSNumber numberWithInt: i]]);

    i = i + 1;
}

// The email could also have attached messages.
// An attached message is another email that was attached to this email.
CkoEmail *em = [[CkoEmail alloc] init];
int numAttachedMessages = [email.NumAttachedMessages intValue];
NSLog(@"%@%d",@"Number of attached messages = ",numAttachedMessages);
i = 0;
while (i < numAttachedMessages) {
    NSLog(@"%@%d",@"---- Attached message ",i);

    // Examine the attached email
    [email GetAttachedEmail: [NSNumber numberWithInt: i] email: em];
    NSLog(@"%@%@",@"from: ",em.From);
    NSLog(@"%@%@",@"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.NumReports intValue];
NSLog(@"%@%d",@"Number of reports = ",numReports);
i = 0;
while (i < numReports) {
    NSLog(@"%@%d",@"---- Report ",i);
    // Get the raw report data...
    NSLog(@"%@",[email GetReport: [NSNumber numberWithInt: 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] == YES) {

    NSLog(@"%@",@"--- Delivery Status Information:");
    NSLog(@"%@%@",@"Status: ",[email GetDeliveryStatusInfo: @"Status"]);
    NSLog(@"%@%@",@"Action: ",[email GetDeliveryStatusInfo: @"Action"]);
    NSLog(@"%@%@",@"Reporting-MTA: ",[email GetDeliveryStatusInfo: @"Reporting-MTA"]);

    CkoJsonObject *jsonDsnInfo = [[CkoJsonObject alloc] init];
    [email GetDsnInfo: jsonDsnInfo];
    jsonDsnInfo.EmitCompact = NO;
    NSLog(@"%@",[jsonDsnInfo Emit]);
}