(Android™) Bounced Email Handling

Note: This example uses classes, properties, or methods discontinued in Chilkat v11.0.0 or greater.

Demonstrates how to examine emails and detect which are bounced (automated) replies. Classifies each email according to the type of bounce.

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.

    CkBounce bounce = new CkBounce();

    // The mailman object is used for receiving (POP3) 
    // and sending (SMTP) email.
    CkMailMan mailman = new CkMailMan();

    // Set the POP3 server's hostname
    mailman.put_MailHost("mail.chilkatsoft.com");

    // Set the POP3 login/password.
    mailman.put_PopUsername("myLogin");
    mailman.put_PopPassword("myPassword");

    // Copy the all email from the user's POP3 mailbox 
    // into a bundle object.  The email remains on the server.
    // (There are other methods for deleting email from a POP3 server.)
    CkEmailBundle bundle = mailman.CopyMail();
    if (mailman.get_LastMethodSuccess() == false) {
        Log.i(TAG, mailman.lastErrorText());
        return;
        }

    int i = 0;
    CkEmail email;
    while (i < bundle.get_MessageCount()) {
        email = bundle.GetEmail(i);

        boolean success = bounce.ExamineEmail(email);
        if (success == false) {
            Log.i(TAG, bounce.lastErrorText());

            return;
            }

        if (bounce.get_BounceType() == 1) {
            // Hard bounce, log the email address
            Log.i(TAG, "Hard Bounce: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 2) {
            // Soft bounce, log the email address
            Log.i(TAG, "Soft Bounce: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 3) {
            // General bounce, no email address available.
            Log.i(TAG, "General Bounce: No email address");
            }

        if (bounce.get_BounceType() == 4) {
            // General bounce, log the email address
            Log.i(TAG, "General Bounce: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 5) {
            // Mail blocked, log the email address
            // A bounce occured because the sender was blocked. 
            Log.i(TAG, "Mail Blocked: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 6) {
            // Auto-reply, log the email address
            Log.i(TAG, "Auto-Reply: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 7) {
            // Transient (recoverable) Failure, log the email address
            Log.i(TAG, "Transient Failure: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 8) {
            // Subscribe request, log the email address
            Log.i(TAG, "Subscribe Request: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 9) {
            // Unsubscribe Request, log the email address
            Log.i(TAG, "Unsubscribe Request: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 10) {
            // Virus Notification, log the email address
            Log.i(TAG, "Virus Notification: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 11) {
            // Suspected bounce.
            // This should be rare.  It indicates that the Bounce
            // component found strong evidence that this is a bounced
            // email, but couldn't quite recognize everything it
            // needed to be 100% sure.  Feel free to notify
            // support@chilkatsoft.com regarding emails having this
            // bounce type.
            Log.i(TAG, "Suspected Bounce!");
            }

        if (bounce.get_BounceType() == 12) {
            // Challenge/Response - Auto-reply message sent by SPAM software 
            // where only verified email addresses are accepted. 
            Log.i(TAG, "Challenge: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 13) {
            // Address Change Notification Message.
            Log.i(TAG, "Address Change: " + bounce.bounceAddress());
            }

        if (bounce.get_BounceType() == 14) {
            // Success DSN indicating that the message was successfully relayed.
            Log.i(TAG, "DSN Successful Relay: ");
            }

        i = i + 1;
        }

    success = mailman.Pop3EndSession();

  }

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