使用 Spring Boot 开发邮件系统

/ 默认分类 / 没有评论 / 1371浏览

电子邮件是因特网上使用得非常多的一种应用,它可以非常方便的使相隔很远的人进行通信,它主要的特点就是操作简单,快捷。现在的电子邮件系统以是存储与转发的模型为基础。邮件服务器接受、转发、提交及存储邮件。寄信人、收信人及他们的计算机都不用同时在线。寄信人和收信人只需在寄信或收信时简短的连线到邮件服务器即可。

互联网发展到现在,邮件服务已经成为互联网企业中必备功能之一,应用场景非常广泛,比较常见的有:用户注册、忘记密码、监控提醒、企业营销等。大多数互联网企业都会将邮件发送抽取为一个独立的微服务,对外提供接口来支持各种类型的邮件发送。

本篇内容会从以下几部分来给大家介绍如何开发一个邮件系统:

enter image description here

邮件历史

我们先来回顾一下整个邮件的发展历史。

电子邮件的发展

电子邮件发明在 70 年代,却在 80 年才开始有人使用。70 年代的沉寂主要是由于当时使用 Arpanet 网络的人太少,网络的速度也仅为目前 56Kbps 标准速度的二十分之一,受网络速度的限制,那时的用户只能发送些简短的信息,根本别想象现在那样发送大量照片。

到 80 年代中期,个人电脑兴起,电子邮件开始在电脑迷以及大学生中广泛传播开来;到 90 年代中期,互联网浏览器诞生,全球网民人数激增,电子邮件被广为使用。2000 零几年的时候,那时候没有网盘,上大学的时候常常使用邮箱存储东西,那时候的邮箱也主要以网易为主;到了现在,几乎每个人都有好几个邮箱,QQ 邮箱、126 邮箱、公司邮箱等等,电子邮件已经成为人们生活和工作不可或缺的一部分。

电子邮件发展历程:

世界的第一封电子邮件

1969 年 10 月世界上的第一封电子邮件是由计算机科学家 Leonard K. 教授发给他的同事的一条简短消息。

据《互联网周刊》报道世界上的第一封电子邮件是由计算机科学家Leonard K.教授发给他的同事的一条简短消息(时间应该是1969年10月),这条消息只有两个字母:"LO"。Leonard K. 教授因此被称为电子邮件之父。所以第一条网上信息就是‘LO’,意思是‘你好!’”

当然这个说法也有一点争议,另外一种说法是麻省理工学院博士 Ray Tomlinson 发送的第一封邮件,这里不再展开讨论。

中国的第一封电子邮件

1987 年 9 月 14 日中国第一封电子邮件是由“德国互联网之父”维纳·措恩与王运丰在当时的兵器工业部下属单位—计算机应用技术研究所(简称 ICA)发往德国卡尔斯鲁厄大学的,其内容为德文和英文双语,第一段大意如下:

原文:“ Across the Great Wall we can reach every corner in the world. ”

中文大意:“ 越过长城,我们可以到达世界的每一个角落。 ”

这是中国通过北京与德国卡尔斯鲁厄大学之间的网络连接,发出的第一封电子邮件。现在看这封邮件内容,颇具深意!

邮件协议

发送邮件的本质是将一个人的信息传输给另外一个人,那么如何传输就需要商量好标准,这些标准就是协议。最初只有两个协议:

SMTP 协议

SMTP 的全称是 “Simple Mail Transfer Protocol”,即简单邮件传输协议。它是一组用于从源地址到目的地址传输邮件的规范,通过它来控制邮件的中转方式。它的一个重要特点是它能够在传送中接力传送邮件,即邮件可以通过不同网络上的主机接力式传送。

SMTP 认证,简单地说就是要求必须在提供了账户名和密码之后才可以登录 SMTP 服务器,这就使得那些垃圾邮件的散播者无可乘之机。增加 SMTP 认证的目的是为了使用户避免受到垃圾邮件的侵扰。SMTP主要负责底层的邮件系统如何将邮件从一台机器传至另外一台机器。

POP3 协议

POP3 是 Post Office Protocol 3 的简称,即邮局协议的第3个版本,它规定怎样将个人计算机连接到 Internet 的邮件服务器和下载电子邮件的电子协议。它是因特网电子邮件的第一个离线协议标准,POP3 允许用户从服务器上把邮件存储到本地主机(即自己的计算机)上,同时删除保存在邮件服务器上的邮件。

