Java 基於JavaMail的郵件發送

http://blog.csdn.net/xietansheng/article/details/51673073

http://blog.csdn.net/xietansheng/article/details/51722660

 

 

電子郵件的應用非常廣泛，例如在某網站注冊了一個賬戶，自動發送一封歡迎郵件，通過郵件找回密碼，自動批量發送活動信息等。但這些應用不可能和我們自己平時發郵件一樣，先打開瀏覽器，登錄郵箱，創建郵件再發送。本文將簡單介紹如果通過 Java 代碼來創建電子郵件，並連接郵件服務器發送郵件。

1. 電子郵件協議

電子郵件的在網絡中傳輸和網頁一樣需要遵從特定的協議，常用的電子郵件協議包括 SMTP，POP3，IMAP。其中郵件的創建和發送只需要用到 SMTP協議，所有本文也只會涉及到SMTP協議。SMTP 是 Simple Mail Transfer Protocol 的簡稱，即簡單郵件傳輸協議。

2. JavaMail

我們平時通過 Java 代碼打開一個 http 網頁鏈接時，通常可以使用已經對 http 協議封裝好的 HttpURLConnection 類來快速地實現。Java 官方也提供了對電子郵件協議封裝的 Java 類庫，就是JavaMail，但並沒有包含到標准的 JDK 中，需要我們自己去 Java 或 Oracle 官網下載。

下載地址: 
https://java.net/projects/javamail/pages/Home 
或者 
http://www.oracle.com/technetwork/java/javamail/index.html

這里我從 java.NET 網站中下載一個最新的，包含了 SMTP, IMAP, 和 POP3 協議的實現的 jar 包:

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; 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 的三個參數分別為: 郵箱, 顯示的昵稱(只用於顯示, 沒有特別的要求), 昵稱的字符集編碼 // 真正要發送時, 郵箱必須是真實有效的郵箱。 message.setFrom(new InternetAddress("[e-mail]", "USER_AA", "UTF-8")); // 3. To: 收件人 message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress("[e-mail]", "USER_CC", "UTF-8")); // To: 增加收件人（可選） message.addRecipient(MimeMessage.RecipientType.TO, new InternetAddress("[e-mail]", "USER_DD", "UTF-8")); // Cc: 抄送（可選） message.setRecipient(MimeMessage.RecipientType.CC, new InternetAddress("[e-mail]", "USER_EE", "UTF-8")); // Bcc: 密送（可選） message.setRecipient(MimeMessage.RecipientType.BCC, new InternetAddress("[e-mail]", "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 服務器地址，如下所示（其他郵箱大同小異）:

代碼實現:

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; public class Main { // 發件人的 郵箱 和 密碼（替換為自己的郵箱和密碼） // PS: 某些郵箱服務器為了增加郵箱本身密碼的安全性，給 SMTP 客戶端設置了獨立密碼（有的郵箱稱為“授權碼”）, // 對於開啟了獨立密碼的郵箱, 這里的郵箱密碼必需使用這個獨立密碼（授權碼）。 public static String myEmailAccount = "[e-mail]"; 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 = "[e-mail]"; 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; } }

 

發送后查看收件人的收件箱:

 

DEMO

 

package com.suntray.test;

import javax.mail.BodyPart;
import javax.mail.Message;
import javax.mail.Multipart;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.*;
import java.util.*;
import javax.activation.*;

public class MailUtils {

    private String host = ""; // smtp服務器
    private String from = ""; // 發件人地址
    private String to = ""; // 收件人地址
    private String affix = ""; // 附件地址
    private String affixName = ""; // 附件名稱
    private String user = ""; // 用戶名
    private String pwd = ""; // 密碼
    private String subject = ""; // 郵件標題

    public void setAddress(String from, String to, String subject) {
        this.from = from;
        this.to = to;
        this.subject = subject;
    }

    public void setAffix(String affix, String affixName) {
        this.affix = affix;
        this.affixName = affixName;
    }

    public void send(String host, String user, String pwd) {
        this.host = host;
        this.user = user;
        this.pwd = pwd;

        Properties props = new Properties();

        // 設置發送郵件的郵件服務器的屬性（這里使用網易的smtp服務器）
        props.put("mail.smtp.host", host);
        // 需要經過授權，也就是有戶名和密碼的校驗，這樣才能通過驗證（一定要有這一條）
        props.put("mail.smtp.auth", "true");

        // 用剛剛設置好的props對象構建一個session
        Session session = Session.getDefaultInstance(props);

        // 有了這句便可以在發送郵件的過程中在console處顯示過程信息，供調試使
        // 用（你可以在控制台（console)上看到發送郵件的過程）
        session.setDebug(true);

        // 用session為參數定義消息對象
        MimeMessage message = new MimeMessage(session);
        try {
            // 加載發件人地址
            message.setFrom(new InternetAddress(from));
            // 加載收件人地址
            message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
            // 加載標題
            message.setSubject(subject);

            // 向multipart對象中添加郵件的各個部分內容，包括文本內容和附件
            Multipart multipart = new MimeMultipart();

            // 設置郵件的文本內容
            BodyPart contentPart = new MimeBodyPart();
            contentPart.setText("郵件的具體內容在此");
            multipart.addBodyPart(contentPart);
            // 添加附件
            BodyPart messageBodyPart = new MimeBodyPart();
            DataSource source = new FileDataSource(affix);
            // 添加附件的內容
            messageBodyPart.setDataHandler(new DataHandler(source));
            // 添加附件的標題
            // 這里很重要，通過下面的Base64編碼的轉換可以保證你的中文附件標題名在發送時不會變成亂碼
            sun.misc.BASE64Encoder enc = new sun.misc.BASE64Encoder();
            messageBodyPart.setFileName("=?GBK?B?"
                    + enc.encode(affixName.getBytes()) + "?=");
            multipart.addBodyPart(messageBodyPart);

            // 將multipart對象放到message中
            message.setContent(multipart);
            // 保存郵件
            message.saveChanges();
            // 發送郵件
            Transport transport = session.getTransport("smtp");
            // 連接服務器的郵箱
            transport.connect(host, user, pwd);
            // 把郵件發送出去
            transport.sendMessage(message, message.getAllRecipients());
            transport.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        MailUtils cn = new MailUtils();
        // 設置發件人地址、收件人地址和郵件標題
        cn.setAddress("[e-mail]", "[e-mail]", "一個帶附件的JavaMail郵件");
        // 設置要發送附件的位置和標題
        cn.setAffix("f:/123.txt", "123.txt");
        
        /**
         * 設置smtp服務器以及郵箱的帳號和密碼
         * 用QQ 郵箱作為發生者不好使 （原因不明）
         * 163 郵箱可以，但是必須開啟  POP3/SMTP服務 和 IMAP/SMTP服務
         * 因為程序屬於第三方登錄，所有登錄密碼必須使用163的授權碼
         */
        cn.send("smtp.163.com", "[e-mail]", "gebilaowang123");

    }
}