SpringBoot3整合郵件服務(wù)實現(xiàn)郵件發(fā)送功能

更新時間：2024年05月28日 09:39:08 作者：蒾酒

本文介紹了spring boot整合email服務(wù),實現(xiàn)發(fā)送驗證碼,郵件（普通文本郵件、靜態(tài)資源郵件、附件郵件）,文中通過代碼示例介紹的非常詳細,堅持看完相信對你有幫助,需要的朋友可以參考下

內(nèi)容概要

本文介紹了spring boot整合email服務(wù)，實現(xiàn)發(fā)送驗證碼，郵件（普通文本郵件、靜態(tài)資源郵件、附件郵件）。

開通服務(wù)

實現(xiàn)email服務(wù)需要先將自己的郵箱開通POP3/IMAP服務(wù)才可以通過該郵箱發(fā)送郵件，開通步驟如下：

這里以QQ郵箱為例

1.進入QQ郵箱官網(wǎng)

登錄QQ郵箱

2.登錄后點擊設(shè)置

3.選擇賬號

找到 POP3/IMAP.....服務(wù)這里開啟你的服務(wù)，這里我已經(jīng)開啟了的。

4.開啟服務(wù)

開啟成功會得到授權(quán)碼，記住這個授權(quán)碼。下面開始在spring boot中整合。

spring boot整合

1.依賴引入

pom.xml:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>

2.配置屬性

application.yml：

修改成你自己的實際信息。

spring:
  #郵件服務(wù)配置
  mail:
    host: smtp.qq.com #郵件服務(wù)器地址
    protocol: smtp #協(xié)議
    username: 305462*****@qq.com #發(fā)送郵件的郵箱也就是你開通服務(wù)的郵箱
    password: fiwvcy******d #開通服務(wù)后得到的授權(quán)碼
    default-encoding: utf-8 #郵件內(nèi)容的編碼

3.創(chuàng)建郵件發(fā)送工具類

使用@component注解標記為組件，可以在Service中注入使用。

里面一共定義了三種發(fā)送郵件方法：

發(fā)送純文本的普通郵件，可以發(fā)送一些純文本的消息以及驗證碼內(nèi)容。
發(fā)送HTML格式的文本內(nèi)容，可以發(fā)一些靜態(tài)資源，圖片，音頻，視頻等，也可以發(fā)驗證碼信息。
發(fā)送攜帶附件的郵件，比如word,excel,pdf文檔或者其他文件。

具體可以根據(jù)業(yè)務(wù)需求調(diào)整代碼。我實現(xiàn)的較為簡單可以當(dāng)個模板使用。

import jakarta.annotation.Resource;
import jakarta.mail.internet.MimeMessage;
import lombok.SneakyThrows;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.FileSystemResource;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Component;
 
import java.io.File;
import java.util.Objects;
 
/**
 * @author mijiupro
 */
@Component
public class EmailUtil {
    @Resource
    private JavaMailSender mailSender;
 
    @Value("${spring.mail.username}")
    private String from ;// 發(fā)件人
 
    /**
     * 發(fā)送一般郵件--無附件
     * @param to 收件人
     * @param subject 主題
     * @param content 內(nèi)容
     * @return 是否成功
     */
    @SneakyThrows(Exception.class)
    public boolean sendGeneralEmail(String subject, String content, String... to){
        // 創(chuàng)建郵件消息
        org.springframework.mail.SimpleMailMessage message = new org.springframework.mail.SimpleMailMessage();
        message.setFrom(from);
        // 設(shè)置收件人
        message.setTo(to);
        // 設(shè)置郵件主題
        message.setSubject(subject);
        // 設(shè)置郵件內(nèi)容
        message.setText(content);
 
        // 發(fā)送郵件
        mailSender.send(message);
 
        return true;
    }
    /**
     * 發(fā)送帶附件的郵件
     * @param to 收件人
     * @param subject 主題
     * @param content 內(nèi)容
     * @param filePaths 附件路徑
     * @return 是否成功
     */
    @SneakyThrows(Exception.class)
    public boolean sendAttachmentsEmail(String subject, String content, String[] to, String[] filePaths) {
        // 創(chuàng)建郵件消息
        MimeMessage mimeMessage = mailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
        helper.setFrom(from);
        // 設(shè)置收件人
        helper.setTo(to);
        // 設(shè)置郵件主題
        helper.setSubject(subject);
        // 設(shè)置郵件內(nèi)容
        helper.setText(content);
 
        // 添加附件
        if (filePaths != null) {
            for (String filePath : filePaths) {
                FileSystemResource file = new FileSystemResource(new File(filePath));
                helper.addAttachment(Objects.requireNonNull(file.getFilename()), file);
 
            }
        }
        // 發(fā)送郵件
        mailSender.send(mimeMessage);
        return true;
    }
 
    /**
     * 發(fā)送帶靜態(tài)資源的郵件
     * @param to 收件人
     * @param subject 主題
     * @param content 內(nèi)容
     * @param rscPath 靜態(tài)資源路徑
     * @param rscId 靜態(tài)資源id
     * @return 是否成功
     */
    @SneakyThrows(Exception.class)
    public boolean sendInlineResourceEmail(String subject, String content, String to, String rscPath, String rscId) {
        // 創(chuàng)建郵件消息
        MimeMessage mimeMessage = mailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
        // 設(shè)置發(fā)件人
        helper.setFrom(from);
        // 設(shè)置收件人
        helper.setTo(to);
        // 設(shè)置郵件主題
        helper.setSubject(subject);
 
        //html內(nèi)容圖片
        String contentHtml = "<html><body>這是郵件的內(nèi)容，包含一個圖片：<img src=\'cid:" + rscId + "\'>"+content+"</body></html>";
 
        helper.setText(contentHtml, true);
        //指定講資源地址
        FileSystemResource res = new FileSystemResource(new File(rscPath));
        helper.addInline(rscId, res);
 
        mailSender.send(mimeMessage);
        return true;
    }
 
}

4.編寫測試用例測試

下面測試前兩種發(fā)送郵件的方法。

測試發(fā)送普通文本郵件

import com.mijiu.commom.util.EmailUtil;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
 
@SpringBootTest
public class EmailTest {
    @Autowired
    private EmailUtil emailUtil;
 
 
    @Test
    public void sendEmail() {
        //發(fā)送郵件
        boolean b = emailUtil.sendGeneralEmail("測試郵件", " 這是測試郵件", "你的郵箱@163.com");
        System.out.println(b);
    }
}

修改成發(fā)送目標郵箱運行代碼測試即可。

測試成功。

測試發(fā)送圖片郵件

import com.mijiu.commom.util.EmailUtil;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
 
@SpringBootTest
public class EmailTest {
    @Autowired
    private EmailUtil emailUtil;
 
 
    @Test
    public void sendEmail() {
 
        // 發(fā)送圖片郵件
        boolean b = emailUtil.sendInlineResourceEmail("測試郵件", " 這是測試郵件", "你的郵箱@163.com",
                "C:\\Users\\mijiupro\\Desktop\\潮.jpg", "C:\\Users\\mijiupro\\Desktop\\潮.jpg");
        System.out.println(b);
    }
}