簡單介紹

JavaMail是SUN公司提供給廣大Java開發人員的一款郵件傳送和接收的開源類庫，支援常用的郵件協議，如：SMTP、POP3、IMAP，開發人員使用JavaMail編寫郵件程式時，不再需要考慮底層的通訊細節如：Socket，而是關注在邏輯層面。JavaMail可以傳送各種複雜MIME格式的郵件內容，注意JavaMail僅支援JDK4及以上版本。

構建專案

本章專案無關Web相關內容，所以建立專案時選擇Jar形式建立。雖然JavaMail是JDK的API但它並沒有直接加入JDK中，所以我們需要另外新增依賴。

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <!-- JavaMail依賴 -->
        <dependency>
            <groupId>javax.mail</groupId>
            <artifactId>mail</artifactId>
            <version>1.4
 
.7</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
 

封裝JavaMail

1、編寫實體類MailEntity來儲存傳送郵件時需要的引數欄位

public class MailEntity implements Serializable{
    //此處填寫SMTP伺服器
    private String smtpService;
    //設定埠號
    private String smtpPort;
    //設定傳送郵箱
    private String fromMailAddress;
    // 設定傳送郵箱的STMP口令
    private String fromMailStmpPwd;
    //設定郵件標題
    private
 
 String title;
    //設定郵件內容
    private String content;
    //內容格式（預設採用html）
    private String contentType;
    //接受郵件地址集合
    private List<String> list = new ArrayList<>();

    get/set...

2、建立一個郵件傳送者實體MailSender來配置傳送郵件引數以及執行傳送郵件

public class MailSender {
    private static MailEntity mail = new MailEntity(); //郵件實體
    //設定郵件標題
    public MailSender title(String title){
        mail.setTitle(title);
        return this;
    }
    //設定郵件內容
    public MailSender content(String content)
    {
        mail.setContent(content);
        return this;
    }
    //設定郵件格式
    public MailSender contentType(MailContentTypeEnum typeEnum)
    {
        mail.setContentType(typeEnum.getValue());
        return this;
    }
    //設定請求目標郵件地址
    public MailSender targets(List<String> targets)
    {
        mail.setList(targets);
        return this;
    }
    /**
     * 執行傳送郵件
     * @throws Exception 如果傳送失敗會丟擲異常資訊
     */
    public void send() throws Exception
    {
        //預設使用html內容傳送
        if(mail.getContentType() == null)
            mail.setContentType(MailContentTypeEnum.HTML.getValue());

        if(mail.getTitle() == null || mail.getTitle().trim().length() == 0)
        {
            throw new Exception("郵件標題沒有設定.呼叫title方法設定");
        }

        if(mail.getContent() == null || mail.getContent().trim().length() == 0)
        {
            throw new Exception("郵件內容沒有設定.呼叫content方法設定");
        }
        if(mail.getList().size() == 0)
        {
            throw new Exception("沒有接受者郵箱地址.呼叫targets方法設定");
        }
        //讀取/resource/mail_zh_CN.properties檔案內容
        final PropertiesUtil properties = new PropertiesUtil("mail");
        // 建立Properties 類用於記錄郵箱的一些屬性
        final Properties props = new Properties();
        // 表示SMTP傳送郵件，必須進行身份驗證
        props.put("mail.smtp.auth", "true");
        //此處填寫SMTP伺服器
        props.put("mail.smtp.host", properties.getValue("mail.smtp.service"));
        //設定埠號，QQ郵箱給出了兩個埠465/587
        props.put("mail.smtp.port", properties.getValue("mail.smtp.prot"));
        // 設定傳送郵箱
        props.put("mail.user", properties.getValue("mail.from.address"));
        // 設定傳送郵箱的16位STMP口令
        props.put("mail.password", properties.getValue("mail.from.smtp.pwd"));

        // 構建授權資訊，用於進行SMTP進行身份驗證
        Authenticator authenticator = new Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                // 使用者名稱、密碼
                String userName = props.getProperty("mail.user");
                String password = props.getProperty("mail.password");
                return new PasswordAuthentication(userName, password);
            }
        };
        // 使用環境屬性和授權資訊，建立郵件會話
        Session mailSession = Session.getInstance(props, authenticator);
        // 建立郵件訊息
        MimeMessage message = new MimeMessage(mailSession);
        // 設定發件人
        String nickName = MimeUtility.encodeText(properties.getValue("mail.from.nickname"));
        InternetAddress form = new InternetAddress(nickName + " <" + props.getProperty("mail.user") + ">");
        message.setFrom(form);
        // 設定郵件標題
        message.setSubject(mail.getTitle());
        //html傳送郵件
        if(mail.getContentType().equals(MailContentTypeEnum.HTML.getValue())) {
            // 設定郵件的內容體
            message.setContent(mail.getContent(), mail.getContentType());
        }
        //文字傳送郵件
        else if(mail.getContentType().equals(MailContentTypeEnum.TEXT.getValue())){
            message.setText(mail.getContent());
        }
        //傳送郵箱地址
        List<String> targets = mail.getList();
        for(int i = 0;i < targets.size();i++){
            try {
                // 設定收件人的郵箱
                InternetAddress to = new InternetAddress(targets.get(i));
                message.setRecipient(Message.RecipientType.TO, to);
                // 最後當然就是傳送郵件啦
                Transport.send(message);
            }catch (Exception e)
            {
                continue;
            }

        }
    }
}