POP 协议支持“离线”邮件处理。其具体过程是:邮件发送到服务器上,电子邮件客户端调用邮件客户机程序以连接服务器,并下载所有未阅读的电子邮件。这种离线访问模式是一种存储转发服务,将邮件从邮件服务器端送到个人终端机器上,一般是 PC机或 MAC。一旦邮件发送到 PC 机或 MAC上,邮件服务器上的邮件将会被删除。但目前的POP3邮件服务器大都可以“只下载邮件,服务器端并不删除”,也就是改进的POP3协议。

** SMTP 和 POP3 是最初的俩个协议,随着邮件的不断发展后来又增加了两个协议:**

IMAP 协议

全称 Internet Mail Access Protocol(交互式邮件存取协议),IMAP 是斯坦福大学在1986年开发的研发的一种邮件获取协议,即交互式邮件存取协议,它是跟 POP3 类似邮件访问标准协议之一。不同的是,开启了 IMAP 后,在电子邮件客户端收取的邮件仍然保留在服务器上,同时在客户端上的操作都会反馈到服务器上,如:删除邮件,标记已读等,服务器上的邮件也会做相应的动作。所以无论从浏览器登录邮箱或者客户端软件登录邮箱,看到的邮件以及状态都是一致的。

IMAP 的一个与 POP3 的区别是:IMAP 它只下载邮件的主题,并不是把所有的邮件内容都下载下来,而是你邮箱当中还保留着邮件的副本,没有把你原邮箱中的邮件删除,你用邮件客户软件阅读邮件时才下载邮件的内容。较好支持这两种协议的邮件客户端有:Foxmail、Outlook 等。

Mime 协议

由于 SMTP 这个协议开始是基于纯 ASCⅡ文本的,在二进制文件上处理得并不好。后来开发了用来编码二进制文件的标准,如 MIME,以使其通过 SMTP 来传输。今天,大多数 SMTP 服务器都支持 8 位 MIME 扩展,它使二进制文件的传输变得几乎和纯文本一样简单。

用一张图来看发送邮件过程中的协议使用:

enter image description here

实线代表 neo@126.com 发送邮件给 itclub@aa.com;虚线代表 itclub@aa.com 发送邮件给 neo@126.com

邮件发送流程

img

这就是邮件发送的一个完整流程。

简单使用

最早期的时候使用 JavaMail 相关 API 来开发,需要自己去封装消息体,代码量比较庞大;后来 Spring 推出了 JavaMailSender 简化了邮件发送过程,JavaMailSender 提供了强大的邮件发送功能,可支持各种类型的邮件发送。

现在 Spring Boot 在 JavaMailSender 的基础上又进行了封装,就有了现在的 spring-boot-starter-mail,让邮件发送流程更加简洁和完善。下面给大家介绍如何使用 Spring Boot 发送邮件。

1、pom 包配置

引入加 spring-boot-starter-mail 依赖包:

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

2、配置文件

application.properties 中添加邮箱配置,不同的邮箱参数稍有不同,下面列举几个常用邮箱配置:

163邮箱配置:

spring.mail.host=smtp.163.com //邮箱服务器地址
spring.mail.username=xxx@oo.com //用户名
spring.mail.password=xxyyooo    //密码
spring.mail.default-encoding=UTF-8

//超时时间,可选
spring.mail.properties.mail.smtp.connectiontimeout=5000  
spring.mail.properties.mail.smtp.timeout=3000
spring.mail.properties.mail.smtp.writetimeout=5000

126 邮箱配置

spring.mail.host=smtp.126.com
spring.mail.username=yourEmail@126.com
spring.mail.password=yourPassword
spring.mail.default-encoding=UTF-8

qq 邮箱配置如下:

spring.mail.host=smtp.qq.com
spring.mail.username=ityouknow@qq.com
spring.mail.password=yourPassword
spring.mail.default-encoding=UTF-8

注意:测试时需要将 spring.mail.usernamespring.mail.password 改成自己邮箱对应的登录名和密码,这里的密码不是邮箱的登录密码,是开启 POP3 之后设置的客户端授权密码。

这里以 126 为邮件举例,有两个地方需要邮箱中设置:

开启 POP3/SMTP 服务、IMAP/SMTP 服务

enter image description here

图片下方会有 smtp 等相关信息的配置提示。

开通设置客户端授权密码

enter image description here

设置客户端授权密码一般需求手机验证码验证。

3、文本邮件发送

