Jakarta Java Mail属性参数配置

前言

Jakarta Mail网址：https://eclipse-ee4j.github.io/mail

SMTP协议可匹配的属性：https://eclipse-ee4j.github.io/mail/docs/api/com/sun/mail/smtp/package-summary.html

翻译(Package com.sun.mail.smtp)

Package com.sun.mail.smtp

Jakarta Mail API的SMTP协议提供程序，提供对SMTP服务器的访问。

Class Summary

• SMTPMessage 此类是MimeMessage类的特殊化，它允许您指定通过SMTP发送此消息时将使用的各种SMTP选项和参数。
• SMTPSSLTransport 此类使用SSL上的SMTP实现SMTP传输抽象类，以进行邮件提交和传输。
• SMTPTransport 此类使用SMTP实现Transport抽象类，以进行邮件提交和传输。

Exception Summary

• SMTPAddressFailedException 无法发送消息时，抛出此异常。
• SMTPAddressSucceededException 当mail.smtp.reportsuccess属性为true时，此异常将链接到SendFailedException。
• SMTPSenderFailedException 无法发送消息时，抛出此异常。
• SMTPSendFailedException 无法发送消息时，抛出此异常。

Package com.sun.mail.smtp Description

Jakarta Mail API的SMTP协议提供程序，提供对SMTP服务器的访问。有关更多信息，请参考RFC 821。

发送消息时，在抛出的顶级SendFailedException链接的SMTPAddressFailedException中提供了有关每个失败地址的详细信息。 此外，如果设置了mail.smtp.reportsuccess属性，则对于每个成功地址，SMTPAddressSucceededException将包括在列表中。 请注意，即使发送成功，这也会导致抛出顶级SendFailedException。

SMTP提供程序还支持ESMTP（RFC 1651）。它可以选择使用LOGIN，PLAIN，DIGEST-MD5和NTLM机制（RFC 4616和RFC 2831）使用SMTP身份验证（RFC 2554）。

要使用SMTP身份验证，您需要设置mail.smtp.auth属性（请参见下文）或在连接到SMTP服务器时为SMTP传输提供用户名和密码。您可以使用以下方法之一来执行此操作：

• 在创建邮件Session时提供Authenticator对象，并在Authenticator回调过程中提供用户名和密码信息。

请注意，可以将mail.smtp.user属性设置为为回调提供默认用户名，但是仍然需要显式提供密码。这种方法允许您使用静态传输发送方法来发送消息。

• 使用用户名和密码参数显式调用Transport connect方法。

此方法要求您显式管理传输对象，并使用传输sendMessage方法发送消息。 transport.java演示程序演示了如何管理Transport对象。 以下内容大致等同于静态Transport send方法，但提供了所需的用户名和密码：

Transport tr = session.getTransport("smtp");
tr.connect(smtphost, username, password);
msg.saveChanges();      // don't forget this
tr.sendMessage(msg, msg.getAllRecipients());
tr.close();

使用DIGEST-MD5身份验证时，您还需要提供适当的领域(realm)；您的邮件服务器管理员可以提供此信息。您可以使用mail.smtp.sasl.realm属性或SMTPTransport上的setSASLRealm方法进行设置。

SMTP协议提供程序可以在支持javax.security.sasl API（例如J2SE 5.0）的系统上使用SASL（RFC 2222）身份验证机制。 除了内置于SASL实现中的SASL机制之外，用户还可以提供自己设计的其他SASL机制，以支持自定义身份验证方案。 有关详细信息，请参见《 Java SASL API编程和部署指南》。 请注意，当前的实现不支持提供自己的完整性或机密性层的SASL机制。

通过上述的SASL支持或作为SMTP提供程序中的内置身份验证机制，可以通过XOAUTH2身份验证机制支持OAuth 2.0身份验证。 OAuth 2.0访问令牌应作为此机制的密码传递。 有关详细信息，请参见OAuth2支持。

SMTP还可以选择请求传递状态通知（RFC 1891）。 通常使用带有“message/delivery-status”（RFC 1894）部分的“multipart/report”（RFC 1892）消息类型报告传递状态。 您可以使用com.sun.mail.dsn包中的类来处理这些MIME类型。 请注意，您需要在CLASSPATH中包含dsn.jar，因为mail.jar中不包含此支持。

请参阅以下有关启用这些功能的属性。

还请注意，这里没有足够的文档来使用这些功能！！！ 您将需要阅读上述适当的RFC，以了解这些功能的作用以及如何使用它们。 不要只是开始设置属性，然后在无法正常运行时向我们投诉，就像您期望的那样。 首先阅读RFC ！！！

SMTP协议提供程序支持RFC 3030中定义的CHUNKING扩展。将mail.smtp.chunksize属性设置为所需的块大小（以字节为单位）。 如果服务器支持CHUNKING扩展，则将使用BDAT命令以块大小发送消息。 请注意，没有流水线(pipelining )操作，因此这比发送消息慢得多。 另请注意，不支持RFC 3030中描述的BINARYMIME扩展。

Properties

SMTP协议提供程序支持以下属性，可以在Jakarta Mail Session对象中设置这些属性。这些属性始终设置为字符串。 “类型”列描述了如何解释字符串。例如使用

props.put("mail.smtp.port", "888");

设置类型为int的mail.smtp.port属性。

请注意，如果您使用“smtps”协议通过SSL访问SMTP，则所有属性都将命名为 "mail.smtps.*" 。

SMTP properties

通常，应用程序不需要直接使用此包中的类。 相反，他们应该使用javax.mail包（和子包）定义的API。 应用程序永远不要直接构造SMTPTransport的实例。 相反，他们应该使用Session方法getTransport来获取适当的Transport对象。

除了按Session配置控制打印调试输出外，com.sun.mail.smtp提供程序还使用Logger记录相同的信息，如下表所述：

SMTP Loggers

警告：此软件包独有的API应该被视为实验性的。将来可能会以与使用当前API的应用程序不兼容的方式对其进行更改。

翻译完成(2020/08/19)