Package gnu.mail.providers.pop3

This is a provider for the Internet Post Office Protocol, version 3 (POP3), as detailed in RFC 1939.

Class Summary

POP3Folder The folder class implementing the POP3 mail protocol.
POP3Message The message class implementing the POP3 mail protocol.
POP3Store The storage class implementing the POP3 mail protocol.
This is a provider for the Internet Post Office Protocol, version 3 (POP3), as detailed in RFC 1939.

This provider supports transport layer security (TLS), as described in RFC 2595, and uses APOP authentication if the server advertises this capability.

The POP3 store provides access to a single folder named "INBOX". Folder management operations are not supported by POP3; nor are permanent flags.

This store does not provide a local cache of messages. You can implement such a cache yourself using the mbox or Maildir providers in this distribution.

POP3 does not support the expunge method according to the JavaMail specification. Messages deleted using expunge will only be removed from the folder when the close method is called. <!-- TODO UIDL -->

This provider supports the following properties:

NameTypeDescription
mail.pop3.hostIP address or hostnameThe POP3 server to connect to.
mail.pop3.portinteger (>=1)The port to connect to, if not the default.
mail.pop3.userusernameThe default username for POP3.
mail.pop3.connectiontimeoutinteger (>=1)Socket connection timeout, in milliseconds. Default is no timeout.
mail.pop3.timeoutinteger (>=1)Socket I/O timeout, in milliseconds. Default is no timeout.
mail.pop3.tlsbooleanIf set to false, TLS negotiation will not be attempted. Exceptionally, you may set this to required to throw an exception on connect when TLS is not available.
mail.pop3.trustmanagerStringThe name of a class implementing the javax.net.ssl.TrustManager interface, which will be used to determine trust in TLS negotiation.
mail.pop3.auth.mechanismscomma-delimited list of SASL mechanismsIf set, only the specified SASL mechanisms will be attempted during authentication, in the given order. If not present, the SASL mechanisms advertised by the server will be used.
mail.pop3.apopbooleanIf set to false, APOP authentication will not be attempted.
mail.pop3.rsetbeforequitbooleanIf set to true, an RSET command will be issued before QUIT. This is useful for broken servers that implicitly mark read messages as deleted.

© Copyright 2003, 2004 The Free Software Foundation, All rights reserved