Spring 已经帮我们内置了 JavaMailSender,直接在项目中引用即可。我们封装一个 MailService 类来实现普通的邮件发送方法。

@Component
public class MailServiceImpl implements MailService{

    private final Logger logger = LoggerFactory.getLogger(this.getClass());

    @Autowired
    private JavaMailSender mailSender;

    @Value("${spring.mail.username}")
    private String from;

    @Override
    public void sendSimpleMail(String to, String subject, String content) {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(from);
        message.setTo(to);
        message.setSubject(subject);
        message.setText(content);

        try {
            mailSender.send(message);
            logger.info("简单邮件已经发送。");
        } catch (Exception e) {
            logger.error("发送简单邮件时发生异常!", e);
        }

    }
}

文本邮件抄送使用:message.copyTo(copyTo) 来实现。

邮件发送者 from 一般采用固定的形式写到配置文件中。

4、编写 test 类进行测试

@RunWith(SpringRunner.class)
@Spring BootTest
public class MailServiceTest {

    @Autowired
    private MailService MailService;

    @Test
    public void testSimpleMail() throws Exception {
        mailService.sendSimpleMail("ityouknow@126.com","这是一封简单邮件","大家好,这是我的第一封邮件!");
    }
}

稍微等待几秒,就可以在邮箱中找到此邮件内容了。至此一个简单的文本邮件发送就完成了。

img

富文本邮件

在日常使用的过程中,我们通常在邮件中加入图片或者附件来丰富邮件的内容,下面讲介绍如何使用 Spring Boot 来发送富文本邮件。

发送 HTML 格式邮件

邮件发送支持以 HTML 语法去构建自定义的邮件格式,Spring Boot 支持使用 HTML 发送邮件。

我们在 MailService 中添加支持 HTML 邮件发送的方法.

public void sendHtmlMail(String to, String subject, String content) {
    MimeMessage message = mailSender.createMimeMessage();

    try {
        //true 表示需要创建一个 multipart message
        MimeMessageHelper helper = new MimeMessageHelper(message, true);
        helper.setFrom(from);
        helper.setTo(to);
        helper.setSubject(subject);
        helper.setText(content, true);

        mailSender.send(message);
        logger.info("html邮件发送成功");
    } catch (MessagingException e) {
        logger.error("发送html邮件时发生异常!", e);
    }
}

富文本邮件抄送使用:helper.addCc(cc) 来实现。

和文本邮件发送代码对比,富文本邮件发送使用 MimeMessageHelper 类。MimeMessageHelper 支持发送复杂邮件模板,支持文本、附件、HTML、图片等,接下来会一一使用到。

在测试类中构建 HTML 内容,测试发送

@Test
public void testHtmlMail() throws Exception {
    String content="<html>\n" +
            "<body>\n" +
            "    <h3>hello world ! 这是一封html邮件!</h3>\n" +
            "</body>\n" +
            "</html>";
    mailService.sendHtmlMail("ityouknow@126.com","这是一封HTML邮件",content);
}

邮件内容大写了一段话,下面为接收到的效果:

enter image description here

由此我们发现发送 HTML 邮件,就是需要拼接一段 HTML 的 String 字符串交给 MimeMessageHelper 来处理,最后由邮件客户端负责渲染显示内容。

发送带附件的邮件

在 MailService 添加 sendAttachmentsMail 方法,发送带附件的邮件主要是使用 FileSystemResource 对文件进行封装,在添加到 MimeMessageHelper 中。

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 = file.getFilename();
        helper.addAttachment(fileName, file);
        //helper.addAttachment("test"+fileName, file);

        mailSender.send(message);
        logger.info("带附件的邮件已经发送。");
    } catch (MessagingException e) {
        logger.error("发送带附件的邮件时发生异常!", e);
    }
}

添加多个附件可以使用多条 helper.addAttachment(fileName, file)

在测试类中添加测试方法

@Test
public void sendAttachmentsMail() {
    String filePath="e:\\temp\\fastdfs-client-java-5.0.0.jar";
    mailService.sendAttachmentsMail("ityouknow@126.com", "主题:带附件的邮件", "有附件,请查收!", filePath);
}

附件可以是图片、压缩包、Word 等任何文件,但是邮件厂商一般都会对附件大小有限制,太大的附件建议使用网盘上传后,在邮件中给出链接。

效果图如下:

enter image description here

发送带静态资源的邮件

邮件中的静态资源一般指图片,在 MailService 添加 sendInlineResourceMail 方法。

