1. 程式人生 > >基於JavaMail的簡單郵件傳送

基於JavaMail的簡單郵件傳送

電子郵件的應用非常廣泛,例如在某網站註冊了一個賬戶,自動傳送一封歡迎郵件,通過郵件找回密碼,自動批量傳送活動資訊等。但這些應用不可能和我們自己平時發郵件一樣,先開啟瀏覽器,登入郵箱,建立郵件再發送。本文將簡單介紹如何通過 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 包:

javaxmail.png

我把 JavaMail 1.6.0 的 jar 包上傳到了 CSDN,如果無法從 Github 下載,可以從 CSDN 下載(建議到Github下載,CSDN上我設了積分):

http://download.csdn.net/download/xietansheng/9928266

特別注意:

  • 本測試用例用的 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 作為類庫加入工程,這裡不多說。

郵件建立步驟:

    1.建立一個郵件物件(MimeMessage);
    2.設定發件人,收件人,可選增加多個收件人,抄送人,密送人;
    3.設定郵件的主題(標題);
    4.設定郵件的正文(內容);
    5.設定顯示的傳送時間;
    6.儲存到本地。

程式碼實現:

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.getInstance(props);        // 根據引數配置,建立會話物件(為了傳送郵件準備的)
        MimeMessage message = new MimeMessage(session);     // 建立郵件物件

        /*
         * 也可以根據已有的eml郵件檔案建立 MimeMessage 物件
         * MimeMessage message = new MimeMessage(session, new FileInputStream("MyEmail.eml"));
         */

        // 2. From: 發件人
        //    其中 InternetAddress 的三個引數分別為: 郵箱, 顯示的暱稱(只用於顯示, 沒有特別的要求), 暱稱的字符集編碼
        //    真正要傳送時, 郵箱必須是真實有效的郵箱。
        message.setFrom(new InternetAddress("[email protected]", "USER_AA", "UTF-8"));

        // 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進行了編碼),也可用記事本開啟,如下所示:

my-email.png

my-email-txt.png

4. 傳送電子郵件

傳送郵件首先需要有一個郵箱賬號和密碼,本文以網易163郵箱為例,郵箱賬號必須要開啟 SMTP 服務,在瀏覽器網頁登入郵箱後一般在郵箱的“設定”選項中可以開啟,並記下郵箱的 SMTP 伺服器地址,如下所示(其他郵箱大同小異):

smtp-163-setting.jpg

程式碼實現:

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 myEmailAccount = "[email protected]";
    public static String myEmailPassword = "xxxxxxxxx";

    // 發件人郵箱的 SMTP 伺服器地址, 必須準確, 不同郵件伺服器地址不同, 一般(只是一般, 絕非絕對)格式為: smtp.xxx.com
    // 網易163郵箱的 SMTP 伺服器地址為: smtp.163.com
    public static String myEmailSMTPHost = "smtp.163.com";

    // 收件人郵箱(替換為自己知道的有效郵箱)
    public static String receiveMailAccount = "[email protected]";

    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.getInstance(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;
    }

}

傳送後檢視收件人的收件箱:

sended-email.jpg

包含文字、圖片、附件 的複雜郵件的建立請看下一篇:基於 JavaMail 的 Java 郵件傳送:複雜郵件傳送
--------------------- 
作者:xietansheng 
來源:CSDN 
原文:https://blog.csdn.net/xietansheng/article/details/51673073