Package gnu.mail.providers.pop3
This is a provider for the Internet Post Office Protocol, version 3 (POP3),
as detailed in RFC 1939.
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. |