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:

Name Type Description
mail.pop3.host IP address or hostname The POP3 server to connect to.
mail.pop3.port integer (>=1) The port to connect to, if not the default.
mail.pop3.user username The default username for POP3.
mail.pop3.connectiontimeout integer (>=1) Socket connection timeout, in milliseconds. Default is no timeout.
mail.pop3.timeout integer (>=1) Socket I/O timeout, in milliseconds. Default is no timeout.
mail.pop3.tls boolean If 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.trustmanager String The name of a class implementing the javax.net.ssl.TrustManager interface, which will be used to determine trust in TLS negotiation.
mail.pop3.auth.mechanisms comma-delimited list of SASL mechanisms If 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.apop boolean If set to false, APOP authentication will not be attempted.
mail.pop3.rsetbeforequit boolean If set to true, an RSET command will be issued before QUIT. This is useful for broken servers that implicitly mark read messages as deleted.