前言

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)