電子郵件的應用非常廣泛,例如在某網站注冊了一個賬戶,自動發送一封歡迎郵件,通過郵件找回密碼,自動批量發送活動信息等。但這些應用不可能和我們自己平時發郵件一樣,先打開瀏覽器,登錄郵箱,創建郵件再發送。本文將簡單介紹如何通過 java 代碼來創建電子郵件,并連接郵件服務器發送郵件。
1. 電子郵件協議
電子郵件的在網絡中傳輸和網頁一樣需要遵從特定的協議,常用的電子郵件協議包括 smtp,pop3,imap。其中郵件的創建和發送只需要用到 smtp協議,所以本文也只會涉及到smtp協議。smtp 是 simple mail transfer protocol 的簡稱,即簡單郵件傳輸協議。
2. javamail
我們平時通過 java 代碼打開一個 http 網頁鏈接時,通常可以使用已經對 http 協議封裝好的 httpurlconnection 類來快速地實現。java 官方也提供了對電子郵件協議封裝的 java 類庫,就是javamail,但并沒有包含到標準的 jdk 中,需要我們自己去官方下載,這里我從 javaee 官方的 github 倉庫下載。
javamail 下載地址:https://github.com/javaee/javamail/releases
這里我下載的版本是 1.6.0 版本,包含了 smtp, imap, 和 pop3 協議的實現的 jar 包:
我把 javamail 1.6.0 的 jar 包上傳到了 csdn,如果無法從 github 下載,可以從這:
特別注意:
- 本測試用例用的 javamail 版本是 1.6.0,如果下載到其他版本的 javamail 運行時出現問題,請使用 javamail 1.6.0 版本再進行嘗試。
- 使用 javamail 1.6.0 要求的 jdk 版本必須是 jdk 1.7 以上(建議使用最新版 jdk)。
- 不要直接就完完全全復制我的代碼,需要 修改一下發送的標題、內容、用戶昵稱,要不然所有人都直接復制我的代碼發送,內容一致,郵箱服務器就可能會檢測到這些內容是垃圾廣告內容,不讓你發送,會返回錯誤碼,查詢錯誤碼也能查詢到失敗原因。
有些童鞋反應代碼提示某些類找不到,或運行出現問題,往往都是 jdk 版本過低,或 javamail 版本過低,出現問題時 請使用推薦的版本。
再出現問題,只要能連接成功,都有錯誤碼返回,有些童鞋發送失敗在控制臺已經給出了錯誤碼,大部分還給出了查看錯誤碼含義的鏈接,點開鏈接,查詢對應的錯誤碼,為什么失敗,已經明明白白的告訴你了,針對失敗原因修改即可!
郵件發送,涉及多端(本地代碼端、郵件發送服務器端、郵件接收服務器端),保證自己的代碼沒問題了,不一定就能成功,你把你的郵件提交到郵件發送服務器,發送的服務器可以給你拒絕服務(比如認為發送的內容是垃圾廣告,或者你頻繁請求發送),這不是代碼端能管的事情,但都有錯誤碼返回,明確告訴你為什么錯誤。就算你發送成功了,對方也有可能接收不到,成功發送到對方的郵件接收服務器后,對方的服務器可以根據你的內容拒絕收你的郵件(比如認為你的內容是廣告詐騙等信息,或者發送過于頻繁),對方的服務器可能直接把你的郵件扔垃圾箱,或者直接忽略。出現這些問題,請修改發送的標題、內容、昵稱等,重復的內容不要反復發送,或多更換收件箱和發件箱試試!!!
3. 創建一封簡單的電子郵件
首先創建一個 java 工程,把下載好的 javax.mail.jar 作為類庫加入工程,這里不多說。
郵件創建步驟:
- 創建一個郵件對象(mimemessage);
- 設置發件人,收件人,可選增加多個收件人,抄送人,密送人;
- 設置郵件的主題(標題);
- 設置郵件的正文(內容);
- 設置顯示的發送時間;
- 保存到本地。
代碼實現:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
package com.xiets.javamaildemo; import javax.mail.session; import javax.mail.internet.internetaddress; import javax.mail.internet.mimemessage; import java.io.fileoutputstream; import java.io.outputstream; import java.util.date; import java.util.properties; /** * javamail 版本: 1.6.0 * jdk 版本: jdk 1.7 以上(必須) */ public class main { public static void main(string[] args) throws exception { // 1. 創建一封郵件 properties props = new properties(); // 用于連接郵件服務器的參數配置(發送郵件時才需要用到) session session= session.getdefaultinstance(props); // 根據參數配置,創建會話對象(為了發送郵件準備的) mimemessage message = new mimemessage(session); // 創建郵件對象 /* * 也可以根據已有的eml郵件文件創建 mimemessage 對象 * mimemessage message = new mimemessage(session, new fileinputstream("myemail.eml")); */ // 2. from: 發件人 // 其中 internetaddress 的三個參數分別為: 郵箱, 顯示的昵稱(只用于顯示, 沒有特別的要求), 昵稱的字符集編碼 // 真正要發送時, 郵箱必須是真實有效的郵箱。 // 3. to: 收件人 message.setrecipient(mimemessage.recipienttype.to, new internetaddress( "[email protected]" , "user_cc" , "utf-8" )); // to: 增加收件人(可選) message.addrecipient(mimemessage.recipienttype.to, new internetaddress( "[email protected]" , "user_dd" , "utf-8" )); // cc: 抄送(可選) message.setrecipient(mimemessage.recipienttype.cc, new internetaddress( "[email protected]" , "user_ee" , "utf-8" )); // bcc: 密送(可選) message.setrecipient(mimemessage.recipienttype.bcc, new internetaddress( "[email protected]" , "user_ff" , "utf-8" )); // 4. subject: 郵件主題 message.setsubject( "test郵件主題" , "utf-8" ); // 5. content: 郵件正文(可以使用html標簽) message.setcontent( "test這是郵件正文。。。" , "text/html;charset=utf-8" ); // 6. 設置顯示的發件時間 message.setsentdate( new date()); // 7. 保存前面的設置 message.savechanges(); // 8. 將該郵件保存到本地 outputstream out = new fileoutputstream( "myemail.eml" ); message.writeto(out); out.flush(); out.close(); } } |
保存的 myemail.eml 可以使用郵件客戶端打開查看,實際上就是一堆符合smtp協議格式的文本(內容使用base64進行了編碼),也可用記事本打開,如下所示:
4. 發送電子郵件
發送郵件首先需要有一個郵箱賬號和密碼,本文以網易163郵箱為例,郵箱賬號必須要開啟 smtp 服務,在瀏覽器網頁登錄郵箱后一般在郵箱的“設置”選項中可以開啟,并記下郵箱的 smtp 服務器地址,如下所示(其他郵箱大同小異):
代碼實現:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
package com.xiets.javamaildemo; import javax.mail.session; import javax.mail.transport; import javax.mail.internet.internetaddress; import javax.mail.internet.mimemessage; import java.util.date; import java.util.properties; /** * javamail 版本: 1.6.0 * jdk 版本: jdk 1.7 以上(必須) */ public class main { // 發件人的 郵箱 和 密碼(替換為自己的郵箱和密碼) // ps: 某些郵箱服務器為了增加郵箱本身密碼的安全性,給 smtp 客戶端設置了獨立密碼(有的郵箱稱為“授權碼”), // 對于開啟了獨立密碼的郵箱, 這里的郵箱密碼必需使用這個獨立密碼(授權碼)。 public static string myemailpassword = "xxxxxxxxx" ; // 發件人郵箱的 smtp 服務器地址, 必須準確, 不同郵件服務器地址不同, 一般(只是一般, 絕非絕對)格式為: smtp.xxx.com // 網易163郵箱的 smtp 服務器地址為: smtp.163.com public static string myemailsmtphost = "smtp.163.com" ; // 收件人郵箱(替換為自己知道的有效郵箱) public static void main(string[] args) throws exception { // 1. 創建參數配置, 用于連接郵件服務器的參數配置 properties props = new properties(); // 參數配置 props.setproperty( "mail.transport.protocol" , "smtp" ); // 使用的協議(javamail規范要求) props.setproperty( "mail.smtp.host" , myemailsmtphost); // 發件人的郵箱的 smtp 服務器地址 props.setproperty( "mail.smtp.auth" , "true" ); // 需要請求認證 // ps: 某些郵箱服務器要求 smtp 連接需要使用 ssl 安全認證 (為了提高安全性, 郵箱支持ssl連接, 也可以自己開啟), // 如果無法連接郵件服務器, 仔細查看控制臺打印的 log, 如果有有類似 “連接失敗, 要求 ssl 安全連接” 等錯誤, // 打開下面 /* ... */ 之間的注釋代碼, 開啟 ssl 安全連接。 /* // smtp 服務器的端口 (非 ssl 連接的端口一般默認為 25, 可以不添加, 如果開啟了 ssl 連接, // 需要改為對應郵箱的 smtp 服務器的端口, 具體可查看對應郵箱服務的幫助, // qq郵箱的smtp(sll)端口為465或587, 其他郵箱自行去查看) final string smtpport = "465" ; props.setproperty( "mail.smtp.port" , smtpport); props.setproperty( "mail.smtp.socketfactory.class" , "javax.net.ssl.sslsocketfactory" ); props.setproperty( "mail.smtp.socketfactory.fallback" , "false" ); props.setproperty( "mail.smtp.socketfactory.port" , smtpport); */ // 2. 根據配置創建會話對象, 用于和郵件服務器交互 session session = session.getdefaultinstance(props); session.setdebug( true ); // 設置為debug模式, 可以查看詳細的發送 log // 3. 創建一封郵件 mimemessage message = createmimemessage(session, myemailaccount, receivemailaccount); // 4. 根據 session 獲取郵件傳輸對象 transport transport = session.gettransport(); // 5. 使用 郵箱賬號 和 密碼 連接郵件服務器, 這里認證的郵箱必須與 message 中的發件人郵箱一致, 否則報錯 // // ps_01: 成敗的判斷關鍵在此一句, 如果連接服務器失敗, 都會在控制臺輸出相應失敗原因的 log, // 仔細查看失敗原因, 有些郵箱服務器會返回錯誤碼或查看錯誤類型的鏈接, 根據給出的錯誤 // 類型到對應郵件服務器的幫助網站上查看具體失敗原因。 // // ps_02: 連接失敗的原因通常為以下幾點, 仔細檢查代碼: // (1) 郵箱沒有開啟 smtp 服務; // (2) 郵箱密碼錯誤, 例如某些郵箱開啟了獨立密碼; // (3) 郵箱服務器要求必須要使用 ssl 安全連接; // (4) 請求過于頻繁或其他原因, 被郵件服務器拒絕服務; // (5) 如果以上幾點都確定無誤, 到郵件服務器網站查找幫助。 // // ps_03: 仔細看log, 認真看log, 看懂log, 錯誤原因都在log已說明。 transport.connect(myemailaccount, myemailpassword); // 6. 發送郵件, 發到所有的收件地址, message.getallrecipients() 獲取到的是在創建郵件對象時添加的所有收件人, 抄送人, 密送人 transport.sendmessage(message, message.getallrecipients()); // 7. 關閉連接 transport.close(); } /** * 創建一封只包含文本的簡單郵件 * * @param session 和服務器交互的會話 * @param sendmail 發件人郵箱 * @param receivemail 收件人郵箱 * @return * @throws exception */ public static mimemessage createmimemessage(session session, string sendmail, string receivemail) throws exception { // 1. 創建一封郵件 mimemessage message = new mimemessage(session); // 2. from: 發件人(昵稱有廣告嫌疑,避免被郵件服務器誤認為是濫發廣告以至返回失敗,請修改昵稱) message.setfrom( new internetaddress(sendmail, "某寶網" , "utf-8" )); // 3. to: 收件人(可以增加多個收件人、抄送、密送) message.setrecipient(mimemessage.recipienttype.to, new internetaddress(receivemail, "xx用戶" , "utf-8" )); // 4. subject: 郵件主題(標題有廣告嫌疑,避免被郵件服務器誤認為是濫發廣告以至返回失敗,請修改標題) message.setsubject( "打折鉅惠" , "utf-8" ); // 5. content: 郵件正文(可以使用html標簽)(內容有廣告嫌疑,避免被郵件服務器誤認為是濫發廣告以至返回失敗,請修改發送內容) message.setcontent( "xx用戶你好, 今天全場5折, 快來搶購, 錯過今天再等一年。。。" , "text/html;charset=utf-8" ); // 6. 設置發件時間 message.setsentdate( new date()); // 7. 保存設置 message.savechanges(); return message; } } |
發送后查看收件人的收件箱:
包含文本、圖片、附件 的復雜郵件的創建請看下一篇:基于 javamail 的 java 郵件發送:復雜郵件發送
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持服務器之家。
原文鏈接:http://blog.csdn.net/xietansheng/article/details/51673073