Android™
Android™
Fetch All Messages from a POP3 Mailbox
See more POP3 Examples
Demonstrates the Chilkat MailMan.FetchAll method, which retrieves messages from the POP3 mailbox and appends them to an EmailBundle. The arguments are keepOnServer, headersOnly, numBodyLines, and the EmailBundle that receives the emails. This example downloads every message and iterates the bundle, printing each subject.
Background: An
EmailBundle is Chilkat's container for a set of downloaded messages — you read its MessageCount and pull out each Email with EmailAt. The three flags control how much is fetched: keepOnServer leaves copies in the mailbox rather than removing them, headersOnly downloads just the headers for a fast preview, and numBodyLines can fetch a partial body (0 means the whole body). Traditional POP3 clients download and delete; setting keepOnServer to true supports "leave mail on server" behavior.Chilkat Android™ Downloads
// 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.FetchAll method, which retrieves messages from the POP3 mailbox
// and appends them to an EmailBundle. The arguments are keepOnServer, headersOnly,
// numBodyLines, and the EmailBundle that receives the emails.
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 all messages, leaving them on the server, with full bodies.
// keepOnServer=true, headersOnly=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.
CkEmailBundle bundle = new CkEmailBundle();
success = mailman.FetchAll(true,false,0,bundle);
if (success == false) {
Log.i(TAG, mailman.lastErrorText());
return;
}
int n = bundle.get_MessageCount();
Log.i(TAG, "Fetched " + String.valueOf(n) + " messages.");
CkEmail email = new CkEmail();
int i;
for (i = 0; i <= n - 1; i++) {
success = bundle.EmailAt(i,email);
Log.i(TAG, email.subject());
}
// 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."
}
}