【干货】如何用Spring Boot 实现发送邮件功能

最新推荐文章于 2023-10-30 16:41:10 发布

小旋哥^^

最新推荐文章于 2023-10-30 16:41:10 发布

阅读量328

点赞数

分类专栏：面试经验

本文链接：https://blog.csdn.net/weixin_42164488/article/details/110846098

版权

面试经验专栏收录该内容

9 篇文章 0 订阅

订阅专栏

先普及点基础吧~

什么是SMTP？

SMTP全称为Simple Mail Transfer Protocol（简单邮件传输协议），它是⼀组⽤于从源地址到⽬的地址传输邮件的规范，通过它来控制邮件的中转⽅式。

SMTP认证要求必须提供账号和密码才能登陆服务器，其设计⽬的在于避免⽤⼾受到垃圾邮件的侵扰。

什么是IMAP？

IMAP全称为Internet Message Access Protocol（互联⽹邮件访问协议），IMAP允许从邮件服务器上获取邮件的信息、下载邮件等。IMAP与POP类似，都是⼀种邮件获取协议。

什么是POP3？

POP3全称为Post Office Protocol 3（邮局协议），POP3⽀持客⼾端远程管理服务器端的邮件。POP3常⽤于“离线”邮件处理，即允许客⼾端下载服务器邮件，然后服务器上的邮件将会被删除。⽬前很多POP3的邮件服务器只提供下载邮件功能，服务器本⾝并不删除邮件，这种属于改进版的POP3协议。

IMAP和POP3协议有什么不同呢？

两者最⼤的区别在于，IMAP允许双向通信，即在客⼾端的操作会反馈到服务器上，例如在客⼾端收取邮件、标记已读等操作，服务器会跟着同步这些操作。⽽对于POP协议虽然也允许客⼾端下载服务器邮件，但是在客⼾端的操作并不会同步到服务器上⾯的，例如在客⼾端收取或标记已读邮件，服务器不会同步这些操作。

什么是JavaMailSender和JavaMailSenderImpl？

JavaMailSender和JavaMailSenderImpl 是Spring官⽅提供的集成邮件服务的接⼝和实现类，以简单⾼效的设计著称，⽬前是 Java后端发送邮件和集成邮件服务的主流⼯具。

如何通过JavaMailSenderImpl发送邮件？

⾮常简单，直接在业务类注⼊JavaMailSenderImpl并调⽤send⽅法发送邮件。其中简单邮件可以通过SimpleMailMessage来发送邮件，⽽复杂的邮件（例如添加附件）可以借助MimeMessageHelper来构建MimeMessage发送邮件。

为什么JavaMailSenderImpl 能够开箱即⽤？

所谓开箱即⽤其实就是基于官⽅内置的⾃动配置，翻看源码可知晓邮件⾃动配置类(MailSenderPropertiesConfiguration) 为上下⽂提供了邮件服务实例(JavaMailSenderImpl)。

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Spring Boot中发送邮件步骤

Spring Boot中发送邮件具体的使用步骤如下

1、添加Starter模块依赖
2、添加Spring Boot配置(mail)
3、调用JavaMailSender接口发送邮件

创建springboot项目，添加依赖
项目结构

1、添加依赖
在 Maven pom.xml 配置文件中加入 spring-boot-starter-mail 依赖。

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

2、添加配置参数
然后在 application.yml 文件中加入以下配置。

application.yml 配置
网易系(126/163/yeah)邮箱配置

## 163邮箱配置
spring:
  mail:
    host: smtp.163.com #发送邮件服务器
    username: xuan@163.com #发送邮件的邮箱地址
    password:  12312*****kbdcf #客户端授权码，不是邮箱密码，这个在qq邮箱设置里面自动生成的
    properties.mail.smtp.port: 465 #端口号465或587
    from: xuan@163.com.com # 发送邮件的地址，和上面username一致
  可以任意
    properties.mail.smtp.starttls.enable: true
    properties.mail.smtp.starttls.required: true
    properties.mail.smtp.ssl.enable: true
    default-encoding: utf-8

网易系(126/163/yeah)邮箱配置

##网易系(126/163/yeah)邮箱配置
spring:
  mail:
    host: smtp.126.com #发送邮件服务器
    username: xx@126.com #发送邮件的邮箱地址
    password: xxxxxxx #客户端授权码，不是邮箱密码,网易的是自己设置的
    properties.mail.smtp.port: 994 #465或者994
    from: xxx@126.com # 发送邮件的地址，和上面username一致
   可以任意
    properties.mail.smtp.starttls.enable: true
    properties.mail.smtp.starttls.required: true
    properties.mail.smtp.ssl.enable: true
    default-encoding: utf-8

注意：

126邮箱SMTP服务器地址:smtp.126.com,端口号:465或者994
163邮箱SMTP服务器地址:smtp.163.com,端口号:465或者994
yeah邮箱SMTP服务器地址:smtp.yeah.net,端口号:465或者994

封装邮件接口，方便调用发送邮件
IMailService 接口

package com.jiangfeixiang.sendemail;

/**
 * @Author: 小旋哥
 * @Description: 封装一个发邮件的接口，后边直接调用即可
 * @Date: Create in 2020/1/28/
 * @param: $params$
 * @return: $returns$
 */
public interface IMailService {

    /**
     * 发送文本邮件
     * @param to 收件人
     * @param subject 主题
     * @param content 内容
     */
    void sendSimpleMail(String to, String subject, String content);

    /**
     * 发送HTML邮件
     * @param to 收件人
     * @param subject 主题
     * @param content 内容
     */
    public void sendHtmlMail(String to, String subject, String content);



    /**
     * 发送带附件的邮件
     * @param to 收件人
     * @param subject 主题
     * @param content 内容
     * @param filePath 附件
     */
    public void sendAttachmentsMail(String to, String subject, String content, String filePath);
}

IMailServiceImpl 实现类

package com.jiangfeixiang.sendemail;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.FileSystemResource;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;

import javax.mail.MessagingException;
import javax.mail.internet.MimeMessage;
import java.io.File;

/**
 * @Author: 小旋哥
 * @Description:
 * @Date: Create in 2020/1/28
 * @param: $params$
 * @return: $returns$
 */
@Service
public class IMailServiceImpl implements IMailService {
    private final Logger logger = LoggerFactory.getLogger(this.getClass());

    /**
     * Spring Boot 提供了一个发送邮件的简单抽象，使用的是下面这个接口，这里直接注入即可使用
     */
    @Autowired
    private JavaMailSender mailSender;

    /**
     * 配置文件中邮箱
     */
    @Value("${spring.mail.from}")
    private String from;

    /**
     * 简单文本邮件
     * @param to 收件人
     * @param subject 主题
     * @param content 内容
     */
    @Override
    public void sendSimpleMail(String to, String subject, String content) {
        //创建SimpleMailMessage对象
        SimpleMailMessage message = new SimpleMailMessage();
        //邮件发送人
        message.setFrom(from);
        //邮件接收人
        message.setTo(to);
        //邮件主题
        message.setSubject(subject);
        //邮件内容
        message.setText(content);
        //发送邮件
        mailSender.send(message);
    }

    /**
     * html邮件
     * @param to 收件人
     * @param subject 主题
     * @param content 内容
     */
    @Override
    public void sendHtmlMail(String to, String subject, String content) {
        //获取MimeMessage对象
        MimeMessage message = mailSender.createMimeMessage();
        MimeMessageHelper messageHelper;
        try {
            messageHelper = new MimeMessageHelper(message, true);
            //邮件发送人
            messageHelper.setFrom(from);
            //邮件接收人
            messageHelper.setTo(subject);
            //邮件主题
            message.setSubject(subject);
            //邮件内容，html格式
            messageHelper.setText(content, true);
            //发送
            mailSender.send(message);
            //日志信息
            logger.info("邮件已经发送。");
        } catch (MessagingException e) {
            logger.error("发送邮件时发生异常！", e);
        }
    }

    /**
     * 带附件的邮件
     * @param to 收件人
     * @param subject 主题
     * @param content 内容
     * @param filePath 附件
     */
    @Override
    public void sendAttachmentsMail(String to, String subject, String content, String filePath) {
        MimeMessage message = mailSender.createMimeMessage();
        try {
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(from);
            helper.setTo(to);
            helper.setSubject(subject);
            helper.setText(content, true);

            FileSystemResource file = new FileSystemResource(new File(filePath));
            String fileName = filePath.substring(filePath.lastIndexOf(File.separator));
            helper.addAttachment(fileName, file);
            mailSender.send(message);
            //日志信息
            logger.info("邮件已经发送。");
        } catch (MessagingException e) {
            logger.error("发送邮件时发生异常！", e);
        }


    }
}

测试

package com.jiangfeixiang.sendemail;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

@RunWith(SpringRunner.class)
@SpringBootTest
public class SendemailApplicationTests {

    /**
     * 注入发送邮件的接口
     */
    @Autowired
    private IMailService mailService;

    /**
     * 测试发送文本邮件
     */
    @Test
    public void sendmail() {
        mailService.sendSimpleMail("xuan@163.com","主题：你好普通邮件","内容：第一封邮件");
    }

    @Test
    public void sendmailHtml(){
        mailService.sendHtmlMail("xuan@163.com","主题：你好html邮件","<h1>内容：第一封html邮件</h1>");
    }
}

小旋哥^^

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
打赏
0
评论
【干货】如何用Spring Boot 实现发送邮件功能

先普及点基础吧~什么是SMTP？ SMTP全称为Simple Mail Transfer Protocol（简单邮件传输协议），它是⼀组⽤于从源地址到⽬的地址传输邮件的规范，通过它来控制邮件的中转⽅式。 SMTP认证要求必须提供账号和密码才能登陆服务器，其设计⽬的在于避免⽤⼾受到垃圾邮件的侵扰。什么是IMAP？ IMAP全称为Internet Message Access Protocol（互联⽹邮件访问协议），IMAP允许从邮件服务器上获取邮件的信息、下载邮件等。IM...
复制链接

扫一扫