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

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

1、引入依赖
  • mail依赖,发送邮件使用

  • test依赖,测试使用

    <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency> <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;
    }
}
相关推荐
聪明的笨猪猪21 小时前
Java Redis “Sentinel(哨兵)与集群”面试清单(含超通俗生活案例与深度理解)
java·经验分享·笔记·面试
222you21 小时前
Mybatis(1)
java·tomcat·mybatis
渣哥21 小时前
三级缓存揭秘:Spring 如何优雅地处理循环依赖问题
javascript·后端·面试
靠近彗星21 小时前
1.5操作系统引导
java·linux·服务器·操作系统
xuejianxinokok21 小时前
Postgres 18 的新功能
后端·postgresql
渣哥21 小时前
为什么几乎所有 Java 项目都离不开 IoC?Spring 控制反转的优势惊人!
javascript·后端·面试
用户38568033499621 小时前
appium从入门到精通php,移动端自动化测试Appium 从入门到项目实战Python版
后端
瑶山1 天前
社区版Idea怎么创建Spring Boot项目?Selected Java version 17 is not supported. 问题解决
java·spring boot·intellij-idea·创建项目
学习编程的Kitty1 天前
JavaEE初阶——多线程(1)初识线程与创建线程
java·开发语言·java-ee
陈小桔1 天前
SpringBoot之配置文件
spring boot