(Android™) Bounced Email Handling

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