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

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 包:

javax.mail.png

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("
[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(); } }

 

  • 57

儲存的 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; 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.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; } }

 

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

sended-email.jpg

 

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("[email protected]", "[email protected]", "一個帶附件的JavaMail郵件");
        // 設定要傳送附件的位置和標題
        cn.setAffix("f:/123.txt", "123.txt");
        
        /**
         * 設定smtp伺服器以及郵箱的帳號和密碼
         * 用QQ 郵箱作為發生者不好使 (原因不明)
         * 163 郵箱可以,但是必須開啟  POP3/SMTP服務 和 IMAP/SMTP服務
         * 因為程式屬於第三方登入,所有登入密碼必須使用163的授權碼
         */
        cn.send("smtp.163.com", "[email protected]", "gebilaowang123");

    }
}