Sample code for 30+ languages & platforms
Android™

Fetch One POP3 Message by Message Number

See more POP3 Examples

Demonstrates the Chilkat MailMan.FetchOne method, which retrieves one message by POP3 message number and stores it in an Email object. The arguments are headerOnly, numBodyLines, the message number (the first message is 1), and the Email. The message remains on the server. This example fetches message 1 in full.

Background: POP3 message numbers are simple 1-based positions valid only for the current session. FetchOne is the way to pull a single message straight into an Email object (rather than a bundle) when you know its position — for example after listing the mailbox. Because numbers can shift between sessions, FetchByUidl is the stabler choice when a message must be identified reliably over time.

Chilkat Android™ Downloads

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;

    //  Demonstrates the MailMan.FetchOne method, which retrieves one message by POP3 message
    //  number and stores it in an Email object.  The arguments are headerOnly, numBodyLines, the
    //  message number (the first message is 1), and the Email.  The message remains on the server.

    CkMailMan mailman = new CkMailMan();

    //  Configure the POP3 server connection.
    mailman.put_MailHost("pop.example.com");
    mailman.put_MailPort(995);
    mailman.put_PopSsl(true);
    mailman.put_PopUsername("user@example.com");
    mailman.put_PopPassword("myPassword");

    //  Fetch message number 1 in full.  headerOnly=false (fetch the entire message).
    //  Note: numBodyLines only applies when headersOnly is true (it sets how many lines of the
    //  body to include along with the headers).  When headersOnly is false, the entire message
    //  is fetched and numBodyLines is ignored.
    CkEmail email = new CkEmail();

    success = mailman.FetchOne(false,0,1,email);
    if (success == false) {
        Log.i(TAG, mailman.lastErrorText());
        return;
        }

    Log.i(TAG, "Subject: " + email.subject());
    Log.i(TAG, "From: " + email.ck_from());

    //  Note: Explicitly connecting/authenticating is optional.  Chilkat MailMan automatically
    //  connects and authenticates -- using the property settings above -- whenever a server
    //  operation requires it.  Calling the explicit connect/authenticate methods can still be
    //  helpful to determine whether a failure occurs while connecting or while authenticating.

  }

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