Java

Get a Report Part from a multipart/report Email

Demonstrates the Chilkat Email.GetReport method, which returns the body content of the Nth report within a multipart/report email. The NumReports property gives the count, and indexes are zero-based. This example loads a report email and prints each report part.

Background: A multipart/report message — used for bounces (DSNs) and read receipts (MDNs) — bundles machine-readable report parts alongside the human-readable explanation. GetReport returns the raw content of one such part so a program can parse it, for example to extract the failing recipient and status code from a bounce. Use GetDeliveryStatusInfo for direct field-level access to the delivery-status part.

Chilkat Java Downloads

Download Chilkat for Java

Java

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[])
  {
    boolean success = false;

    //  Demonstrates the GetReport method, which returns the body content of the Nth report
    //  within a multipart/report email.  The NumReports property gives the number of reports;
    //  indexes are zero-based.

    CkEmail email = new CkEmail();

    success = email.LoadEml("qa_data/eml/dsn_bounce.eml");
    if (success == false) {
        System.out.println(email.lastErrorText());
        return;
        }

    int n = email.get_NumReports();
    System.out.println("NumReports = " + n);

    int i;
    for (i = 0; i <= n - 1; i++) {
        System.out.println("---- Report " + i + " ----");
        System.out.println(email.getReport(i));
        }

    //  A report returned by GetReport is the body of a report part -- for a bounce (DSN),
    //  that is the machine-readable message/delivery-status part.  It looks similar to:
    //  
    //    Reporting-MTA: dns; mail.example.com
    //    Received-From-MTA: dns; sender.example.com
    //    Arrival-Date: Fri, 10 Jul 2026 20:15:30 +0000
    //  
    //    Final-Recipient: rfc822; nonexistent@example.com
    //    Action: failed
    //    Status: 5.1.1
    //    Diagnostic-Code: smtp; 550 5.1.1 <nonexistent@example.com> User unknown

    //  Note: The path "qa_data/..." is a relative local filesystem path,
    //  relative to the current working directory of the running application.
  }
}