3、定義一個列舉型別MailContentTypeEnum包含了郵件內容的型別，目前我只添加了html和text這兩種形式。

public enum MailContentTypeEnum {
    HTML("text/html;charset=UTF-8"), TEXT("text");
    private String value;

    MailContentTypeEnum(String value) {
        this.value = value;
    }

    public String getValue() {
        return value;
    }
}

4、建立工具類PropertiesUtil
PropertiesUtil用於讀取*.properties配置檔案的工具類，使用JavaMail需要配置SMTP以及使用者名稱、密碼等也就是MailEntity內的欄位，那麼我們在/resource目錄下建立一個名字叫mail.properties的配置檔案，裡面存放我們定義的郵件傳送引數配置，這樣方便修改

public class PropertiesUtil {
    private final ResourceBundle resource;
    private final String fileName;

    //建構函式例項化部分物件，獲取檔案資源物件
    public PropertiesUtil(String fileName)
    {
        this.fileName = fileName;
        Locale locale = new Locale("zh", "CN");
        this.resource = ResourceBundle.getBundle(this.fileName, locale);
    }
    /**
     * 根據傳入的key獲取物件的值
     * @param key properties檔案對應的key
     * @return String 解析後的對應key的值
     */
    public String getValue(String key)
    {
        String message = this.resource.getString(key);
        return message;
    }

    //獲取properties檔案內的所有key值
    public Enumeration<String> getKeys(){
        return resource.getKeys();
    }
}

mail.properties

mail.smtp.service=smtp.qq.com
mail.smtp.prot=587
mail.from.address=123@qq.com
mail.from.smtp.pwd=***********
mail.from.nickname=Mir Li

注意：如果第一次使用QQ郵箱的SMTP服務，請點選“開啟”POP3以及SMTP服務並且按照提示步驟完成獲取“授權碼”即可，授權碼就是傳送郵件引數的smtp.pwd屬性。

測試郵件傳送

建立一個TestMail類來作為測試入口，因為我們的專案是jar形式，所以我們直接新建一個main方法直接呼叫傳送郵件就可以了。

public class TestMail {
    public static void main(String[] args) throws Exception
    {
        new MailSender()
                .title("測試SpringBoot傳送郵件")
                .content("簡單文字內容傳送")
                .contentType(MailContentTypeEnum.TEXT)
                .targets(new ArrayList<String>(){{
                    add("[email protected]");
                }})
                .send();
    }
}

如果暱稱出現亂碼：修改InteiiJ IDEA工具的properties檔案的編碼，點選File->Setting->Editor->File Encodings將下面的Default encoding設定為UTF-8即可。
中文轉換ASCII碼可以訪問tool.oschina.net/encode線上轉換

總結

上述內容就是本章的所有講解，本章主要講解了在SpringBoot專案內是如何使用JavaMail來進行傳送簡單郵件，簡單封裝了下MailSender類以及物件實體MailEntity，如果需要傳送HTML內容的郵件修改contentType(MailContentTypeEnum.HTML)然後content(“html程式碼”)即可。