WARNING: These properties should be considered EXPERIMENTAL. They may be changed in the future in ways that are incompatible with current applications. Note also that THERE IS NOT SUFFICIENT DOCUMENTATION HERE TO USE THESE FEATURES. You will need to read the appropriate RFCs to understand what these features do and how to use them. Don't just start setting properties and then complain to us when it doesn't work like you expect it to work. READ THE RFCs FIRST!!!
| Name | Type | Description |
|---|---|---|
| mail.imap.user | String | Default user name for IMAP. |
| mail.imap.host | String | The IMAP server to connect to. |
| mail.imap.port | int | The IMAP server port to connect to, if the connect() method doesn't explicitly specify one. Defaults to 143. |
| mail.imap.partialfetch | boolean | Controls whether the IMAP partial-fetch capability should be used. Defaults to true. |
| mail.imap.fetchsize | int | Partial fetch size in bytes. Defaults to 16K. |
| mail.imap.connectiontimeout | int | Socket connection timeout value in milliseconds. Default is infinite timeout. |
| mail.imap.timeout | int | Socket I/O timeout value in milliseconds. Default is infinite timeout. |
| mail.imap.statuscachetimeout | int | Timeout value in milliseconds for cache of STATUS command response. Default is 1000 (1 second). Zero disables cache. |
| mail.imap.appendbuffersize | int | Maximum size of a message to buffer in memory when appending to an IMAP folder. If not set, or set to -1, there is no maximum and all messages are buffered. If set to 0, no messages are buffered. If set to (e.g.) 8192, messages of 8K bytes or less are buffered, larger messages are not buffered. Buffering saves cpu time at the expense of short term memory usage. If you commonly append very large messages to IMAP mailboxes you might want to set this to a moderate value (1M or less). |
| mail.imap.connectionpoolsize | int | Maximum number of available connections in the connection pool. Default is 1. |
| mail.imap.connectionpooltimeout | int | Timeout value in milliseconds for connection pool connections. Default is 45000 (45 seconds). |
| mail.imap.separatestoreconnection | boolean | Flag to indicate whether to use a dedicated store connection for store commands. Default is false. |
| mail.imap.connectionpool.debug | boolean | Flag to toggle debugging of the connection pool. Default is false. |
| Name | Type | Description |
|---|---|---|
| mail.pop3.user | String | Default user name for POP3. |
| mail.pop3.host | String | The POP3 server to connect to. |
| mail.pop3.port | int | The POP3 server port to connect to, if the connect() method doesn't explicitly specify one. Defaults to 110. |
| mail.pop3.connectiontimeout | int | Socket connection timeout value in milliseconds. Default is infinite timeout. |
| mail.pop3.timeout | int | Socket I/O timeout value in milliseconds. Default is infinite timeout. |
| mail.pop3.rsetbeforequit | boolean | Send a POP3 RSET command when closing the folder, before sending the QUIT command. Useful with POP3 servers that implicitly mark all messages that are read as "deleted"; this will prevent such messages from being deleted and expunged unless the client requests so. Default is false. |
| mail.pop3.message.class | int |
Class name of a subclass of com.sun.mail.pop3.POP3Message.
The subclass can be used to handle (for example) non-standard
Content-Type headers. The subclass must have a public constructor
of the form MyPOP3Message(Folder f, int msgno)
throws MessagingException.
|
| Name | Type | Description |
|---|---|---|
| mail.smtp.user | String | Default user name for SMTP. |
| mail.smtp.host | String | The SMTP server to connect to. |
| mail.smtp.port | int | The SMTP server port to connect to, if the connect() method doesn't explicitly specify one. Defaults to 25. |
| mail.smtp.connectiontimeout | int | Socket connection timeout value in milliseconds. Default is infinite timeout. |
| mail.smtp.timeout | int | Socket I/O timeout value in milliseconds. Default is infinite timeout. |
| mail.smtp.from | String | Email address to use for SMTP MAIL command. This sets the envelope return address. Defaults to msg.getFrom() or InternetAddress.getLocalAddress(). NOTE: mail.smtp.user was previously used for this. |
| mail.smtp.localhost | String | Local host name. Defaults to InetAddress.getLocalHost().getHostName(). Should not normally need to be set if your JDK and your name service are configured properly. |
| mail.smtp.ehlo | boolean | If false, do not attempt to sign on with the EHLO command. Defaults to true. Normally failure of the EHLO command will fallback to the HELO command; this property exists only for servers that don't fail EHLO properly or don't implement EHLO properly. |
| mail.smtp.auth | boolean | If true, attempt to authenticate the user using the AUTH command. Defaults to false. |
| mail.smtp.dsn.notify | String | The NOTIFY option to the RCPT command. Either NEVER, or some combination of SUCCESS, FAILURE, and DELAY (separated by commas). |
| mail.smtp.dsn.ret | String | The RET option to the MAIL command. Either FULL or HDRS. |
| mail.smtp.allow8bitmime | boolean | If set to true, and the server supports the 8BITMIME extension, text parts of messages that use the "quoted-printable" or "base64" encodings are converted to use "8bit" encoding if they follow the RFC2045 rules for 8bit text. |
| mail.smtp.sendpartial | boolean | If set to true, and a message has some valid and some invalid addresses, send the message anyway, reporting the partial failure with a SendFailedException. If set to false (the default), the message is not sent to any of the recipients if there is an invalid recipient address. |