SpringBoot整合Javamail实现邮件发送功能

说明：邮件发送是一个很普遍的功能，springboot整合了相关的starter，以下方式可以实现一个简单的邮件发送功能。

1、引入依赖

• mail依赖，发送邮件使用
• test依赖，测试使用

<!-- email -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>
</dependency>
<!-- test -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>compile</scope>
</dependency>

2、配置yml文件

spring:
  mail:
    host: smtp.qq.com
    port: 25
    protocol: smtp
    username: 123456789@qq.com
    password: oujhlavdjhirgiee  
    default-encoding: UTF-8

注意：password属性是邮箱授权码，用于第三方接口调用使用， 而不是邮箱登录密码，需要登录邮箱查看或者申请获取。下面是qq邮箱授权码获取方式（设置->账号->账号安全）

3、编写测试代码

这里主要测试了发送两种格式的邮件，一种是纯文字的邮件，另一种是带有附件的邮件。

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.core.io.FileSystemResource;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.JavaMailSenderImpl;
import org.springframework.mail.javamail.MimeMessageHelper;
import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
import java.util.Properties;

@SpringBootTest
class EmailUtilsTest {

    // 发件人邮箱
    @Value("${spring.mail.username}")
    private String mailFrom;

    // 收件人邮箱
    private static String MAIL_TO = "zhangsan123@163.com";

    // 测试发送PDF文件的路径
    private static String PDF_PATH = "E:\\test.pdf";

    @Autowired
    private JavaMailSender mailSender;

    /**
     * 测试发送文字内容
     */
    @Test
    void testSendText() {
        // 邮件标题
        String subject = "测试邮件";
        // 邮件文字内容
        String textContent = "你好，这是测试邮件4";
        MimeMessage message = mailSender.createMimeMessage();
        try {
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(mailFrom);
            helper.setTo(MAIL_TO);
            helper.setSubject(subject);
            helper.setText(textContent, true);
            mailSender.send(message);
        } catch (MessagingException e) {
            throw new RuntimeException(e);
        }
    }

    /**
     * 测试发送文件内容
     */
    @Test
    void testSendFile() {
        // 邮件标题
        String subject = "一份测试发送的PDF文件";
        // 邮件文本内容
        String textContent = "这是您的文件，请注意查收";
        // 邮件文件内容
        FileSystemResource pdfFile = new FileSystemResource(PDF_PATH);
        // 文件名字
        String fileName = "测试文件.pdf";
        MimeMessage message = mailSender.createMimeMessage();
        try {
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(mailFrom);
            helper.setTo(MAIL_TO);
            helper.setSubject(subject);
            helper.setText(textContent, true);
            // 如果一次要发送多个附件， 只需要添加多个 helper.addAttachment() 即可
            helper.addAttachment(fileName, pdfFile);
            mailSender.send(message);
        } catch (MessagingException e) {
            throw new RuntimeException(e);
        }
    }

    /**
     * 扩展： 不使用yml文件， 使用对象的方式设置属性值
     */
    @Test
    void testSendFileNoYml() {
        // 邮件标题
        String subject = "一份测试发送的PDF文件";
        // 邮件文本内容
        String textContent = "这是您的文件，请注意查收";
        // 邮件文件内容
        FileSystemResource pdfFile = new FileSystemResource(PDF_PATH);
        // 文件名字
        String fileName = "测试文件.pdf";
        // 获取自定义属性的sender
        JavaMailSender javaMailSender = getJavaMailSender();
        MimeMessage message = javaMailSender.createMimeMessage();
        try {
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(mailFrom);
            helper.setTo(MAIL_TO);
            helper.setSubject(subject);
            helper.setText(textContent, true);
            // 如果一次要发送多个附件， 只需要添加多个 helper.addAttachment() 即可
            helper.addAttachment(fileName, pdfFile);
            mailSender.send(message);
        } catch (MessagingException e) {
            throw new RuntimeException(e);
        }
    }

    /**
     * 获取自定义的属性的 JavaMailSender 对象
     * @return JavaMailSender
     */
    public JavaMailSender getJavaMailSender(){
        JavaMailSenderImpl javaMailSender = new JavaMailSenderImpl();
        // 设置发送的服务器ip （qq：smtp.qq.com   网易：smtp.126.com）
        javaMailSender.setHost("qq：smtp.qq.com");
        javaMailSender.setUsername("1454376161@qq.com");
        // 邮箱授权码
        javaMailSender.setPassword("oujhldvdjhirgiea");
        // 设置端口（默认25, 或者设置456）
        javaMailSender.setPort(465);
        // 设置编码方式，避免常出现乱码 
        javaMailSender.setDefaultEncoding("UTF-8");
        
        //其他属性
        Properties p = new Properties();
        p.setProperty("mail.smtp.auth", "true");
        p.setProperty("mail.smtp.ssl", "true");
        p.setProperty("mail.smtp.socketFactory.port", "465");
        p.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
        p.setProperty("mail.smtp.starttls.enable", "true");
        p.setProperty("mail.smtp.starttls.required", "true");
        javaMailSender.setJavaMailProperties(p);
        return javaMailSender;
    }
}