Android™
Android™
Get the POP3 UIDL of an Email
See more Email Object Examples
Demonstrates the read-only Chilkat Email.Uidl property, which contains the unique message identifier assigned by a POP3 server; the value is also represented by the X-UIDL header field. This example sets X-UIDL directly to illustrate how it maps to the Uidl property (normally the value comes from the POP3 server during download).
Background: A UIDL ("unique ID listing") is POP3's stable identifier for a message in a mailbox — it stays the same across sessions, so a client can remember which messages it has already downloaded and avoid fetching them again. Note this is POP3-specific: IMAP uses its own UID instead, which Chilkat stores in the
ckx-imap-uid header rather than in Uidl.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);
// Demonstrates the read-only Email.Uidl property, which contains the unique message
// identifier assigned by a POP3 server. The value is represented by the X-UIDL header
// field. Here we set X-UIDL directly to show how it maps to the Uidl property.
CkEmail email = new CkEmail();
// Normally the POP3 server assigns this; we set it here for demonstration.
email.AddHeaderField("X-UIDL","0000000123abcdef");
Log.i(TAG, "Uidl = " + email.uidl());
}
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."
}
}