public void sendInlineResourceMail(String to, String subject, String content, String rscPath, String rscId){
    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 res = new FileSystemResource(new File(rscPath));
        helper.addInline(rscId, res);

        mailSender.send(message);
        logger.info("嵌入静态资源的邮件已经发送。");
    } catch (MessagingException e) {
        logger.error("发送嵌入静态资源的邮件时发生异常!", e);
    }
}

在测试类中添加测试方法

@Test
public void sendInlineResourceMail() {
    String rscId = "neo006";
    String content="<html><body>这是有图片的邮件:<img src=\'cid:" + rscId + "\' ></body></html>";
    String imgPath = "e:\\temp\\weixin.jpg";

    mailService.sendInlineResourceMail("ityouknow@126.com", "主题:这是有图片的邮件", content, imgPath, rscId);
}

添加多个图片可以使用多条 <img src='cid:" + rscId + "' >helper.addInline(rscId, res) 来实现

效果图如下:

截屏2022-04-01 下午9.44.01

以上是邮件发送的基础服务,已演示支持各种类型邮件。

邮件系统

如果只是想在系统中做一个邮件工具类的话,以上的内容基本就可以满足要求了。要做成一个邮件系统的话还需要考虑以下几方面:

对外提供接口

作为一个独立的邮件系统,需要对外提供接口调用,我们以简单文本邮件为例做个演示:

首先需要定义个实例返回对象:

public class MailResult {
    private String rspCode;
    private String rspMsg;

    public MailResult() {
        this.rspCode = "00";
        this.rspMsg = "发送成功";
    }
    //省略 setter/getter
}

默认成功的返回码为:00,返回消息为:发送成功。

创建一个 MailController 类对外提供 HTTP 请求接口。

@RestController
public class MailController {
    private final Logger logger = LoggerFactory.getLogger(this.getClass());
    @Resource
    private MailService mailService;

    @RequestMapping("/sendSimpleMail")
    public MailResult sendSimpleMail(String to, String subject, String content) {
        MailResult result=new MailResult();
        if(StringUtils.isEmpty(to) || !to.contains("@")){
            result.setRspCode("01");
            result.setRspCode("手机人邮件格式不正确");
        }
        if(StringUtils.isEmpty(content) ){
            result.setRspCode("03");
            result.setRspCode("邮件正文不能为空");
        }
       try {
            mailService.sendSimpleMail(to,subject,content);
            logger.info("简单邮件已经发送。");
        } catch (Exception e) {
            result.setRspCode("04");
            result.setRspCode("邮件发送出现异常");
            logger.error("sendSimpleMail Exception ", e);
        }
        return result;
    }
}

外部请求过来时首先进行参数校验,如果参数有误返回请求;发送邮件出现异常时返回错误,正常情况下返回 00;注意在 Service 层如果对异常信息进行了捕获的话,需要将异常信息抛到上层。

try {
    mailSender.send(message);
    logger.info("简单邮件已经发送。");
} catch (Exception e) {
    logger.error("发送简单邮件时发生异常!", e);
    throw e;
}

类似上述代码。

按照这个思路也可以提供发送带图片、带附件的邮件,同时也可以封装发送多人邮件,群发邮件等复杂情况。

邮件模板

通常我们使用邮件发送服务的时候,都会有一些固定的场景,比如重置密码、注册确认等,给每个用户发送的内容可能只有小部分是变化的。所以,很多时候我们会使用模板引擎来为各类邮件设置成模板,这样我们只需要在发送时去替换变化部分的参数即可。

我们会经常收到这样的邮件:

尊敬的 neo 用户:

              恭喜您注册成为xxx网的用户,同时感谢您对xxx的关注与支持并欢迎您使用xx的产品与服务。
              ...

邮件正文只有 neo 这个用户名在变化,邮件其它内容均不变,如果每次发送邮件都需拼接 HTML 代码,程序不够优雅,并且每次邮件正文有变化都需修改代码非常不方便。因此对于这类邮件,都建议做成邮件模板来处理,模板的本质很简单,就是在模板中替换变化的参数,转换为 HTML 字符串即可,这里以 Thymeleaf 为例来演示。

Thymeleaf 是 Spring 官方推荐的前端模板引擎,类似 Velocity、FreeMarker 等模板引擎,相较与其他的模板引擎,Thymeleaf 开箱即用的特性。它提供标准和 Spring 标准两种方言,可以直接套用模板实现 JSTL、 OGNL 表达式效果,避免每天套模板、该 Jstl、改标签的困扰。Thymeleaf 在有网络和无网络的环境下皆可运行,即它可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页面效果。

