SpringBoot实现发送邮件功能的三种方式

 更新时间:2025年07月15日 10:28:23   作者:白露与泡影  
本文详细介绍了如何在SpringBoot应用中使用JavaMailSender、JavaMailAPI和ApacheCommonsEmail库发送邮件,对比了它们的优缺点,并提供了示例代码和配置指导,需要的朋友可以参考下

SpringBoot 发送邮件的三种方式

  • Spring Framework提供的JavaMailSender(与 Spring 集成,推荐)
  • 使用JavaMail API来发送邮件(灵活,支持发送日程提醒)
  • Apache Commons Email 库(简便)

选择哪一种方案

  • 如果你的项目已经使用了Spring框架,并且只需进行基本的邮件发送,那么使用JavaMailSender可能是一个方便的选择。
  • 如果你对邮件发送有较高的控制要求,或者需要满足一些特殊场景的需求,那么直接使用JavaMail API可能更为合适。
  • 如果你希望在简洁的API和灵活性之间取得平衡,并且不介意引入外部库,那么Apache Commons Email库可能是一个中间的选择。

这里对比一下Spring Framework提供的JavaMailSender、使用JavaMail API、以及Apache Commons Email库的优缺点:

1. JavaMailSender (Spring Framework)

优点:

  • 集成性高: JavaMailSender是 Spring 的一部分,与Spring框架的其他部分紧密集成,可以方便地与Spring的其他功能一起使用。
  • 配置简单: Spring Boot 提供了自动配置,减少了配置的繁琐性。
  • 简化API: Spring 提供了更高层次的抽象,简化了发送邮件的过程,使得代码更加清晰和简洁。

缺点:

  • 灵活性较低: 对于一些特定和高级的需求,可能需要更直接地使用JavaMail API或其他库,因为Spring的抽象可能无法满足所有场景。
  • 较大的依赖: 如果你只是需要发送邮件,引入整个Spring框架可能会显得过于庞大,特别是对于一些小型项目。

2. JavaMail API

优点:

  • 灵活性高: JavaMail API 提供了更底层、更直接的控制,可以满足各种邮件发送需求。
  • 标准化: JavaMail API 是Java标准库的一部分,可移植性好,与Java平台集成度高。

缺点:

  • 繁琐: 使用JavaMail API编写代码可能较为繁琐,需要更多的代码量,尤其是对于一些简单的邮件发送场景。
  • 学习曲线: 对于新手来说,学习JavaMail API可能需要一些时间。

3. Apache Commons Email库

优点:

  • 简化API: Apache Commons Email 库提供了更简单的API,相比JavaMail API,可以更容易地发送各种类型的电子邮件,包括HTML邮件等。
  • 减少样板代码: 相比JavaMail API,Apache Commons Email库可以减少一些样板代码,使得代码更加简洁。

缺点:

  • 不如 JavaMail API灵活: 虽然简化了API,但相比JavaMail API,Apache Commons Email 库可能在某些高级场景下的灵活性有所减弱。
  • 依赖: 引入外部库可能增加项目的依赖。

JavaMailSender 示例

以下是一个简单的Spring Boot邮件发送的示例代码:

首先,确保你的Spring Boot项目中包含了Spring Boot Starter Mail库。在pom.xml中添加以下依赖:

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

然后,创建一个服务类来处理邮件发送:

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Service;
 
@Service
public class EmailService {
 
    @Autowired
    private JavaMailSender javaMailSender;
 
    public void sendEmail(String to, String subject, String text) {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setTo(to);
        message.setSubject(subject);
        message.setText(text);
 
        javaMailSender.send(message);
    }
}
 

接下来,在你的应用程序中,你可以使用EmailService类来发送电子邮件。以下是一个简单的示例控制器:

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
 
@RestController
@RequestMapping("/email")
public class EmailController {
 
    @Autowired
    private EmailService emailService;
 
    @GetMapping("/send")
    public String sendEmail(@RequestParam String to, @RequestParam String subject, @RequestParam String text) {
        emailService.sendEmail(to, subject, text);
        return "Email sent successfully!";
    }
}
 

在上述代码中,通过调用sendEmail方法,你可以发送一封包含指定主题和文本内容的电子邮件。

确保在application.propertiesapplication.yml文件中配置SMTP服务器的相关信息,例如:

  mail:
    host: smtp.163.com
    username: 邮箱名字
    password: 邮箱密码或者密钥
    port: 465
    protocol: smtp
    default-encoding: utf-8
    properties:
      mail:
        smtp:
          auth: true
          starttls:
            enable: true
            required: true
          ssl:
            enable: true
          socketFactory:
            port: 465
            class: javax.net.ssl.SSLSocketFactory

可以用 swagger 测试请求,也可以用 postman 工具测试。

测试结果如下:

使用JavaMail API来发送邮件

在Spring Boot应用程序中使用JavaMail API发送电子邮件。

添加依赖

在你的pom.xml文件中,添加以下依赖:

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

邮箱配置

确保在application.propertiesapplication.yml文件中配置SMTP服务器的相关信息,例如:

  mail:
    host: smtp.163.com
    username: 邮箱名字
    password: 邮箱密码或者密钥
    port: 465
    protocol: smtp
    default-encoding: utf-8
    properties:
      mail:
        smtp:
          auth: true
          starttls:
            enable: true
            required: true
          ssl:
            enable: true
          socketFactory:
            port: 465
            class: javax.net.ssl.SSLSocketFactory

编写发送邮件的代码

使用JavaMail API发送电子邮件。以下是一个简单的例子:

import javax.mail.*;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Properties;
 
@Service
public class EmailService {
 
    @Value("${spring.mail.username}")
    private String from;
 
    @Autowired
    private JavaMailSender javaMailSender;
 
    public void sendSimpleEmail(String to, String subject, String text) throws MessagingException {
        Properties properties = new Properties();
        properties.put("mail.smtp.auth", "true");
        properties.put("mail.smtp.starttls.enable", "true");
        properties.put("mail.smtp.host", "your_smtp_host");
        properties.put("mail.smtp.port", "your_smtp_port");
 
        Session session = Session.getInstance(properties, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(from, "your_email_password");
            }
        });
 
        Message message = new MimeMessage(session);
        message.setFrom(new InternetAddress(from));
        message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to));
        message.setSubject(subject);
        message.setText(text);
 
        Transport.send(message);
    }
}
 

使用服务类发送邮件:

@RestController
@RequestMapping("/email")
public class EmailController {
 
    @Autowired
    private EmailService emailService;
 
    @GetMapping("/send")
    public String sendEmail(@RequestParam String to, @RequestParam String subject, @RequestParam String text) {
        try {
            emailService.sendSimpleEmail(to, subject, text);
            return "Email sent successfully!";
        } catch (MessagingException e) {
            e.printStackTrace();
            return "Failed to send email.";
        }
    }
}
 

Apache Commons Email 库

添加依赖:

在你的pom.xml文件中,添加 Apache Commons Email库的依赖:

xmlCopy code
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-email</artifactId>
    <version>1.5</version> <!-- 替换为最新版本 -->
</dependency>

确保这个依赖被正确地添加到你的项目中。

配置SMTP服务器:

在你的application.propertiesapplication.yml文件中配置SMTP服务器的相关信息,例如:

propertiesCopy code
spring.mail.host=your_smtp_host
spring.mail.port=your_smtp_port
spring.mail.username=your_email@gmail.com
spring.mail.password=your_email_password
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true

编写发送邮件的代码

创建一个服务类,使用Apache Commons Email库发送电子邮件。以下是一个简单的例子:

import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.SimpleEmail;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
 
@Service
public class EmailService {
 
    @Value("${spring.mail.username}")
    private String from;
 
    public void sendSimpleEmail(String to, String subject, String text) throws EmailException {
        SimpleEmail email = new SimpleEmail();
        email.setHostName("your_smtp_host");
        email.setSmtpPort(Integer.parseInt("your_smtp_port"));
        email.setAuthenticator(new DefaultAuthenticator(from, "your_email_password"));
        email.setStartTLSEnabled(true);
 
        email.setFrom(from);
        email.addTo(to);
        email.setSubject(subject);
        email.setMsg(text);
 
        email.send();
    }
}

使用服务类发送邮件

在你的控制器或其他地方调用EmailService发送邮件:

javaCopy code
@RestController
@RequestMapping("/email")
public class EmailController {
 
    @Autowired
    private EmailService emailService;
 
    @GetMapping("/send")
    public String sendEmail(@RequestParam String to, @RequestParam String subject, @RequestParam String text) {
        try {
            emailService.sendSimpleEmail(to, subject, text);
            return "Email sent successfully!";
        } catch (EmailException e) {
            e.printStackTrace();
            return "Failed to send email.";
        }
    }
}

这样,你就可以使用Apache Commons Email库发送邮件了。确保替换配置中的实际值,并根据你的需求进行定制。

以上就是SpringBoot实现发送邮件功能的三种方式的详细内容,更多关于SpringBoot发送邮件方式的资料请关注脚本之家其它相关文章!

相关文章

  • Java实现非对称加密的三种方法

    Java实现非对称加密的三种方法

    本文主要介绍了Java实现非对称加密的三种方法,主要包括非对称加密算法--DH(密钥交换),非对称加密算法--RSA,非对称加密算法--EIGamal,具有一定的参考价值,感兴趣的可以了解一下
    2023-12-12
  • SpringBoot Docker镜像分层的优化指南

    SpringBoot Docker镜像分层的优化指南

    关于如何优化SpringBoot应用程序的Docker镜像构建 的,核心思想是:不要简单地把一个胖JAR包直接扔进Docker镜像里运行,而应该利用分层技术来提升镜像的构建效率和部署性能,所以本文给大家介绍了SpringBoot Docker镜像分层的优化指南,需要的朋友可以参考下
    2025-10-10
  • Java concurrency集合之LinkedBlockingDeque_动力节点Java学院整理

    Java concurrency集合之LinkedBlockingDeque_动力节点Java学院整理

    LinkedBlockingDeque是双向链表实现的双向并发阻塞队列。该阻塞队列同时支持FIFO和FILO两种操作方式,即可以从队列的头和尾同时操作(插入/删除);并且,该阻塞队列是支持线程安全。
    2017-06-06
  • Java数据结构之ArrayList从顺序表到实现

    Java数据结构之ArrayList从顺序表到实现

    Java中的ArrayList是一种基于数组实现的数据结构,支持动态扩容和随机访问元素,可用于实现顺序表等数据结构。ArrayList在内存中连续存储元素,支持快速的随机访问和遍历。通过学习ArrayList的实现原理和使用方法,可以更好地掌握Java中的数据结构和算法
    2023-04-04
  • RabbitMQ工作队列模式的使用解析

    RabbitMQ工作队列模式的使用解析

    文章介绍了RabbitMQ工作队列模式,通过多消费者竞争消费消息实现负载均衡,对比简单模式突出其分布式处理优势,详解轮询与公平分发策略,并提供环境配置、生产消费代码示例及运行分析,最后强调消息确认、持久化和动态扩容等使用技巧
    2025-08-08
  • java垃圾收集器与内存分配策略详解

    java垃圾收集器与内存分配策略详解

    本篇文章主要介绍了Java垃圾收集器与内存分配策略的方法和原理总结,Java垃圾回收器是Java虚拟机的重要模块,具有一定的参考价值,有兴趣的可以了解一下
    2021-08-08
  • Java中Queue以及Deque用法示例详解

    Java中Queue以及Deque用法示例详解

    在Java集合框架中Queue和Deque接口是两种重要的数据结构,它们用于存储和管理元素序列,这篇文章主要介绍了Java中Queue以及Deque用法的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-08-08
  • Java中的封装、继承和多态,你真的都懂了吗

    Java中的封装、继承和多态,你真的都懂了吗

    Java中的封装、继承和多态知识点是学习java必备的基础知识,看似简单,真正理解起来还是有一定难度的,今天小编再次通过实例代码给大家讲解java 封装继承多态知识,感兴趣的朋友一起学习下吧
    2021-05-05
  • Java实现多线程断点下载

    Java实现多线程断点下载

    这篇文章主要为大家详细介绍了Java实现多线程断点下载的相关资料,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-03-03
  • 解决SpringBoot中LocalDateTime返回前端数据为数组结构的问题

    解决SpringBoot中LocalDateTime返回前端数据为数组结构的问题

    本文主要介绍了解决SpringBoot中LocalDateTime返回前端数据为数组结构的问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-03-03

最新评论