A provider for the Simple Mail Transfer Protocol (SMTP), as detailed in RFC 2821, including support for ESMTP service extensions.
This provider can use SMTP authentication via the LOGIN or PLAIN mechanism, and transport layer security (TLS) for servers that support it (RFC 2554 and 3207).
You may also optionally request Delivery Status Notifications (DSN) as specified in RFC 3461.
The provider supports the following session properties:
Name | Type | Description |
---|---|---|
mail.smtp.host | IP address or hostname | The SMTP server to connect to |
mail.smtp.port | integer (>=1) | The port to connect to, if not specified. | mail.smtp.timeout | integer (>=1) | Socket I/O timeout, in milliseconds. Defaults to no timeout. |
mail.smtp.from | RFC 822 address | The mailbox to use for the SMTP MAIL command. If not set, the first
InternetAddress in the From field of the message will be used, or failing
that, InternetAddress.getLocalAddress() . |
mail.smtp.localhost | IP address or hostname | The host identifier for the local machine, to report in the EHLO/HELO command. |
mail.smtp.ehlo | boolean | If set to false, service extensions negotiation will not be attempted. |
mail.smtp.auth | boolean | If set to true, authentication will be attempted. |
mail.smtp.dsn.notify | string | The RCPT NOTIFY option. Should be set to either "never", or one or more of "success", "failure", or "delay" (separated by commas and/or spaces) |
mail.smtp.dsn.ret | string | The MAIL RET option. Should be set to "full" or "hdrs". |