下面我们来演示使用 Thymeleaf 制作邮件模板。

1、添加依赖包

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

2、在 resorces/templates 下创建 emailTemplate.html

emailTemplate.html 文件内容即为邮件的正文内容模板。

<!DOCTYPE html>
<html lang="zh" xmlns:th="http://www.thymeleaf.org">
    <head>
        <meta charset="UTF-8"/>
        <title>邮件模板</title>
    </head>
    <body>
        您好,感谢您的注册,这是一封验证邮件,请点击下面的链接完成注册,感谢您的支持<br/>
        <a href="#" th:href="@{http://www.ityouknow.com/register/{id}(id=${id}) }">激活账号</a>
    </body>
</html>

我们发现上述的模板中只有 id 是一个动态的值,发送过程中会根据传入的 id 值来替换链接中的 {id}

3、解析模板并发送

@Test
public void sendTemplateMail() {
    //创建邮件正文
    Context context = new Context();
    //设置模板需要替换的参数
    context.setVariable("id", "006");
    //使用 templateEngine 替换掉动态参数生产出最后的 HTML 内容。
    String emailContent = templateEngine.process("emailTemplate", context);
    //最后调用 sendHtmlMail 发送邮件
    mailService.sendHtmlMail("ityouknow@126.com","主题:这是模板邮件",emailContent);
}

我们发现最后调用的还是 sendHtmlMail 的方法,邮件模板的作用只是处理 HTML 生成部分,通过 Thymeleaf 模板引擎解析固定的模板,再更具参数来动态替换其中的变量,最后通过前面的 HTML 发送的方法发送邮件。

效果图如下:

img

点击“激活账号”跳转的链接为:http://www.ityouknow.com/register/006

发送失败

因为各种原因,总会有邮件发送失败的情况,比如:邮件发送过于频繁、网络异常等。在出现这种情况的时候,我们一般会考虑重新重试发送邮件,会分为以下几个步骤来实现:

  1. 接收到发送邮件请求,首先记录请求并且入库。
  2. 调用邮件发送接口发送邮件,并且将发送结果记录入库。
  3. 启动定时系统扫描时间段内,未发送成功并且重试次数小于3次的邮件,进行再次发送.
  4. 重新发送邮件的时间,建议以 2 的次方间隔时间,比如:2、4、8、16 ...

常见的错误返回码:

如果使用一个邮箱频繁发送相同内容邮件,也会被认定为垃圾邮件,报 554 DT:SPM 错误

如果使用网易邮箱可以查看这里的提示:企业退信的常见问题?

其它

异步发送

很多时候邮件发送并不是主业务必须关注的结果,比如通知类、提醒类的业务可以允许延时或者失败。这个时候可以采用异步的方式来发送邮件,加快主交易执行速度。在实际项目中可以采用消息中间件 MQ 发送邮件,具体做法是创建一个邮件发送的消息队列,在业务中有需要用到邮件发送功能时,给对应消息队列按照规定参数发送一条消息,邮件系统监听此队列,当有消息过来时,处理邮件发送的逻辑。

管理后台

考虑做一个完善的邮件系统,可以设计一个独立的邮件管理后台,不但可以让系统之间调用时使用,也可以提供图形化界面让公司的运营、市场部的同事来发送邮件,查询邮件的发送进度,统计邮件发送成功率。也可以设置一些代码钩子,统计用户点击固定链接次数,方便公司营销人员监控邮件营销转化率。

一个非常完善的邮件系统需要考虑的因素非常多,比如是否设置白名单、黑名单来做邮件接收人的过滤机制,是否给用户提供邮件退订的接口等。因此在初期邮件发送的基本功能完成之后,再结合公司业务,快速迭代的逐步完善邮件系统,是一个推荐的做法。

总结

使用 Spring Boot 集成发送邮件的功能非常简单,只需要简单编码就可以实现发送普通文本邮件、带附件邮件、HTML 格式邮件、带图片邮件等。如果需要做成一个邮件系统还需要考虑很多因素,比如:邮箱发送失败重试机制、防止邮件被识别为垃圾邮件,固定时间内发送邮件的限制等。在微服务架构中,常常将一些基础功能下沉下来,作为独立的服务来使用,邮件系统作为平台的基础功能,特别适合做为独立的微服务来支持整个系统。

点击这里下载源码

参考: