資源連結

Commons Email 官網地址

Commons Email API 文件

碼雲上的專案原始碼

• email

Commons Email簡介

  公用電子郵件的目標是提供一個傳送電子郵件的API。它是建立在Java郵件API之上的，它的目標是簡化。

• SimpleEmail - 這個類用於傳送基本的基於文字的電子郵件。

• MultiPartEmail - 該類用於傳送多部分訊息。這允許帶有附件的文字訊息或附件或附件。

• HtmlEmail - 這個類用於傳送HTML格式的電子郵件。它具有作為多部分電子郵件的所有功能，可以方便地新增附件。它還支援嵌入的影象。

• ImageHtmlEmail - 這個類用於傳送帶有內聯影象的HTML格式的電子郵件。它具有HtmlEmail的所有功能，但是將所有的影象引用轉換為內聯影象。

• EmailAttachment - 這是一個簡單的容器類，可以方便地處理附件。它適用於多部分電子郵件和HtmlEmail的例項。

Commons Email 的配置

  這個的基礎配置很簡單，就一個Maven依賴項，如下：

    <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>
 
commons-email</artifactId>
      <version>1.5</version>
    </dependency>

Commons Email 的用法

開通POP3/SMTP服務

  在使用該Maven依賴傳送電子郵件之前，我們先確保傳送的電子郵件提供方已經開通了“POP3/SMTP服務”，如果沒有開通的話可以參考下面的方法。

  我這裡是以網易郵箱為例來進行的說明。

  首先是登入電子郵箱首頁，如下：

  找到圖示的【設定】按鈕，點選後在彈出的下拉列表框中選擇“POP3/SMTP/IMAP”選項。

  在彈出的頁面中，選中“ POP3/SMTP服務”複選框，點選圖示的【儲存】按鈕即可。

傳送電子郵件原始碼

Mail原始碼：

package com.lyc.email;

import lombok.*;

import java.util.Set;

@Getter
@Setter
@Builder
public class Mail {

    private String subject;

    private String message;

    private Set<String> receivers;
}

MailAction原始碼：

package com.lyc.email;

import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.HtmlEmail;

@Slf4j
public class MailAction {

    public static boolean send(Mail mail) {
        //傳送方電子郵件地址
        String from = "[email protected]";
        //傳送的埠號
        int port = 25;
        //傳送的主機地址（需要開通pop3服務）
        String host = "smtp.163.com";
        //傳送方電子郵件密碼
        String pass = "password";
        //傳送方暱稱
        String nickname = "zhangzhenyi";

        HtmlEmail email = new HtmlEmail();
        try {
            email.setHostName(host);
            email.setCharset("UTF-8");
            for (String str : mail.getReceivers()) {
                email.addTo(str);
            }
            email.setFrom(from, nickname);
            email.setSmtpPort(port);
            email.setAuthentication(from, pass);
            email.setSubject(mail.getSubject());
            email.setMsg(mail.getMessage());
            email.send();
            log.info("{} 傳送郵件到 {}", from, StringUtils.join(mail.getReceivers(), ","));
            return true;
        } catch (EmailException e) {
            log.error(from + "傳送郵件到" + StringUtils.join(mail.getReceivers(), ",") + "失敗", e);
            return false;
        }
    }

}

測試程式碼MailTest原始碼：

package com.lyc.mail;

import com.lyc.email.Mail;
import com.lyc.email.MailAction;
import org.junit.Assert;
import org.junit.Test;

import java.util.HashSet;
import java.util.Set;

public class MailTest {

    @Test
    public void test(){
        //新增接收者電子郵件地址
        Set<String> receivers = new HashSet<String>();
        receivers.add("[email protected]");
        Mail mail = Mail.builder()
                .subject("異常資訊標題")   //傳送的電子郵件標題
                .message("異常資訊內容")   //傳送的電子郵件內容
                .receivers(receivers).build();
        //斷言傳送的電子郵件是否成功
        Assert.assertEquals(true,MailAction.send(mail));
    }

}

測試的結果：